Практичная функциональная библиотека для JavaScript программистов.
Уже есть несколько отличных библиотек с функциональным оттенком. Как правило, они предназначены для того, чтобы быть инструментами общего назначения, подходят для работы в нескольких парадигмах. У Ramda, в свою очередь, более конкретная цель. Мы хотели библиотеку, разработанную специально для программирования в функциональном стиле, библиотеку, с которой легко создавать функциональные источники информации, которая не изменяет данные пользователя.
Основные отличительные особенности Ramda:
-
Ramda делает упор на чистый функциональный стиль. Неизменность (Immutable) данных и отсутствие побочных эффектов функций лежат в основе философии дизайна. Это помогает выполнять работу с помощью простого и элегантного кода.
-
Ramda функции имеют автоматический карринг. Это позволяет легко строить новые функции из старых просто не передавая конечный параметр.
-
Параметры в Ramda функциях расположены таким образом, чтобы сделать карринг как можно более удобным. Данные, которые должны быть обработанны, как правило, передаются в последнюю очередь.
Последние два пункта вместе, делают простым создание последовательностей функций, каждая из которых преобразует данные и передает их следующей. Ramda спроектирована для поддержки такого стиля написания кода.
- Введение в Ramda by Buzz de Cafe
- Почему Ramda? by Scott Sauyet на русском языке
- Содействие каррингу by Scott Sauyet
- Почему карринг помогает by Hugh Jackson
- Эй, Underscore, ты делаешь это неправильно! by Brian Lonsdorf
- Думать в Ramda by Randy Coulman на русском языке
Используя Ramda у вас должно появиться чувство как будто вы просто используете JavaScript. Это практичный, функциональный JavaScript. Мы не представляем лямбда выражения в строках, мы не заимствуем consed списки, мы не импортируем все функции с Clojure.
Наши базовые структуры данных - это простые JavaScript объекты, а наши обычные коллекции - это JavaScript массивы. Мы также сохраняем другие встроенные в JavaScript функции, такие как функции-объекты со свойствами.
Функциональное программирование в значительной степени связано с неизменными (immutable) объектами и Функциями без побочных эффектов. Хотя Ramda не применяет это, она позволяет использовать такой стиль с как можно меньшим "трением".
Мы стремимся к реализации как чистоты, так и элегантности кода, но АРI остается более важным. Частично мы приносим в жертву элегантность реализации ради более чистого АРI.
И последнее, но не менее важное: Ramda стремится к производительности. Надежная и быстрая реализация побеждают любые понятия функциональной чистоты.
Для использования с node:
$ npm install ramdaЗатем в консоли:
const R = require('ramda');Для прямого использования в браузере:
<script src="path/to/yourCopyOf/ramda.js"></script>или минифицированная версия:
<script src="path/to/yourCopyOf/ramda.min.js"></script>или с CDN, или cdnjs:
<script src="//cdnjs.cloudflare.com/ajax/libs/ramda/0.25.0/ramda.min.js"></script>или с помощью одной из ссылок приведенных ниже jsDelivr:
<script src="//cdn.jsdelivr.net/npm/ramda@0.25.0/dist/ramda.min.js"></script>
<script src="//cdn.jsdelivr.net/npm/ramda@0.25/dist/ramda.min.js"></script>
<script src="//cdn.jsdelivr.net/npm/ramda@latest/dist/ramda.min.js"></script>(заметьте, что использование latest привносит огромный риск того, что при изменении Ramda API ваш код может сломаться.)
Эти теги script добавляют переменную R в глобальной области видимости браузера.
Или вы можете вставить Ramda в любой ничего не подозревающий сайт с помощью bookmarklet.
Замечания к версиям > 0.25
Версии Rambda > 0.25 не имеют экспрота по умолчанию.
Поэтому вместо import R from 'ramda'; нужно использовать import * as R from 'ramda';
А еще лучше, импортировать только необходимые функции через import { functionName } from 'ramda';
- на Unix-подобных платформах,
npm run buildобновляет dist/ramda.js и dist/ramda.min.js - на Windows, запишите результат
scripts / build --completeдо временного файла, после чего переименуйте временный файл на dist / ramda.js.
Возможно собрать Ramda с подмножеством функциональных возможностей ради уменьшения размера файла. Система сборки Ramda предоставляет эту возможность с помощью флажков в командной строке. Например, если вы используете R.compose, R.reduce и R.filter, вы можете создать частичную сборку с помощью следующей строки:
./scripts/build -- src/compose.js src/reduce.js src/filter.js > dist/ramda.custom.js
Для этого нужно иметь установленный Node/io.js.
- Перевод API-документации русский язык.
- Переклад API-документації украинский язык.
- API Документация английский язык.
Хорошо, Итак, мы любим овец: ram:. Это все. Это короткое имя, никем пока не занято. Это с легкостью могло бы быть eweda, но тогда мы бы были вынуждены говорить eweda lamb! (lamb - ягненок, прим.переводчика), а токого никто не хотел. Для тех, кто не является носителем английского языка, lambs - это детеныш овцы, ewes - это овца, а rams - бараны. Поэтому, возможно, ramda-это повзрослевшая lambda... Но, наверное, нет.
Консоль:
Для запуска тестов с консоли, вам необходимо установить mocha:
npm install -g mocha
Тогда из корня вашего проекта вы можете просто вызвать
mocha
Или если вы установили зависимости через:
npm install
тогда вы можете запустить тесты (и получить вывод деталей в терминале) запустив команду:
npm test
Браузер:
Вы можете использовать testem для тестирования в разных браузерах (и даже в "безголовых" браузерах), с мгновенной перезагрузкой. Установите testem (npm install -g testem) и выполните testem. Откройте ссылку которую предоставит вам ваш браузер и вы увидите результаты в вашем терминале.
Если у вас установлен PhantomJS , вы можете выполнить testem -l phantomjs для запуска тестов полностью в "безголовом" режиме.
Спасибо J. C. Phillipps за Ramda logo. Ramda logo artwork © 2014 J. C. Phillipps. Creative Commons Licensed CC BY-NC-SA 3.0.