repl-kit

A minimal clojure editor with REPL integration

Motivation

This is not a replacment for great REPL editor tools such as cider and calva. Frequently I need to work in restricted environments where I cannot install those tools. I also need something that is self-contained and published to maven central, again due to restricted environments.

deps.edn maven coordinates

com.github.tstout/repl-kit {:mvn/version "1.0.12"}

Usage

Add this to your deps.edn aliases map:

:repl   {:extra-deps  {com.github.tstout/repl-kit  {:mvn/version "1.0.12"}
                       org.clojure/tools.namespace {:mvn/version "1.5.0"}}
         :extra-paths ["dev"]
         :main-opts   ["-m" "repl-kit.core"]}

The editor can then be started with

clojure -M:repl

Options:
  -p, --port PORT       5555       REPL port
  -s, --server SERVER   localhost  REPL server(host)
  -i, --install                    install clojure (future feature)
  -f, --font FONT-SIZE  12         font size
  -r, --remote                     connect to remote REPL server, don't start local server
  -h, --help                       show help

Publishing to Maven Central (Note to Self)

clojure -T:build uberjar
mvn package
mvn deploy

TODOs

• Update this to mention local vs remote repl and use of prepl, not nrepl
• flesh out ns utils and make them easily accessible