rational

Истоки проекта#

Проект уходит корнями к дальнему прошлому, датируемому ещё до моего увлечения веб-разработкой. На тот момент я только изучал основы python (дальше знакомства с основами дело, увы, не зашло). Ознакомившись с различными типами данных и изучая ООП, пришла идея реализовать поддержку рациональных чисел c более обширным интерфейсом, нежели предоставленный в то время и в том виде модуль Fraction. Вполне возможно, что в контексте самого языка с учётом имеющегося уже модуля, я переизобретал велосипед. Вполне возможно так оно и было. Тем не менее, задача была мне под силам и непосредственно интересна.

Проект получился и я был доволен результатом; благодаря нему смог лучше проникнуться принципами ООП, узнать достаточно много нового. Разумеется, проект нигде не был опубликован и был благополучно забыт где-то в архивах файловой системы ноутбука.

Мотивация#

Спустя время, как это можно заметить за многими моими проектами, решил вернуться вновь и попытаться реализовать проект снова. Только в тот момент я уже был веб-разработчикам и основным моим языком был (какая неожиданность!) — JavaScript. В отличие от того времени я уже имел некоторый опыт, уверенно владел языком и лучше понимал процесс работы над проектами и процессы, связанные с ними.

JavaScript сложно сравнивать с python, подходы к ООП разительно отличаются друга от друга (да, в JavaScript нет ООП как такого). В JavaScript отсутствует возможность работы с рациональными числами и наличие такой возможности могло бы действительно принести пользу моим потенциальным проектам, а возможно и даже сообществу. Было решено написать полноценную библиотеку и опубликовать её на npm.

Процесс#

Работа над библиотекой оказалась довольно приятной и продуктивной. Перед тем как написать первую строчку кода, изучил уже существующие решения для лучшего понимания функционала для достаточной конкуренции и в целом, понимания пользовательских требований к аналогичным решениям. Создание проекта оказалось разумным шагом, так как существующие альтернативы были написаны относительно давно, без использования современных возможностей JavaScript и все же не было того проекта, который бы собрал всё лучшее воедино.

К тому моменту уже имелся опыт публикаций пакетов, понимание необходимых для того процессов, настройки окружения и умения писать модульные тесты. Проект был реализован с использованием TypeScript. По итогу, в сжатом виде библиотека умещалась в 2кб, что мне показалось весьма неплохим показателем, учитывая реализованный функционал.

Пользовательский ввод#

Все библиотеки с поддержкой рациональных чисел имеют более или менее схожий интерфейс: предоставляется возможность создавать экземпляры объекта и проводить с ними операции. Почитать более подробно о функциональности rational можно в документации. Здесь же хотелось бы выделить достаточно гибкий пользовательский ввод:

• (n?: int = 0, d?: int = 1) — целочисленные значения числителя и знаменателя двумя параметрами;
• (input: [ n: int = 0, d?: int = 1 ]) — целочисленные значения числителя и знаменателя массивом;
• (input: { int?: number = 0, n: int, d?: int = 1 }) — целочисленные значения целой части, числителя и знаменателя объектом;
• (input: StringFraction) — строки в формате дробного выражения в формате "{sign?}{numerator}/{sign?};
• (input: RepeatingDecimal) — периодической дроби в виде объекта;
• (input: StringRepeatingDecimal) — строки в виде периодической дроби в формате {sign?}{int?}.{non-repeating}?({repeating});
• (input: Degrees) — градусной меры в виде объекта;
• (input: StringDegrees) — градусной меры в виде строки в формате {sign?}{degrees?}.{minutes'?}{seconds''?}.

И ещё большее удобство достигается не только за счёт гибкости ввода, но и поддержки аналогичных опций при работе с экземплярами объектов. Например, при суммировании не обязательно предоставлять другой экземпляр, достаточно передать валидный пользовательский ввод.

Резюмируя#

Библиотека сама по себе не является чем-то выдающимся, написать такое вполне может любой разработчик с парой лет опыта. Тем не менее, я оказался доволен результатом, что случается крайне редко из-за завышенных требований к самому себе. Библиотека типизированна, предоставляет необходимые типы, покрыта тестами, имеет достаточно неплохую документацию и покрывающий все потребности функционал. В случае необходимости rational поддерживает расширяемость и в целом, использовался современный JavaScript.

У библиотеки присутствуют некоторые очевидные ограничения связанные с числовым типом Number, а именно с максимальным целочисленным значением. Была идея использовать BigInt, но меня посещали сомнения касательно необходимости в таких больших значениях при использовании библиотеки. Особенно учитывая падение производительности (до 10 раз).

Планирую в будущем написать несколько учебных проектов с её использованием. Проект поддерживается, и всегда находится в актуальном состоянии.