https://github.com/ramda/repl
The Ramda REPL
https://github.com/ramda/repl
Last synced: 16 days ago
JSON representation
The Ramda REPL
- Host: GitHub
- URL: https://github.com/ramda/repl
- Owner: ramda
- Created: 2016-09-13T22:14:40.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-10-26T15:24:47.000Z (over 1 year ago)
- Last Synced: 2025-04-10T00:29:36.231Z (19 days ago)
- Language: JavaScript
- Size: 2.57 MB
- Stars: 35
- Watchers: 10
- Forks: 15
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Ramda Repl
==========
A repl (read-eval-print-loop) for [Ramda](http://ramdajs.com/)
[](https://travis-ci.org/ramda/repl)
---
### Usage
[dist/bundle.js](dist/bundle.js) will expose a global function called `ramdaRepl`.
`ramdaRepl` is applied to two arguments (details to follow) and will immediately attempt to instantiate itself in the DOM.
An example with all the configuration options set is available [here](example/index.html).
```js
ramdaRepl(target, config)
```
#### target
`target` is a reference to a DOM Node, such as you would get from `document.querySelector`:
```js
var target = document.querySelector('#my-text-area');
```
RamdaREPL will do the following operations with respect to the target DOM Node:
- it will hide the target node
- it will add itself to the DOM as a sibling to the target node
- it will look for text within the target node and will prefill the input panel with this text (this can be overridden by the config)
#### config
`config` is a regular JavaScript object.
Key
Required
Type
Description
Example
apiURL
Yes
String
A path to a Google url-shortener service endpoint - this will require a specific API key, details here
"https://www.googleapis.com/urlshortener/v1/url?key=APIKEY"
returnUrl
Yes
String
A URL (minus query string) that will be used with the url-shortening service to indicate where a sharable link will take user-agents. The current query string will be appended to this. This idea here is that you can have a REPL at http://your-ramda-repl.com#code and have the share feature redirect to http://ramdajs.com/repl#code should you wish.
"http://ramdajs.com/repl/"
initialValue
No
String
Used to provide the initial code in the input panel. It overrides the default behaviour, which is to use the content of the target element.
"identity(1)"
onChange
No
Function
This is called with the pre-compiled text from the input window whenever this text is changed. This can be used for updating the URL with a new query string, for example.
(code) => window.location.hash = URI.encode(code)
ramdaScript
Yes
Object - see below
A script description object used to defined where Ramda is sourced and how it is globally exposed
{
src : "//cdn.jsdelivr.net/ramda/latest/ramda.min.js",
global : "R"
}
scripts
No
Array of Objects - see below
A list of script description objects used to defined where other interesting libraries are sourced and how they are globally exposed
[
{
src :'//wzrd.in/standalone/sanctuary@latest',
global : 'sanctuary',
exposeAs : 'S'
}
]
The keys `ramdaScript` and `scripts` are used to organise the dynamically loaded scripts that will be available to the REPL, such as [Ramda][ramda], [Sanctuary][sanctuary], and [Ramda-Fantasy][ramda-fantasy].
Ramda is loaded first, as it is presumed that the other libraries will require it to be present before they can be included.
[ramda]: http://ramdajs.com/
[ramda-fantasy]: https://github.com/ramda/ramda-fantasy
[sanctuary]: https://sanctuary.js.org/
Organising the scripts includes providing a reference to a URL where the script can be sourced - and adding in an optional configuration for how globals will be made available.
How the dynamically loaded scripts are made available can be defined using objects with the following keys:
Key
Required
Type
Description
Example
src
Yes
String
A URL referencing a JavaScript file
"//cdn.jsdelivr.net/ramda/latest/ramda.min.js"
global
Yes if exposeAs or expose are used
String
A name of a global the script will introduce
"R"
exposeAs
No
String
The name of a global that will act as an alias to the global introduced by the script
"RAMDA"
expose
No
Array of Strings
A list of method names on the global that you wish to expose globally. Given this list is not provided all methods found on the global will be exposed
[
"identity",
"map",
"filter"
]
### Development
You will find a collection of [npm run *](https://docs.npmjs.com/cli/run-script) scripts in [package.json](package.json):
To run a simple server that will host the [example/index.html](example/index.html) file:
```
npm run server
```
This will start serving the _repl_ at [localhost:8080/example](http://localhost:8080/example)
To build the JavaScript bundle:
```
npm run build-js
```
To build the CSS bundle:
```
npm run build-css
```
#### Watch modes
To build the JavaScript bundle when files change (with sourcemap support):
```
npm run watch-js
```
To build the CSS bundle when files change:
```
npm run watch-css
```
To watch both:
```
npm run watch
```
#### Testing / Linting
To run tests:
```
npm test
```
To lint the JavaScript:
```
npm run lint
```
#### Minification
The CSS is quite small and is minified while it is built.
The JavaScript is not minified by `npm run build-js` or `npm run watch-js` so those operations can run a little faster.
To minify the JavaScript:
```
npm run minify
```