development.md

Local Development

vault-clj uses Clojure's CLI tooling, deps.edn, and tools.build for development.

Server

To run a local development Vault server, use the bin script:

bin/server

This starts Vault with a fixed root token. You can source the dev/env.sh script to set the relevant connection variables for using the vault CLI locally.

REPL

To start a basic REPL, use the bin script:

bin/repl

Run Tests

To test-compile the code and find any reflection warnings:

bin/test check

Tests are run with kaocha via a bin script:

# run tests once
bin/test unit

# watch and rerun tests
bin/test unit --watch

# run integration tests
bin/test integration

To compute test coverage with cloverage:

bin/test coverage

Build Jar

For compiling code and building a JAR file, dialog uses tools.build. The various commands can be found in the build.clj file and invoked with the -T:build alias or the bin script:

# clean artifacts
bin/build clean

# generate a namespace graph
bin/build hiera

# create a jar
bin/build jar

# install to local repo
bin/build install

# prepare the next release
bin/build prep-release

# deploy to Clojars
bin/build deploy