"Да какой ты на[фиг] оптимизатор? хать, тфу."

Проблема

Пришёл в новый проект где было подключено три математические библиотеки. Кодовая база впитала опыт нескольких команд разработчиков и представляла типичный legacy где обосновать то или иное решение не всегда представляется возможным. Дойдя в бэклоге до оптимизации я стал перебирать варианты того, как это можно решить. В результате своих размышлений я пришёл к выводу, что хочу сохранить все имеющиеся библиотеки, но убрать с глаз разницу в API. Желаю конфигурировать на лету "математический движок" в одной точке (не залезая в, непосредственно, сам клиентский код).

Решение

Синтаксис математических выражений основанный на массивах (назвал nemathode и создал под него отдельную страничку со всей информацией которая поможет втянуться в этот механизм). Я хотел, чтобы он был максимально близок к большинству популярных языков, но в первую очередь к JavaScript.

То есть, сильно ничего не меняется:

  • круглые скобки меняются на квадратные;

  • операторы (константы, имена функций) обрамляются в кавычки;

  • а конфигурация происходит в одной точке (до которой мы скоро дойдём).

Схематично о смысле синтаксиса

Применив эту штуку я теперь могу:

  1. продолжать использовать кучу математических библиотек и конфигурировать их в одной точке скрывая детали API

  2. добавлять новые методы, операторы, константы и выбирать удобное именование;

  3. калибровать точность и скорость вычислений на лету (корректировать текущие имплементации, заменять математические константы с более подходящими значениями).

Примеры использования

Бинарные операторы

Функции

Математические константы

Вложенные выражения

Пример конфигурации

Больше примеров настройки библиотеки можно найти здесь

mathConstants

Буквально, математические константы

functions

Набор имплементаций

toInputType

Это кажется избыточным, но не все используют функциональность чистого JS. Существует ряд библиотек где промежуточным типом в вычислениях не является число (bignumber.js, decimal.js). Таким образом мы можем настроить этот обработчик как на примере ниже

toOutputType

Противоположен toInputType. Смотрите пример ниже

binaryOperators

API - стандартное

API - с любовью ❤️

Послесловие

Вдохновлялся

  1. Вопросом на stackoverflow

  2. Несколькими задачами на codewars (не помню названия)

  3. math.js библиотекой и её механизмом вычислений

В будущем (если решение пригодится не только мне)

  1. Полное TS покрытие (чтобы был автокомплит по операторам при написании выражений)

  2. Унарные операторы (до сих пор сомневаюсь по поводу их необходимости. Нужна Ваше мнение)

  3. Обработка аргументов функции

  4. Преодолеть ограничения связанные с возвращаемыми типами значений (number, boolean etc)

И напоследок

Если у Вас есть вопросы, предложения, пожелания, критика - я буду рад услышать обратную связь в любой форме. Ссылка на вебсайт со всей необходимой информацией.