An emacs mode for Replique. Replique is a development environment for Clojure and Clojurescript. Replique relies on the Clojure command line tools for starting REPLs.
Replique is compatible with clojure 1.8.0+, clojurescript 1.10.238+ and requires emacs 27+.
Add Replique to your emacs package archives
(add-to-list 'package-archives '("replique" . "https://raw.githubusercontent.com/EwenG/EwenG.github.io/master/packages") t)Install Replique
(unless (package-installed-p 'replique)
(package-refresh-contents)
(package-install 'replique))Load replique
(require 'replique)
Enable Replique when editing clojure files
(add-hook 'clojure-mode-hook 'replique/minor-mode)
See the Clojure getting started for instructions on how to install the command line tools.
The Clojure command used to start REPLs is customizable:
(setq replique/clojure-bin "~/bin/clojure")
Auto completion is supported through company-mode.
Enable company-mode either globally or locally
(add-hook 'after-init-hook 'global-company-mode)
Or
(add-hook 'clojure-mode-hook
(lambda ()
(company-mode 1)))(add-hook 'replique/mode-hook
(lambda ()
(company-mode 1)))Enable css files reloading
(add-hook 'css-mode-hook 'replique/minor-mode)
Enable stylus files reloading
(add-hook 'stylus-mode-hook 'replique/minor-mode)
Enable less files reloading
(add-hook 'less-css-mode-hook 'replique/minor-mode)
Enable javascript files reloading
(add-hook 'js2-mode-hook 'replique/minor-mode)
Enable code evaluation in org-mode
(add-hook 'org-mode-hook
(lambda ()
(require 'ob-replique))- Clojure and Clojurescript REPL, one or multiple sessions
- Preconfigured Clojurescript compiler for development builds
- Autocompletion
- Jump to symbol definition
- Find usages
- Built-in pretty printing
- Eldoc style documentation
- CSS, Stylus, less, sass, javascript files live reloading
- Data visualization for mutable references
- Support for capturing and visualizing local bindings
- REPL post eval hooks for watching changes in Clojure/Clojurescript namespaces
- Org-mode integration
- Dynamic classpath reloading
- Logs configuration reloading
Replique tries, as much as possible, to keep features parity between Clojure and Clojurescript.
Execute the command:
M-x replique/repl
At that point, Replique prompts for a project directory. Choose the root directory of your project. Replique then prompts for a REPL start script. Choose the "*default*" entry to start the REPL without CLI options. See REPL start script for an explanation of the use of REPL start scripts. Once done, Replique starts a socket REPL using a random available port number.
Use C-x C-e to evaluate a Clojure form, C-c C-l to load a Clojure file in the REPL and C-c M-n to change the REPL namespace.
When evaluating a form from a buffer containing Clojure or Clojurescript code, Replique automatically changes the REPL namespace to the one of this buffer.
Kill the buffer to close the REPL.
Add Clojurescript to your deps.edn dependencies.
[org.clojure/clojurescript {:mvn/version VERSION_NUMBER}]
Start a Clojure REPL:
M-x replique/repl
Start a Clojurescript REPL in your Clojure REPL:
M-x replique/cljs-repl or, at the REPL (replique.interactive/cljs-repl)
Connect a browser to the cljs REPL:
M-x replique/browser
Use C-x C-e to evaluate a Clojurescript form, C-c C-l to load a Clojurescript file in the REPL and C-c M-n to change the REPL namespace.
Kill the buffer to close the REPL.
See the default keymap, the interactive commands and the REPL API.
- REPL sessions
- Clojurescript support
- Web development
- Pretty printing
- Removing vars and reloading dependencies
- Watching / visualizing mutable references
- Finding usages
- Debugging
- Post eval hooks
- Org-mode integration
- Logback and log4j2 reloading
- Migrating from Leiningen
- Building/packaging an application
| Keybinding | Description |
|---|---|
| C-x C-r | Evaluate region |
| C-x C-e | Evaluate last sexp. The REPL namespace is changed to the namespace of the current buffer before the form is evaluated |
| C-M-x | Evaluate top level sexp. If the top level form is a (comment ...) block, then the form evaluated is the one under the comment block |
| C-c C-l | Load file |
| C-c M-n | Change the REPL namespace |
| M-. | Jump to symbol definition |
| C-c C-r | Change active REPL session |
| C-c C-c | Pretty print the expression at point |
| C-c C-u | Find all the usages of the expression at point |
| C-c C-w | Watch a mutable reference or the stream of the REPL output |
| Command | Description |
|---|---|
replique/repl |
Start a REPL, use the universal prefix argument (C-u) to customize the REPL host and port number |
replique/cljs-repl |
Turn a clj REPL into a cljs REPL |
replique/cljs-repl-nashorn |
Turn a clj REPL into a Nashorn cljs REPL |
replique/browser |
Open a browser tab and connects it to the Clojurescript REPL |
replique/switch-active-repl |
Change the active REPL session |
replique/switch-active-process |
Change the active JVM process |
replique/close-process |
Close a JVM process and all its associated REPLs |
replique/restart-process |
Restart a JVM process and recreate all the started REPLs associated with this process. Preserves REPLs types (clj/cljs) |
replique/output-main-js-file |
Write a main js file to disk |
replique/classpath |
Reload the classpath based on the deps.edn configuration, optionally using the optons of a REPl start script |
replique/reload-all |
Reload the current namespace as well as all its dependencies |
replique/remove-var |
Prompts for a var to be undefined. The var is also removed from all the mappings of all the namespaces |
replique/params |
Set the value of *print-length*, *print-level* or *warn-on-reflection* for the currently active REPL |
replique/pprint |
Pretty print the expression at point |
replique/find-usage |
Find all the usages of the expression at point |
replique/watch |
Watch a mutable reference or the stream of the REPL output |
replique/logback-reload |
Reload a logback configuration |
replique/log4j2-reload |
Reload a log4j2 configuration |
All REPL functions/macros are in the replique.interactive namespace
| Functions | Description |
|---|---|
repl |
Start a Clojure REPL. This MUST be used instead of clojure.main/repl |
cljs-repl |
Turn the REPL into a Clojurescript REPL |
cljs-repl-nashorn |
Turn the REPL into a Clojurescript REPL running in a Nashorn environement |
logback-reload |
Reload the logback configuration given as parameter. |
log4j2-reload |
Reload the log4j2 configuration given as parameter. |
eval-js |
Evaluate a javascript string using the currently connected javascript runtime environment |
| Macros | Description |
|---|---|
load-file |
Loads a clj/cljs/cljc file in the REPL |
load-url |
Loads a clj/cljs/cljc URL in the REPL. The URL can be a file or a file in a jar |
cljs-in-ns |
Change the cljs REPL namespace |
set-cljs-repl-verbose |
Set the verbose option of the Clojurescript REPL |
set-cljs-compiler-opt |
Customize a Clojurescript compiler option. See the compiler-opts var for available options |
remove-var |
Remove a var from its namespace. Also remove all mappings to this var from any namespace |
capture-env |
Capture a local environment and saves it in the atom given as first parameter |
capture-child-env |
Capture a local environment and appends it to its parent. Must be used in the body of a capture-env macro or another capture-child-env macro |
with-env |
Restore the bindings of its first parameter wich must be a captured environment and then executes its body |
| Vars | Description |
|---|---|
compiler-opts |
The compiler options that can be customized at the REPL |
Copyright 2016 Ewen Grosjean.
Distributed under the GNU General Public License, version 3.