Home

Awesome

Ramda

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

Build Status npm module dependencies Gitter

Чому Ramda?

<img src="http://ramda.jcphillipps.com/logo/ramdaFilled_200x235.png" width="170" height="190" align="right" hspace="12" />

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

Яка різниця?

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

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

Введення

Філософія

Використовуючи 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';

Збірка

Часткова збірка

Можливо зібрати 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.

Документація

Ім'я

Добре, отже, ми любимо овець :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. Licensed Creative Commons CC BY-NC-SA 3.0.