ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Clojure Sublimed

by tonsky ST4

Clojure support for Sublime Text 4

Labels clojure, repl, nrepl

Details

Installs

  • Total 478
  • Win 89
  • Mac 291
  • Linux 98
May 18 May 17 May 16 May 15 May 14 May 13 May 12 May 11 May 10 May 9 May 8 May 7 May 6 May 5 May 4 May 3 May 2 May 1 Apr 30 Apr 29 Apr 28 Apr 27 Apr 26 Apr 25 Apr 24 Apr 23 Apr 22 Apr 21 Apr 20 Apr 19 Apr 18 Apr 17 Apr 16 Apr 15 Apr 14 Apr 13 Apr 12 Apr 11 Apr 10 Apr 9 Apr 8 Apr 7 Apr 6 Apr 5 Apr 4 Apr 3
Windows 0 1 0 0 0 0 0 0 0 1 1 0 0 0 2 0 0 0 0 1 0 1 1 0 1 0 3 1 0 0 0 1 0 2 0 0 2 1 0 0 0 0 0 0 1 1
Mac 1 2 2 0 2 0 1 0 2 1 1 3 2 3 3 3 0 1 1 2 0 3 4 0 0 0 2 1 1 5 0 0 1 1 1 3 0 1 1 5 1 2 0 2 2 0
Linux 0 0 1 0 2 0 0 1 0 0 0 1 3 0 0 0 1 0 0 0 0 4 0 0 1 0 1 0 0 0 0 0 2 1 0 1 0 2 1 1 0 0 0 0 3 0

Readme

Source
raw.​githubusercontent.​com

Clojure support for Sublime Text 4

This package provides Clojure support for Sublime Text and includes:

  • Clojure and EDN syntax grammars (Sublime Text 3+)
  • Clojure code formatter/indenter (Sublime Text 4075+)
  • Clojure nREPL client (Sublime Text 4075+, nREPL 0.8+)

Clojure syntax

Syntaxes

Clojure Sublimed ships with its own syntax definition for Clojure and EDN. Unlike default Clojure syntax, this package is:

  • slightly more pedantic as per EDN spec and Clojure Reader,
  • rigorously tested,
  • can be used to highlight rainbow parentheses,
  • punctuation and validation inside regexps,
  • quoted and unquoted regions are marked for highlighting,
  • semantically correct tokenization, perfect for fonts with ligatures,
  • has separate EDN syntax, same way JSON is separate from JavaScript in Sublime Text.

Want to put your parser to test? Check out syntax_test_edn.edn and syntax_test_clojure.cljc.

Clojure Sublimed syntax is also used by nREPL client to find form boundaries and namespaces (might be changed in the future).

Formatter/indenter

Clojure Sublimed includes optional support for Simple Clojure Formatting rules. It doesn’t require nREPL connection but does require Clojure (Sublimed) syntax to be selected for buffer.

To reformat whole file, run Clojure Sublimed: Reindent Buffer.

To reindent only current line(s), run Clojure Sublimed: Reindent Lines.

To enable correct indentations as you type code, rebind Enter to Clojure Sublimed: Insert Newline:

{"keys":    ["enter"],
 "command": "clojure_sublimed_insert_newline",
 "context": [{"key": "selector", "operator": "equal", "operand": "source.edn | source.clojure"},
             {"key": "auto_complete_visible", "operator": "equal", "operand": false},
             {"key": "panel_has_focus", "operator": "equal", "operand": false}]}

Best way to do it is through running Preferences: Clojure Sublimed Key Bindings.

nREPL Client

Clojure Sublimed nREPL client enables interactive development from the comfort of your editor.

Principles:

  • Minimal distraction. Display evaluation results inline.
  • Decomplected. Eval code and nothing more.
  • Server-agnostic. We work with any nREPL socket, local or over network.

Features:

  • [x] evaluate code,
  • [x] display evaluation results inline.
  • [x] display stack traces inline,
  • [x] interrupt evaluation,
  • [x] eval multiple forms at once (parallel evaluation),
  • [x] lookup symbol info,
  • [x] show evaluation time,
  • [x] bind keys to eval arbitrary code.

We intentionally excluded following features:

  • [ ] Autocomplete. Static analysis is much simpler and much more reliable than requiring an always-live connection to the working app.

Why nREPL and not Socket Server REPL/pREPL/unREPL?

  • nREPL has the widest adoption,
  • nREPL is machine-friendly,
  • nREPL comes with batteries included (interrupt, load-file, sideload),
  • nREPL is extensible via middleware,
  • nREPL serialization is easier to access from Python than EDN.

Differences from Tutkain:

  • nREPL instead of Socket Server REPL
  • Does not have separate REPL panel
  • Keeps multiple eval results on a screen simultaneously
  • Can show stack traces inline in editor
  • Can eval several forms in parallel
  • Can eval non well-formed forms (e.g. (+ 1 2)
  • Can eval infinite sequences
  • Redirects all *out*/*err* to System.out/System.err

Installation

  1. Package Control: Install PackageClojure Sublimed

  2. Assign syntax to Clojure files:

  • open any clj/cljc/cljs file,
  • run ViewSyntaxOpen all with current extension as...Clojure SublimedClojure (Sublimed).

How to use

Important! Make sure you switched your syntax to Clojure (Sublimed).

  1. Run nREPL server.
  2. Run Clojure Sublimed: Connect command.

Evaluating code from buffer

From here you have three options:

Clojure Sublimed: Evaluate without selection evaluates topmost form around your cursor:

Evaluate Topmost

Clojure Sublimed: Evaluate with selection evaluates selected text:

Evaluate Selection

Clojure Sublimed: Evaluate Buffer will evaluate the entire file:

Evaluate Buffer

You don’t have to wait for one form to finish evaluating to evaluate something else. Multiple things can be executed in parallel:

Evaluate in Parallel

By default, Clojure Sublimed will also print evaluation time if it took more than 100 ms:

Elapsed time

Copying evaluation results

Sometimes you want to copy evaluation result. It is recommended to rebind Cmd+C/Ctrl+C from copy to sublime_clojure_copy. This will copy evaluation result if inside evaluated region and fallback to default copy otherwise.

Interrupting

If your evaluation runs too long and you want to interrupt it, run Clojure Sublimed: Interrupt Pending Evaluations:

Interrupt

Opening stacktrace

If your evaluation failed, put your cursor inside failed region and run Clojure Sublimed: Toggle Stacktrace:

Toggle Stacktrace

Clojure Sublimed will display stacktraces in a Clojure-friendly way. Compare with the default REPL:

Stacktraces

Looking up symbol

To show symbol info, run Clojure Sublimed: Toggle Symbol Info:

Toggle Symbol Info

Universal Clojure Sublimed: Toggle Info command acts as either Toggle Stacktrace or Toggle Symbol Info, depending on context.

Binding keys to eval code

Every project is different, and sometimes it’s convenient to run a piece of code so often you’d want it on a shortcut. It might be a namespace reload, test execution, database reconnect, linter, formatter — possibilities are endless.

To support such use cases, Clojure Sublimed allows you to bind arbitrary piece of code to a keyboard shortcut. Run Preferences: Clojure Sublimed Key Bindings and add something like this:

{"keys": ["ctrl+t"],
 "command": "clojure_sublimed_eval_code",
 "args": {"code": "(clojure.test/run-all-tests)"}}

Then, whenever you press Ctrl + T, you’ll see the result in the status bar, like this:

Eval Code

Clearing results

Finally, to clear evaluation results run Clojure Sublimed: Clear Evaluation Results.

Editing settings

To edit settings, run Preferences: Clojure Sublimed Settings command.

Default Key Bindings

Clojure Sublimed comes with no keybindings enabled by default to guarantee they won’t conflict with any other extension.

This is the recommended keymap:

Command macOS Windows/Linux Mnemonic
Evaluate Ctrl Enter Ctrl Alt Enter
Evaluate Buffer Ctrl B Ctrl Alt B [B]uffer
Interrupt Pending Evaluations Ctrl C Ctrl Alt C [C]ancel
Toggle Info Ctrl I Ctrl Alt I [I]nfo
Clear Evaluation Results Ctrl L Ctrl Alt L c[L]ear
Copy Evaluation Results Command C Ctrl C [C]opy
Reindent Lines Ctrl F Ctrl Alt F [F]ormat
Reindent Buffer Ctrl Shift F Ctrl Alt Shift F Capital [F]ormat

To set it up, run Preferences: Clojure Sublimed Key Bindings command and copy example keybindings to your local Key Bindings file.

Frequently Asked Questions

Q: REPL/eval doesn’t work

A: Make sure you are using nREPL 0.8 or later. A: Make sure you have assigned Clojure (Sublimed) syntax to the file.

Credits

Made by Niki Tonsky.

With contributions by Jaihindh Reddy.

See also

Writer Color Scheme: A color scheme optimized for long-form writing.

Alabaster Color Scheme: Minimal color scheme for coding.

Sublime Profiles: Profile switcher.

License

MIT License