ramda

KO | EN

gitlite — search

#python #javascript #python3 #java #flutter #android #deep-learning #machine-learning #react #typescript #laravel #php

★ 24,058 Open GitHub ↗

:ram: Practical functional Javascript

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Ramda
=============
JavaScript 프로그래머를 위한 실용적인 함수형 라이브러리입니다.
[![Build Status](https://github.com/ramda/ramda/workflows/Build/badge.svg)](https://github.com/ramda/ramda/actions?query=workflow%3ABuild)
[![npm module](https://badge.fury.io/js/ramda.svg)](https://www.npmjs.org/package/ramda)
[![deno land](http://img.shields.io/badge/available%20on-deno.land/x-lightgrey.svg?logo=deno&labelColor=black)](https://deno.land/x/ramda@v0.27.2)
[![nest badge](https://nest.land/badge.svg)](https://nest.land/package/ramda)
[![Gitter](https://badges.gitter.im/Join\_Chat.svg)](https://gitter.im/ramda/ramda?utm\_source=badge&utm\_medium=badge&utm\_campaign=pr-badge&utm\_content=badge)
왜 Ramda인가요?
----------
![](https://ramdajs.com/ramdaFilled_200x235.png)
함수형 성격을 띤 훌륭한 라이브러리는 이미 여러 개 존재합니다. 일반적으로 이러한 라이브러리들은 여러 패러다임에서 작업하기에 적합한 범용 툴킷을 지향합니다. Ramda는 좀 더 명확한 목표를 가지고 있습니다. 우리는 함수형 프로그래밍 스타일에 특화되어 설계된 라이브러리, 함수형 파이프라인을 쉽게 만들 수 있게 해주는 라이브러리, 그리고 사용자 데이터를 절대 변형(mutate)하지 않는 라이브러리를 원했습니다.
무엇이 다른가요?
-----------------
Ramda의 주요 차별점은 다음과 같습니다:
\* Ramda는 더 순수한 함수형 스타일을 강조합니다. 불변성(Immutability)과 부수 효과가 없는(side-effect free) 함수가 설계 철학의 핵심입니다. 이를 통해 간단하고 우아한 코드로 작업을 완료할 수 있습니다.
\* Ramda 함수들은 자동으로 커링(curried)됩니다. 이를 통해 마지막 파라미터를 생략하는 것만으로도 기존 함수로부터 새로운 함수를 쉽게 조합할 수 있습니다.
\* Ramda 함수의 파라미터는 커링에 유리하도록 배치되어 있습니다. 조작할 데이터는 일반적으로 가장 마지막에 전달됩니다.
앞의 두 가지 특징 덕분에, 각각 데이터를 변환하고 다음 함수로 전달하는 더 단순한 함수들의 시퀀스로 함수를 매우 쉽게 구성할 수 있습니다. Ramda는 이러한 코딩 스타일을 지원하도록 설계되었습니다.
소개 및 가이드
-------------
\* Buzz de Cafe의 [Introducing Ramda](http://buzzdecafe.github.io/code/2014/05/16/introducing-ramda)
\* Scott Sauyet의 [Why Ramda?](http://fr.umio.us/why-ramda/)
\* Scott Sauyet의 [Favoring Curry](http://fr.umio.us/favoring-curry/)
\* Hugh Jackson의 [Why Curry Helps](https://hughfdjackson.com/javascript/why-curry-helps/)
\* Brian Lonsdorf의 [Hey Underscore, You're Doing It Wrong!](https://www.youtube.com/watch?v=m3svKOdZijA&app=desktop)
\* Randy Coulman의 [Thinking in Ramda](https://randycoulman.com/blog/categories/thinking-in-ramda)
철학
----------
Ramda를 사용하는 것은 마치 그냥 JavaScript를 사용하는 것과 같은 느낌이어야 합니다.
이것은 실용적이고 함수형인 JavaScript입니다. 우리는 문자열 내에 람다 표현식을 도입하지 않으며, consed 리스트를 차용하지 않고, Clojure의 모든 함수를 포팅해 오지도 않습니다.
우리의 기본 데이터 구조는 평범한 JavaScript 객체이며, 일반적인 컬렉션은 JavaScript 배열입니다. 또한 속성을 가진 객체로서의 함수와 같은 JavaScript의 다른 네이티브 기능들도 그대로 유지합니다.
함수형 프로그래밍은 상당 부분 불변 객체와 부수 효과가 없는 함수에 관한 것입니다. Ramda가 이를 강제(enforce)하는 것은 아니지만, 이러한 스타일을 최대한 마찰 없이 사용할 수 있도록 지원합니다.
우리는 깨끗하고 우아한 구현을 목표로 하지만, API가 최우선입니다.
심지어 약간 더 깔끔한 API를 위해서라면 구현의 우아함은 기꺼이 희생합니다.
마지막으로, Ramda는 성능을 추구합니다. 신속하고 안정적인 구현은 함수형 순수성이라는 그 어떤 개념보다 우선합니다.
설치
------------
Node에서 사용하는 방법:
```bash
$ npm install ramda
```
그런 다음 콘솔에서:
```javascript
const R = require('ramda');
```
[Deno](https://deno.land)에서 직접 사용하는 방법:
```javascript
import \* as R from "https://deno.land/x/ramda@v0.27.2/mod.ts";
```
또는 Nest.land를 사용하는 방법:
```javascript
import \* as R from "https://x.nest.land/ramda@0.27.2/mod.ts";
```
브라우저에서 직접 사용하는 방법:
```html
```
또는 압축된(minified) 버전을 사용하는 방법:
```html
```
또는 CDN(cdnjs)을 사용하는 방법:
```html
```
또는 [jsDelivr](http://jsdelivr의 아래 링크 중 하나를 사용하는 방법

.com):
```html
```
(참고로 `latest`를 사용하는 것은 Ramda API 변경으로 인해 코드가 깨질 수 있는 상당한 위험을 감수하는 것입니다.)
이 스크립트 태그들은 브라우저의 전역 스코프에 `R` 변수를 추가합니다.
또는 [북마크릿](https://github.com/ramda/ramda/blob/master/BOOKMARKLET.md)을 사용하여 의심하지 않는 거의 모든 웹사이트에 Ramda를 주입할 수 있습니다.
\*\*0.25 버전 이상 참고 사항\*\*
Ramda 0.25 버전 이상에는 기본 내보내기(default export)가 없습니다.
따라서 `import R from 'ramda';` 대신 `import \* as R from 'ramda';`를 사용해야 합니다.
또는 더 나아가 `import { functionName } from 'ramda';`를 통해 필요한 함수만 가져올 수도 있습니다.
\*\*ES6 모듈 및 브라우저 참고 사항\*\*
브라우저에서 ES6 모듈에 접근하려면 \_\_es\_\_ 디렉토리의 콘텐츠를 제공하고(빌드 지침은 아래 참조) `import \* as R from './node\_modules/ramda/es/index.js';`를 사용해야 합니다.
### 빌드
`npm run build`는 `es`, `src` 디렉토리를 생성하고 \_\_dist/ramda.js\_\_와 \_\_dist/ramda.min.js\_\_를 모두 업데이트합니다.
#### 부분 빌드
파일 크기를 줄이기 위해 기능의 하위 집합만 포함하여 Ramda를 빌드할 수 있습니다. Ramda의 빌드 시스템은 명령행 플래그를 통해 이를 지원합니다. 예를 들어 `R.compose`, `R.reduce`, `R.filter`를 사용하는 경우 다음과 같이 부분 빌드를 생성할 수 있습니다:
npm run --silent partial-build compose reduce filter > dist/ramda.custom.js
이를 위해서는 Node/io.js가 설치되어 있어야 하고 Ramda의 의존성이 설치되어 있어야 합니다(부분 빌드를 실행하기 전에 `npm install`을 사용하세요).
문서
-------------
[API 문서](https://ramdajs.com/docs/)를 검토해 주세요.
또한 유용하게 사용할 수 있는 Ramda 기반 함수들로 구성된 [쿡북](https://github.com/ramda/ramda/wiki/Cookbook)도 제공됩니다.
이름에 대하여
--------
좋습니다, 우리는 양을 좋아합니다. 그게 전부입니다. 짧은 이름이고, 아직 선점되지 않았습니다. `eweda`가 될 수도 있었지만, 그랬다면 _eweda lamb!_이라고 말해야 했을 것이고, 아무도 그걸 원하지 않겠죠. 영어가 모국어가 아닌 분들을 위해 설명하자면, lamb은 어린 양, ewe는 암컷 양, ram은 수컷 양을 의미합니다. 그러니 어쩌면 ramda는 다 큰 람다(lambda)일지도 모릅니다... 하지만 아마 아닐 겁니다.
테스트 스위트 실행
----------------------
\*\*콘솔:\*\*
콘솔에서 테스트 스위트를 실행하려면 `mocha`가 설치되어 있어야 합니다:
npm install -g mocha
그런 다음 프로젝트의 루트에서 다음을 호출하면 됩니다:
mocha
또는 다음과 같이 의존성을 설치한 경우:
npm install
`npm test`를 실행하여 테스트를 실행하고(상세한 출력 결과를 얻고) 할 수 있습니다.
\*\*브라우저:\*\*
[testem](https://github.com/airportyh/testem)을 사용하여 다양한 브라우저에서(또는 헤드리스 방식으로도) 테스트를 실행할 수 있으며, 테스트의 실시간 리로드(livereloading)를 지원합니다. testem을 설치하고(`npm install -g testem`) `testem`을 실행하세요. 브라우저에서 제공된 링크를 열면 터미널에서 결과를 볼 수 있습니다.
_PhantomJS_가 설치되어 있다면 `testem -l phantomjs`를 실행하여 완전히 헤드리스 방식으로 테스트를 실행할 수 있습니다.
사용법
-----------------
`v0.25` 이상 버전에서는 라이브러리 전체를 가져오거나 라이브러리에서 ES 모듈을 직접 선택하여 가져오세요:
```js
import \* as R from 'ramda'
const {identity} = R
R.map(identity, [1, 2, 3])
```
Ramda에서 구조 분해 할당을 통해 가져오는 것이 \*반드시 라이브러리 전체의 임포트를 방지하는 것은 아닙니다\*. 다음과 같이 메서드를 수동으로 개별 선택(cherry-pick)하면 `identity`가 작동하는 데 필요한 부분만 가져올 수 있습니다:
```js
import identity from 'ramda/src/identity'
identity()
```
하지만 메서드를 수동으로 하나씩 고르는 것은 번거롭습니다. Webpack이나 Rollup 같은 대부분의 번들러는 사용되지 않는 Ramda 코드를 제거하고 번들 크기를 줄이는 방법으로 트리 셰이킹(tree-shaking)을 제공하지만, 성능은 [여기](https://github.com/scabbiaza/ramda-webpack-tree-shaking-examples)에서 논의된 바와 같이 다양합니다. 사용 중인 기술에 따른 최적의 설정 요약은 다음과 같습니다:
1. Webpack + Babel - [`babel-plugin-ramda`](https://github.com/megawac/babel-plugin-ramda)를 사용하여 메서드를 자동으로 개별 선택합니다. 논의는 [여기](https://www.andrewsouthpaw.com/ramda-webpack-and-tree-shaking/), 예시는 [여기](https://github.com/AndrewSouthpaw/ramda-webpack-tree-shaking-examples/blob/master/07-web에서 확인할 수 있습니다.

pack-babel-plugin-ramda/package.json)
1. Webpack 전용 - treeshaking을 위해 `UglifyJS` 플러그인과 `ModuleConcatenationPlugin`을 함께 사용하세요. 관련 토론은 [여기](https://github.com/ramda/ramda/issues/2355)에 있으며, 설정 예시는 [여기](https://github.com/scabbiaza/ramda-webpack-tree-shaking-examples/blob/master/06-webpack-scope-hoisted/webpack.config.js)에서 확인할 수 있습니다.
1. Rollup - 별도의 작업 없이도 treeshaking을 훌륭하게 수행합니다. 예시는 [여기](https://github.com/scabbiaza/ramda-webpack-tree-shaking-examples/blob/master/07-rollup-ramda-tree-shaking/rollup.config.js)에 있습니다.
Typings
-----------------
- [TypeScript](https://www.npmjs.com/package/@types/ramda)
- [Flow](https://github.com/flowtype/flow-typed/tree/master/definitions/npm/ramda\_v0.x.x)
Translations
-----------------
- [Chinese(中文)](http://ramda.cn/)
- [Ukrainian(Українська)](https://github.com/ivanzusko/ramda)
- [Portuguese(BR)](https://github.com/renansj/ramda)
- [Russian(Русский)](https://github.com/Guck111/ramda)
- [Spanish(ES)](https://github.com/wirecobweb/ramda)
Funding
-----------------
Ramda에 후원하고 싶으시다면 [Open Collective](https://opencollective.com/ramda) 페이지를 방문해 주세요. 감사합니다!
Acknowledgements
-----------------
Ramda 로고를 만들어 주신 [J. C. Phillipps](http://www.jcphillipps.com)님께 감사드립니다.
Ramda 로고 아트워크의 저작권은 2014 J. C. Phillipps에게 있습니다. 크리에이티브 커먼즈 
[CC BY-NC-SA 3.0](http://creativecommons.org/licenses/by-nc-sa/3.0/) 라이선스 하에 배포됩니다.

ramda

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README