practicalli/clojure-deps-edn provides a user wide configuration for Clojure CLI tools, providing a range of community tools to support Clojure and ClojureScript development.
Alias names are designed with qualified keywords which provides context for the use of an alias (project
, repl
, env
, test
, inspect
). These keywords help with discovery and reduce cognitive load required to remember their purpose.
This configuration supports all your local development projects. For remote environments or Continuous Integration services, include practicalli/clojure-deps-edn in the environment build or copy specific aliases to the project deps.edn
configuration of a project.
Install
Clojure CLI tools uses a configuration directory called .clojure
, which by default is placed in the root of the operating system user account directory, e.g. $HOME/.clojure
.
XDG_CONFIG_HOME
may be set by your operating system and over-rides the default location, e.g. $HOME/.config/.clojure
CLJ_CONFIG
can be used to over-ride all other location settings
Check the location of your Clojure configuration directory by running
clojure -Sdescribe
and checking the:user-config
value.
Practicalli recommends creating a fork of the practicalli/clojure-deps-edn on GitHub, or you can simply clone the original repository.
Clone the repository to the configuration directory, e.g ~/.clojure/
. If you have run the clojure
or clj
commands, then a default deps.edn
file was created and should be moved or deleted first.
git clone git@github.com:your-fork/clojure-deps-edn.git ~/.clojure/
clojure and clj commands create a configuration directory
All tools are provided via libraries and are only installed on first use.
If you choose to use your own ~/.clojure/deps.edn
then add an alias for the clj-new tool and rebel readline as this is extensively used in this guide.