A collection of nREPL
middleware, originally designed to enhance
cider-nrepl is also used by fireplace.vim, vim-iced,
Calva, Conjure and other Clojure development tools based on nREPL.
If you're just a user trying to get started with CIDER, then you
probably don't want to read this. You should follow the steps in
CIDER's user manual instead.
People who are new to nREPL might benefit from reading its
Please refer to the documentation site for
information on how to setup
cider-nrepl or how to leverage its nREPL API.
We're following SemVer (as much as one can be
following it when the major version is 0). At this point bumps of the
minor (second) version number are considered major releases and always
include new features or significant changes to existing features. API
compatibility between major releases is not a (big) concern (although we try
to break the API rarely and only for a good reason).
The development cycle for the next major
release starts immediately after the previous one has been
shipped. Bugfix/point releases (if any) address only serious bugs and
never contain new features.
Note: Prior to cider-nrepl 0.18, CIDER and cider-nrepl releases
were always done in sync. As most editors started relying on cider-nrepl
this was eventually changed and now cider-nrepl releases happen on their
Report issues and suggest features and improvements on the
GitHub issue tracker. Don't
ask questions on the issue tracker - the mailing list and the IRC
channel are the places for questions.
Patches in any form are always welcome! GitHub pull requests are even better! :-)
Before submitting a patch or a pull request make sure all tests are
passing and that your patch is in line with the contribution
Local development tasks, like firing up a repl, running the tests or locally installing cider-nrepl are offered by our Makefile.
We recommend using it, since some aspects can be intrincate to newcomers.
These are its main tasks for local development:
# Fire up a repl and nrepl server you can cider-connect to:
# Run tests, using mranderson (slower but more realistic)
PARSER_TARGET=parser-next make test
# Run tests, without using mranderson (considerably faster)
PARSER_TARGET=parser-next make fast-test
# Install the project in your local ~/.m2 directory, using mranderson (recommended)
# The JVM flag is a temporary workaround.
PROJECT_VERSION=0.45.0 make install
# Install the project in your local ~/.m2 directory, without using mranderson
# (it's faster, but please only use when you repeatedly need to install cider-nrepl)
# The JVM flag is a temporary workaround.
PROJECT_VERSION=0.45.0 make fast-install
# Runs clj-kondo, cljfmt and Eastwood (in that order, with fail-fast).
# Please try to run this before pushing commits.
# Regenerates our user manual.
# When you modify our middleware such that its schema changes, please reflect so in the `cider.nrepl` namespace
# and run:
Note: Make sure you've updated the changelog,
before cutting a new release.
Release to clojars by tagging a new release:
git tag -a v0.45.0 -m "Release 0.45.0"
git push --tags
The CI will take it from there.
Special credit goes to the following people for their contributions:
And a big thanks to
all other contributors
who have helped so far.
Let's also acknowledge some of the projects leveraged by cider-nrepl:
- orchard - extracted from
cider-nrepl, so that non-nREPL clients can leverage the generic tooling functionality (like
- compliment - for Clojure code completion
- clj-suitable - for ClojureScript code completion using runtime inspection
- tools.trace - for tracing
- tools.namespace - for namespace reloading
- cljfmt - for code formatting
Copyright © 2013-2024 Bozhidar Batsov
Distributed under the Eclipse Public License, the same as Clojure.
Can you improve this documentation? These fine people already did:
Bozhidar Batsov, vemv, Michael Griffiths, Andrea Richiardi, Artur Malabarba, Gary Trakhman, Jeff Valk, Laurent Petit, Benedek Fazekas, Akhil Wali, Hugo Duncan, Robert Krahn, liquidz, Dave Liepmann, Philip Jagielski, Toby Crawley, Dominic Monroe, Jon Pither, Neil Okamoto, Rory O’Kane, sanjayl, expez, Niklas Fasching, Tianxiang Xiong, Juan E. Maya, Alexander Yakushev, Tim Pope, Max Veytsman, Blake Miller & Juan MonettaEdit on GitHub