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/[email protected]/dist/ramda.min.js"></script>
<script src="//cdn.jsdelivr.net/npm/[email protected]/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 для запуску тестів повністю у "безголовому" режимі.

Переклади

• Англійською(English)
• Китайською(中文)

Подяки

Дякуємо J. C. Phillipps за Ramda logo. Ramda logo artwork © 2014 J. C. Phillipps. Licensed Creative Commons CC BY-NC-SA 3.0.