ramda/repl

Ramda Repl

A repl (read-eval-print-loop) for Ramda

Usage

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.

ramdaRepl(target, config)

target

target is a reference to a DOM Node, such as you would get from document.querySelector:

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.

"https://www.googleapis.com/urlshortener/v1/url?key=APIKEY"
        

"http://ramdajs.com/repl/"
        

"identity(1)"
        

(code) => window.location.hash = URI.encode(code)
        

{
  src    : "//cdn.jsdelivr.net/ramda/latest/ramda.min.js",
  global : "R"
}
        

[
  {
    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, Sanctuary, and 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.

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:

"//cdn.jsdelivr.net/ramda/latest/ramda.min.js"
        

"R"
        

"RAMDA"
        

[
  "identity",
  "map",
  "filter"
]
        

Development

You will find a collection of npm run * scripts in package.json:

To run a simple server that will host the example/index.html file:

npm run server

This will start serving the repl at 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