Практична функціональна бібліотека для JavaScript програмістів.
Вже є кілька відмінних бібліотек з функціональним відтінком. Як правило, вони призначенні для того, щоб бути інструментами загального призначення, що підходять для роботи в декількох парадигмах. У 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 для запуску тестів повністю у "безголовому" режимі.
Дякуємо J. C. Phillipps за Ramda logo. Ramda logo artwork © 2014 J. C. Phillipps. Licensed Creative Commons CC BY-NC-SA 3.0.