Quaint-repple NPM

quaint-repple

Embed a REPL in Quaint.

Example of `quaint-repple in action (for the Earl Grey language): http://earl-grey.io/repl.html

Install

In your Quaint project directory, run the command:

quaint --setup repple

Sample usage

repple repl ::
  language = javascript
  theme = zenburn
  code =>
    function fun(superFun) {
      return "Quaint is as fun as " + superFun  + "!";
    }

Sample configuration

"repple": {
  "language": "javascript",
  "theme": "zenburn"
}

`repple` macro

The macro is used like this:

repple <type> ::
  <option> = <value>
  ...

Types

There are four "types" of interactive environments that you can embed:

repl: a read-eval-print-loop where you can enter commands and view the results.
repl-aside: a repl with an output area on the side. That output area can be written to by returning Into("aside", "something") to the repl.
editor: a full editor with an output area on the side. Hit Ctrl+Enter to evaluate the code in the editor. The result will be printed out on the side.
editor-repl: a full editor with a repl on the side. Hit Ctrl+Enter to evaluate the code in the editor. Then you can use the repl to play with the functionality you defined in the editor.

Options

language: the language to use, either javascript or earlgrey
theme: the CodeMirror theme to use
code: a code block in the chosen language. If type is editor or editor-repl, that code will appear in the editor at the start. If repl or repl-aside it will be executed and its return value, if it is not undefined, will be printed out in the repl. (Note: use code => instead of code =).

Evaluation environment

The repl and editor have access to a few special variables and functions:

$out: in the repl, represents the output box for the current expression. You may call $out.log(value) to log a value there.
$repl: the repl object, if there is a repl. $repl.cm is the CodeMirror instance for the current expression, if you need to manipulate it.
$editor: the editor object, if there is an editor. $editor.cm is the CodeMirror instance for the editor, if you need to manipulate it.
Into(id, value): when returned to the repl, that object instructs repple to print out the value in the element with id id. But note that the special value "aside" will print it in the area next to the repl when the type is repl-aside.
throw ReloadAfterPromise(promise): when a value of type ReloadAfterPromise is thrown, repple will automatically catch it, wait for the promise it encapsulates to end, and then re-execute the expression. Be careful with this one.
compile(): in the mode editor-repl, this will trigger recompilation of the editor's contents.