Ramda

Практична функціональна бібліотека для JavaScript програмістів.

Чому Ramda?

Вже є кілька відмінних бібліотек з функціональним відтінком. Як правило, вони призначенні для того, щоб бути інструментами загального призначення, що підходять для роботи в декількох парадигмах. У Ramda, в свою чергу, більш конкретна мета. Ми хотіли бібліотеку, розроблену спеціально для програмування у функціональному стилі, бібліотеку, з якою легко створювати функціональні джерела інформації, яка не змінює данні користувача.

Яка різниця?

Основні відмінні риси Ramda є:

Ramda ставить наголос на більш чистому функціональному стилі. Незмінність даних і відсутність побічних ефектів функцій лежать у самому серці філософії дизайну. Це може допомогти вам виконати роботy за допомогою простого та елегантного коду.
Ramda функції мають автоматичний каррінг. Це дозволяє легко будувати нові функції зі старих просто не передаючи кінцевий параметр.
Параметри у Ramda функціях розташовані таким чином, щоб зробити каррінг якомога зручнішим. Дані, які мають бути обробленими, як правило, подаються в останню чергу.

Останні два пункти разом роблять дуже легким створення функцій у вигляді послідовності простих функцій, кожна з яких перетворює дані та передає їх до наступної. Ramda cпроектована для підтримки такого стилю написання коду.

Введення

Введення в Ramda by Buzz de Cafe
Чому Ramda? by Scott Sauyet
Сприяння каррінгу by Scott Sauyet
Чому кaррінг допомогає by Hugh Jackson
Агов, Underscore, ти робиш це неправильно! by Brian Lonsdorf
Думати в Ramda by Randy Coulman

Філософія

Використовуючи Ramda ви повинні почуватись наче ви просто використовуєте JavaScript. Це практичний, функціональний JavaScript. Ми не представляємо лямбда вирази у рядках, ми не запозичуємо consed списки, ми не портуємо всі функції з Clojure.

Наші базові структури даних - це прості JavaScript об'єкти і наші звичайні колекції - це JavaScript масиви. Ми також зберігаємо інші вбудовані у JavaScript функції, такі як функції-об'єкти з властивостями.

Функціональне програмування в значній мірі пов'язано з незмінними (immutable) об'єктами та функціями без побічних ефектів. Хоча Ramda не застосовує це, вона дозволяє використовувати такий стиль з якомога меншим "тертям".

Ми прагнемо до реалізації як чистоти так і елегантності, але АРІ лишається більш важливим. Ми частково приносимо в жертву елегантність реалізації заради більш чистого АРІ.

І останнє, але не менш важливе: 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 документація англійською мовою.

Ім'я

Добре, отже, ми любимо овець 🐏. Це все. Це коротке ім'я, ніким поки не зайняте. Це з легкістю могло би бути 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 для запуску тестів повністю у "безголовому" режимі.

ivanzusko / ramda