Cognitect REBL

REBL is early access. Your feedback can help make it better. Please report any issues that you encounter.

To use REBL with nREPL or nREPL based editors:

• Install REBL
• Add nREPL as dependency to your project.
• Start REBL using the appropriate alias clj -A:rebl-jdk8:nREPL or clj -A:rebl:nREPL for JDK 11+
• Start an nREPL server from inside REBL
• Connect to the nREPL server from your editor of choice.

Forms can be sent to REBL using cognitect.rebl/inspect. They will be evaluated and added to the eval-history.

Emacs cider users can launch REBL automatically and send forms on request via defun->keybinding by using the instructions in the cider-rebl repository.

• Install REBL and the deps.
• Create a new, or use an existing, Clojure Deps project
  • Edit your REPL Configuration to use:
    • REPL type: clojure.main
    • Check Run with Deps:
    • Enter the appropriate alias: rebl-jdk8 for JDK 8, or rebl for JDK 11+

If you are using nREPL, then please follow the nREPL Instructions.

REBL currently requires Java 1.8 or Java 11+

The Code Editor is a full-featured editor for writing clojure code. Code is evaluated and the results are immediately available inside the browser, out and tap tabs.

Numerous hotkeys are available for text editing.

Results of evaluation appear in the Browser pane. When navigating using the forward and back buttons, the current values will appear in the appropriate browser in this pane.

nav-> will navigate deeper into data while keeping the current browser view on the data that you're acting upon.

Evaluating new code or navigating back to the root will cause the Browser Pane to return to the evaluation-history.

Data in the browser can be displayed in a variety of ways. The Browser View drop-down lists the current available views for the data displayed in the Browser.

The data currently selected in the Browser will be displayed in the Data Viewer using the currently selected viewer.

A number of viewers are available for different shapes and types of data.

Typing a valid clojure symbol name into the def as: text box and pressing enter will def bind the data shown in the Data Viewer to that var in the user namespace.

Vars are def'd in the user name space.

This is often useful when navigating deep into data and you want to extract the data in the Data Viewer.

The Metadata Viewer displays the Metadata for the data currently displayed in the Data Viewer

The forward button (Command-Right) navs into the data selected in the Data Viewer and the current value is moved to the Browser.

If nav-> is currently being used, then it will be added to the path when navigating forward.

The back button (Command-Left) navs to the previous value in the navigation history.

If nav-> was used while navigating forward, then the full nav-> path that was used will be treated as a single nav step while navigating back.

This button (Shift-Command-Left) will navigate back to the evaluation history.

If launching REBL normally, REBL will follow all REPL interactions. The Follow REPL checkbox controls whether this is active or not.

The out tab shows *out* for the REBL repl.

REBL adds a tap and calls to tap will be displayed here.

The resulting values from REBL's tap can be cleared, or loaded into the Data View with the browse button.

path: displays the currently navigated path starting with the index in the eval-history.

nav-> allows you to supply a set of keys or a set of parenthesized forms to navigate forward in the currently selected collection without changing the relationship between the Current Browser and Data Viewer panes.

The Data Viewer will nav-> to the data, but the Browser will remain unchanged.

nav-> remains in effect while browsing the eval-history, so if you have a number of results which require the same navigational steps, this can be entered into nav-> and all browsing will utilize those steps.

REBL will open a WebView on java.io.Files whose name returns a text/ or image/ mimetype from the configured Java FileNameMap.

• Upgrade Clojure to 1.11.1

• Update core.async to 1.5.648
• Update cljfmt to 0.8.0

• Provide dev-tools via Cognitect maven repo

• Improvement: Added copy functionality to the viewer.
• Improvement: Keep the cursor in view while navigating with selected text.

• This version of REBL replaces the embedded code editor (formerly CodeMirror) with Monaco, the editor engine used in VS Code. While this was a good bit of work under the hood, superficially it might not seem like a lot. This will give us a framework for more features. The first of these is proper paredit support (replacing the parinfer we had before). Please see the Hotkeys page for more details.
• Monaco has a lot of features already, e.g. code folding (press F1 in the editor to see and search for commands and their keystrokes), and provides hooks for many language editing tasks which we hope to wire up over time.
• At present the keybindings are still hardwired, but we plan to offer user-customized bindings.
• Speaking of bindings there is a significant change to the default nav bindings - they now conform to the browser standards (Command-L/R, which was always intended but problematic before).

• fixed incompatibility with Java 11
• nav-> to nil returns nil

• add a path of keys or parenthesized expressions to browser "nav->" to transform the elements in the viewer
• browser "path" shows the path your browsing took
• tap view has a "browse" button so that you can browse tap results as data
• column sorts now use Clojure's compare where possible

• new var nav now shows runtime deps (:rebl.var/uses and :rebl.var/used-by) and :rebl/source if available
• string expressions with code can now use the code viewer
• fixed nav for sets
• fixes https://github.com/cognitect-labs/REBL-distro/issues/24
• fixes https://github.com/cognitect-labs/REBL-distro/issues/23

• Datafy support for csv, edn, json, and yaml files.
• Tap pane now shows a list of recent tap> values.
• "def as…" now works correctly with unprintable/unreadable Objects.

• Initial release.