deps.edn

;; --------------------------------------------------
;; Practicalli Clojure CLI Configuration
;;
;; Aliases that extend the features of the Clojure CLI
;; using Community projects as tools and libraries
;; to enhanced the development workflow
;; --------------------------------------------------


;; --------------------------------------------------
;; Top-level keys for Clojure CLI deps.edn

;; Practicalli Clojure CLI Config only defines aliases

;; `:aliases` - tools to enhance a development workflow

;; Other top-level keys that could be used in a user or project `deps.edn` configuration:

;; `:mvn/repos` - Maven & Clojars repositories, examples of other repositories
;; `:mvn/local-repo` - set local repository path - defaults to $HOME/.m2/repository
;; `:paths` - directory paths to add to the class path
;; `:deps` - library dependencies to add to the class path

;; Keys used within :aliases

;; resolve-deps aliases affect dependency resolution:
;;   `:extra-deps` - libraries merged into the top-level :deps dependencies
;;   `:replace-deps` - libraries replacing all those in the top-level :deps dependencies
;;   `:override-deps` - library version overriding a matching library in the top-level :deps
;;   `:default-deps` - library version if no version is otherwide defined, used across a set of shared projects acting as a dependency management system

;; make-classpath aliases affect the classpath generation:
;;   `:extra-paths` - additional paths to those defined in the top-level :path key
;;   `:replace-paths` - paths replacing all those defined in the top-level :path key
;;   `:override-paths` - alternate location to resolve a dependancy (overrides resolve-deps location)

;; Configuration to run Clojure
;;   `:main-opts` - clojure.main configuration options (vector of strings), e.g. `["--main" "fully.qualified.namespace"]` to set main namespace
;;   `:exec-fn` - clojure.exec fully qualified function name to call (symbol)
;;   `:exec-args` - clojure.exec arguments (hash-map) passed to `:exec-fn`
;; ---------------------------------------------------

{;; ---------------------------------------------------
 ;; Alias definitions

 :aliases
 {;; ---------------------------------------------------
  ;; Development environment
  ;; Aliases work with Clojure CLI -M -X or -T execution options

  ;; Custom REPL startup
  ;; A `user` namespace is loaded during REPL startup if found on the class path
  ;; `dev/user.clj` defines a custom `user` namespace, requring libraries and
  ;; including code to start tools as the REPL starts
  ;; Development environment aliases include the `dev` directory on the class path
  ;; https://practical.li/clojure/clojure-cli/repl-startup/

  :dev/env
  {:extra-paths ["dev"]}

  ;; Practicalli REPL Reloaded workflow
  ;; https://practical.li/clojure/clojure-cli/repl-reloaded/
  ;; Use with command to start a REPL to include REPL Reloaded tools
  :dev/reloaded
  {:extra-paths ["dev" "test"]
   :extra-deps  {djblue/portal                {:mvn/version "0.49.1"}   ; portal data inspector
                 clj-commons/clj-yaml         {:mvn/version "1.0.27"}   ; portal yaml support (optional)
                 org.clojure/tools.namespace  {:mvn/version "1.4.4"}
                 org.clojure/tools.trace      {:mvn/version "0.7.11"}
                 org.slf4j/slf4j-nop          {:mvn/version "2.0.9"}
                 com.brunobonacci/mulog       {:mvn/version "0.9.0"}
                 lambdaisland/kaocha          {:mvn/version "1.87.1366"}
                 org.clojure/test.check       {:mvn/version "1.1.1"}
                 criterium/criterium          {:mvn/version "0.4.6"}}}

  ;; ClojureScript tools during REPl startup
  :dev/reloaded-cljs
  {:extra-paths ["dev" "test"]
   :extra-deps  {djblue/portal             {:mvn/version "0.49.1"}   ; portal data inspector
                 org.clojure/clojurescript {:mvn/version "1.10.844"}
                 lambdaisland/kaocha-cljs  {:mvn/version "1.5.154"}
                 org.clojure/test.check    {:mvn/version "1.1.1"}}}

  ;; DEPRECATED
  ;; - only useful for Clojure 1.11.x, not required for Clojure 1.12 onward
  ;; - alpha state software
  ;; Latest commit on add-lib3 branch, don't update with :search/outdated
  :lib/hotload
  {:extra-deps {org.clojure/tools.deps.alpha
                {:git/url "https://github.com/clojure/tools.deps.alpha"
                 :git/sha "e4fb92eef724fa39e29b39cc2b1a850567d490dd"}}}

  ;; Highlight important aspects of error stack trace using ANSI formatting
  ;; https://github.com/AvisoNovate/pretty
  :lib/pretty-errors
  {:extra-deps {io.aviso/pretty {:mvn/version "1.4.4"}}}

  ;; Component REPL libraries
  :lib/integrant-repl
  {:extra-deps {integrant/repl {:mvn/version "0.3.3"}}}

  :lib/component-repl
  {:extra-deps {com.stuartsierra/component.repl {:mvn/version "1.0.0"}}}

  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Running a REPL

  ;; Basic REPL UI with nREPL server for Clojure Editor support
  :repl/basic
  {:extra-deps {nrepl/nrepl       {:mvn/version "1.1.0"}
                cider/cider-nrepl {:mvn/version "0.44.0"}}
   :main-opts  ["--main" "nrepl.cmdline"
                "--middleware" "[cider.nrepl/cider-middleware]"
                "--interactive"]}

  ;; Headless REPL with nREPL server for Clojure Editor support
  :repl/headless
  {:extra-deps {nrepl/nrepl       {:mvn/version "1.1.0"}
                cider/cider-nrepl {:mvn/version "0.44.0"}}
   :main-opts  ["--main" "nrepl.cmdline"
                "--middleware" "[cider.nrepl/cider-middleware]"]}

  ;; Basic REPL UI, nREPL server and Portal data inspector
  :repl/inspect
  {:extra-deps
   {nrepl/nrepl       {:mvn/version "1.1.0"}
    cider/cider-nrepl {:mvn/version "0.44.0"}
    djblue/portal     {:mvn/version "0.49.1"}}
   :main-opts ["--main" "nrepl.cmdline"
               "--middleware"
               "[cider.nrepl/cider-middleware,portal.nrepl/wrap-portal]"]}

  ;; Start REPL with Clerk notebook receiving evaluation results as a tap> source
  ;; Recommend using custom `user` namespace to start Clerk as tap> source
  ;; Alpha stage alias design - may change
  ;; clojure -M:repl/clerk
  :repl/clerk
  {:extra-deps {io.github.nextjournal/clerk   {:mvn/version "0.15.957"}
                nrepl/nrepl                   {:mvn/version "1.1.0"}
                cider/cider-nrepl             {:mvn/version "0.44.0"}
                refactor-nrepl/refactor-nrepl {:mvn/version "3.9.0"}}
   :main-opts  ["--eval" "(require '[nextjournal.clerk])(nextjournal.clerk/show! 'nextjournal.clerk.tap)(nextjournal.clerk/serve! {:browse? true})"
                "-m" "nrepl.cmdline"
                "--middleware" "[refactor-nrepl.middleware/wrap-refactor,cider.nrepl/cider-middleware]"
                "--interactive"]}

  ;; Rebel Readline enhanced REPL UI
  ;; https://github.com/bhauman/rebel-readline
  ;; REPL UI with syntax highlighting, built in docs and a quit command `:repl/quit`

  ;; Clojure REPL with rebel readline with nrepl for editor connection
  ;; Conjure: opening a Clojure file will automatically connect to the REPL process
  ;; CIDER: run `cider-connect-clj` and select REPL host and port
  ;; Calva: connect to REPL command and select build tool, REPL host and port

  ;; clojure -M:repl/rebel
  :repl/rebel
  {:extra-deps {nrepl/nrepl                {:mvn/version "1.1.0"}
                cider/cider-nrepl          {:mvn/version "0.44.0"}
                com.bhauman/rebel-readline {:mvn/version "0.1.4"}}
   :main-opts  ["--eval" "(apply require clojure.main/repl-requires)"
                "--main" "nrepl.cmdline"
                "--middleware" "[cider.nrepl/cider-middleware]"
                "--interactive"
                "-f" "rebel-readline.main/-main"]}

  ;; Practicalli REPL Reloaded workflow
  ;; https://practical.li/clojure/clojure-cli/repl-reloaded/
  ;; clojure -M:repl/rebel
  :repl/reloaded
  {:extra-paths ["dev" "test"]
   :extra-deps {nrepl/nrepl                  {:mvn/version "1.1.0"}
                cider/cider-nrepl            {:mvn/version "0.44.0"}
                com.bhauman/rebel-readline   {:mvn/version "0.1.4"}
                djblue/portal                {:mvn/version "0.49.1"}   ; portal data inspector
                clj-commons/clj-yaml         {:mvn/version "1.0.27"}   ; portal yaml support (optional)
                org.clojure/tools.namespace  {:mvn/version "1.4.4"}
                org.clojure/tools.trace      {:mvn/version "0.7.11"}
                org.slf4j/slf4j-nop          {:mvn/version "2.0.9"}
                com.brunobonacci/mulog       {:mvn/version "0.9.0"}
                lambdaisland/kaocha          {:mvn/version "1.87.1366"}
                org.clojure/test.check       {:mvn/version "1.1.1"}
                ring/ring-mock               {:mvn/version "0.4.0"}
                criterium/criterium          {:mvn/version "0.4.6"}}
   :main-opts  ["--eval" "(apply require clojure.main/repl-requires)"
                "--main" "nrepl.cmdline"
                "--middleware" "[cider.nrepl/cider-middleware,portal.nrepl/wrap-portal]"
                "--interactive"
                "-f" "rebel-readline.main/-main"]}

  ;; Include Rebel Readline library
  :lib/rebel
  {:extra-deps {com.bhauman/rebel-readline {:mvn/version "0.1.4"}}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Remote REPL connection

  ;; Connect to the nREPL server of a remote REPL
  ;; clojure -M:repl/remote --host hostname --port 12345
  ;; replace --host and --port values with that of remote nREPL server
  :repl/remote
  {:extra-deps {nrepl/nrepl {:mvn/version "1.1.0"}}
   :main-opts ["--main" "nrepl.cmdline" "--connect"]}

  ;; clojure -M:repl/rebel-remote --host hostname --port 12345
  :repl/rebel-remote
  {:extra-deps {nrepl/nrepl                {:mvn/version "1.1.0"}
                cider/cider-nrepl          {:mvn/version "0.44.0"}
                com.bhauman/rebel-readline {:mvn/version "0.1.4"}}
   :main-opts  ["--eval" "(apply require clojure.main/repl-requires)"
                "--main" "nrepl.cmdline"
                "--connect"
                "--middleware" "[cider.nrepl/cider-middleware]"
                "--interactive"
                "-f" "rebel-readline.main/-main"]}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Creating projects from templates
  ;; clj-new can use a wide range of Leiningen style templates
  ;; deps-new creates Clojure CLI projects
  ;; - deps-new is used by Practicalli Project Templates
  ;; https://practical.li/clojure/clojure-cli/projects/templates/practicalli/

  :project/new
  {:replace-deps {com.github.seancorfield/clj-new {:mvn/version "1.2.404"}}
   :exec-fn      clj-new/create
   :exec-args    {:template app :name practicalli/playground}
   :main-opts    ["--main" "clj-new.create"]}

  ;; deps-new and Practicalli Project Teamplates
  ;; clojure -T:project/create :template template/name :name project/name
  :project/create
  {:replace-deps {io.github.seancorfield/deps-new
                  {:git/tag "v0.5.3" :git/sha "c899135"}
                  io.github.practicalli/project-templates
                  {:git/tag "2023-11-03" :git/sha "684d2f6"}}
   :exec-fn      org.corfield.new/create
   :exec-args    {:template practicalli/minimal
                  :name practicalli/playground}}

  ;; Local testing of Practicalli Project Templates
  :project/create-local
  {:replace-deps {io.github.seancorfield/deps-new
                  {:git/tag "v0.5.3" :git/sha "c899135"}
                  practicalli/project-templates
                  {:local/root "/home/practicalli/projects/practicalli/project-templates/"}}
   :exec-fn      org.corfield.new/create
   :exec-args    {:template practicalli/minimal
                  :name practicalli/playground}}

  :project/templates
  {:extra-deps {io.github.practicalli/project-templates
                {:git/tag "2023-11-03" :git/sha "684d2f6"}}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Searching

  ;; clj-check - search each namespace and report compilation warnings and errors
  ;; https://github.com/athos/clj-check
  ;; clojure -M:search/errors
  :search/errors
  {:extra-deps {athos/clj-check
                {:git/url "https://github.com/athos/clj-check.git"
                 :sha     "518d5a1cbfcd7c952f548e6dbfcb9a4a5faf9062"}}
   :main-opts  ["--main" "clj-check.check"]}

  ;; find-deps - fuzzy search Maven & Clojars and add deps to deps.edn
  ;; https://github.com/hagmonk/find-deps
  ;; clojure -M:search/libraries http-kit  # fuzzy search for dependency
  ;; clojure -M:search/libraries http-kit ring compojure # multiple deps
  ;; clojure -M:search/libraries --format:save http-kit #  save into deps.edn file
  ;; :search/libraries
  ;; {:extra-deps
  ;;  {find-deps/find-deps
  ;;   {:git/url "https://github.com/hagmonk/find-deps"
  ;;    :sha     "9bf23a52cb0a8190c9c2c7ad1d796da802f8ce7a"}}
  ;;  :main-opts ["--main" "find-deps.core"]}

  :search/libraries
  {:extra-deps
   {practicalli/clj-find-libraries
    {:git/url "https://github.com/practicalli-johnny/clj-find-library"
     :sha     "a814519ed9921fcad4515e0e4446dc34af783d28"}}
   :main-opts ["--main" "find-deps.core"]}

  :search/libraries-local
  {:extra-deps
   {practicalli/clj-find-libraries
    {:local/root "/home/practicalli/projects/practicalli/clj-find-library/"}}
   :main-opts ["--main" "find-deps.core"]}

  ;; Dependency version management
  ;; https://github.com/liquidz/antq
  ;; Manage versions for maven and git dependencies

  ;; - report project dependencies that have newer versions available:
  ;; cd project-directory && clojure -T:search/outdated
  ;; - update library versions in this deps.edn file:
  ;; cd $XDG_CONFIG_HOME/clojure && clojure -T:search/outdated
  :search/outdated
  {:replace-paths ["."]
   :replace-deps  {com.github.liquidz/antq {:mvn/version "2.7.1133"}
                   org.slf4j/slf4j-nop     {:mvn/version "2.0.9"}}
   :exec-fn antq.tool/outdated
   :exec-args {:directory ["."] ; default
               :exclude ["org.clojure/tools.deps.alpha"
                         "org.clojure/clojurescript"]
               ;; :focus ["com.github.liquidz/antq"]
               :skip ["boot" "leiningen"]
               :reporter "table" ; json edn format
               :verbose false
               :upgrade false
               :force   false}}

  ;; Carve - search through code for unused vars and remove them
  ;; clojure -M:search/unused-vars --opts '{:paths ["src" "test"]}'
  :search/unused-vars
  {:extra-deps {borkdude/carve
                {:git/url "https://github.com/borkdude/carve"
                 :sha     "cb621317ae1582869c8bd8f1a47cf57a3598d803"}}
   :main-opts  ["--main" "carve.main"]}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Project Packaging
  ;; - use Clojure CLI tools.build approach
  ;; https://practical.li/clojure/clojure-cli/projects/tools-build/
  ;; https://clojure.org/guides/tools_build
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Project Deployment

  ;; Clojure CLI built-in alias to deploy locally (e.g. `~/.m2/`)
  ;; clojure -X:deps mvn-install

  ;; https://github.com/slipset/deps-deploy  - Deploy libraries to Clojars
  ;; Set Clojars username/token in `CLOJARS_USERNAME` and `CLOJARS_PASSWORD` environment variables.
  ;; Requires: fully qualified artifact-name and version in project `pom.xml` file

  ;; Deploy to Clojars
  ;; `clojure -T:deploy/clojars :artifact '"project.jar"'`
  :deploy/clojars
  {:replace-deps {slipset/deps-deploy {:mvn/version "0.2.2"}}
   :exec-fn deps-deploy.deps-deploy/deploy
   :exec-args {:installer :remote
               :sign-releases? true
               :artifact "deps-deploy.jar"}}

  ;; AWS S3 Example deploy
  ;; :deploy/aws-s3
  ;; {:replace-deps {slipset/deps-deploy {:mvn/version "0.2.2"}}
  ;;  :exec-fn deps-deploy.deps-deploy/deploy
  ;;  :exec-args {:installer :remote
  ;;              :artifact "deps-deploy.jar"
  ;;              :repository {"releases" {:url "s3p://my/bucket/"}}}}

  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Java Sources

  ;; Look up Java Class and method definitions, eg. `cider-find-var` in Emacs
  ;; Requires: Java sources installed locally e.g. sudo apt install openjdk-17-source
  ;; Examples are from Ubuntu package install locations

  ;; clojure -M:lib/java17-source
  :src/java17
  {:extra-deps
   {openjdk/java-sources {:local/root "/usr/lib/jvm/openjdk-17/lib/src.zip"}}}

  ;; Clojure core Java source code in src/jvm/clojure/lang/
  :src/clojure
  {:extra-paths ["src/jvm"]
   :extra-deps
   {org.clojure/clojure-source {:local/root "/home/practicalli/projects/community/clojure.org/clojure"}}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Formatting tools

  ;; pretty printing with sorted keys and set values
  ;; include as a library when starting a project
  :lib/pprint-sorted
  {:extra-deps {mvxcvi/puget {:mvn/version "1.3.4"}}}

  ;; ----------
  ;; zprint: advanced format tool for Clojure code and EDN

  ;; Report indentation format issues
  ;; clojure -M:format/zprint filename-or-pattern
  :format/zprint
  {:extra-deps {zprint/zprint {:mvn/version "1.2.8"}}
   :main-opts  ["--main" "zprint.main"
                "{:style :indent-only}"
                "--list-formatted-summary-check"]}

  ;; Fix indentation format issues
  ;; clojure -M:format/zprint!
  :format/zprint!
  {:extra-deps {zprint/zprint {:mvn/version "1.2.8"}}
   :main-opts  ["--main" "zprint.main"
                "{:style :indent-only}"
                "--list-formatted-summary-write"]}

  ;; Report issues using community style guide
  ;; clojure -M:format/community filename-or-pattern
  :format/community
  {:extra-deps {zprint/zprint {:mvn/version "1.2.8"}}
   :main-opts  ["--main" "zprint.main"
                "{:style :community}"
                "--list-formatted-summary-check"]}

  ;; Fix issues using community style guide
  ;; clojure -M:format/community filename-or-pattern
  :format/community!
  {:extra-deps {zprint/zprint {:mvn/version "1.2.8"}}
   :main-opts  ["--main" "zprint.main"
                "{:style :community}"
                "--list-formatted-summary-write"]}

  ;; ----------
  ;; Cljstyle is a rewrite of cljfmt, designed to be easier to configure

  ;; Report format issues for current project code
  ;; clojure -M:format/cljstyle
  :format/cljstyle
  {:extra-deps
   {mvxcvi/cljstyle {:git/url "https://github.com/greglook/cljstyle.git"
                     :git/sha "14c18e5b593c39bc59f10df1b894c31a0020dc49"}}
   :main-opts ["--main" "cljstyle.main"
               "check"]}

  ;; Fix format issues for current project code
  ;; clojure -M:format/cljstyle
  :format/cljstyle!
  {:extra-deps
   {mvxcvi/cljstyle {:git/url "https://github.com/greglook/cljstyle.git"
                     :git/sha "14c18e5b593c39bc59f10df1b894c31a0020dc49"}}
   :main-opts ["--main" "cljstyle.main"
               "fix"]}

  ;; ----------
  ;; cljfmt
  ;; clojure -M:format/cljfmt check | fix
  :format/cljfmt
  {:extra-deps {cljfmt/cljfmt {:mvn/version "0.9.2"}}
   :main-opts ["--main" "cljfmt.main" "check"]}

  :format/cljfmt!
  {:extra-deps {cljfmt/cljfmt {:mvn/version "0.9.2"}}
   :main-opts ["--main" "cljfmt.main" "fix"]}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Databases and drivers uses only during development

  :lib/next.jdbc
  {:extra-deps {com.github.seancorfield/next.jdbc {:mvn/version "1.3.894"}}}

  ;; H2 embedded database
  :database/h2
  {:extra-deps
   {com.h2database/h2                 {:mvn/version "2.2.224"}
    com.github.seancorfield/next.jdbc {:mvn/version "1.3.894"}}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Data Science

  ;; Notebooks for Clojure
  ;; https://github.com/nextjournal/clerk
  ;; Alias can be used as an optional library for projects or REPL workflow
  :lib/clerk
  {:extra-deps {io.github.nextjournal/clerk {:mvn/version "0.15.957"}}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Data inspectors / visualizers

  ;; Portal
  ;; Navigate data - edn, json, transit
  ;; https://github.com/djblue/portal

  :inspect/portal-cli
  {:extra-deps {djblue/portal {:mvn/version "0.49.1"}}}

  :inspect/portal-web
  {:extra-deps {djblue/portal             {:mvn/version "0.49.1"}
                org.clojure/clojurescript {:mvn/version "1.11.60"}}
   :main-opts  ["--main" "cljs.main"]}

  :inspect/portal-node
  {:extra-deps {djblue/portal             {:mvn/version "0.49.1"}
                org.clojure/clojurescript {:mvn/version "1.11.60"}}
   :main-opts  ["--main" "cljs.main" "-re" "node"]}

  ;; Morse - https://github.com/nubank/morse
  :inspect/morse
  {:extra-deps {io.github.nubank/morse
                {:git/tag "v2023.10.06.02" :git/sha "88b5ff7"}}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Debug Tools

  ;; Flowstorm, a tracing debugger
  ;; https://github.com/jpmonettas/flow-storm-debugger
  :lib/flowstorm
  {:extra-deps {com.github.jpmonettas/flow-storm-dbg {:mvn/version "3.7.5"}}}

  ;; End of Debug Tools
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Clojure Specifications

  ;; Clojure spec test.check (clojure spec included in Clojure 1.9 onwards)
  :lib/spec-test
  {:extra-deps
   {org.clojure/test.check {:mvn/version "1.1.1"}}}

  ;; Clojure spec 2 - under active development
  ;; https://github.com/clojure/spec-alpha2
  ;; latest commit SHA is returned by the command
  ;; git ls-remote https://github.com/clojure/spec-alpha2.git refs/heads/master
  :lib/spec2
  {:extra-deps {org.clojure/spec-alpha2
                {:git/url "https://github.com/clojure/spec-alpha2"
                 :sha     "4cbfa677c4cd66339f18e1c122222c05c69e0d8e"}}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Testing Environment / Libraries

  ;; Include the test directory on the class path
  :test/env
  {:extra-paths ["test"]
   :extra-deps  {org.clojure/test.check {:mvn/version "1.1.1"}}}

  :lib/ring-mock
  {:extra-deps {ring/ring-mock {:mvn/version "0.4.0"}}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Test runners

  ;; Cognitect test-runner
  ;; https://github.com/cognitect-labs/test-runner
  ;; clojure -X:test/cognitect
  :test/cognitect
  {:extra-paths ["test"]
   :extra-deps  {io.github.cognitect-labs/test-runner
                 {:git/tag "v0.5.1" :git/sha "dfb30dd"}}
   :main-opts   ["--main" "cognitect.test-runner"]
   :exec-fn cognitect.test-runner.api/test}

  ;; kaocha - comprehensive test runner for Clojure/Script
  ;; tests.edn should be created for each project
  ;; https://github.com/lambdaisland/kaocha

  ;; Default test runner using kaocha (change to your own preference)
  ;; clojure -X:test/run
  ;; - `:fail-fast? false` argument to run all tests
  :test/run
  {:extra-paths ["test"]
   :extra-deps {lambdaisland/kaocha {:mvn/version "1.87.1366"}}
   :main-opts   ["--main" "kaocha.runner"]
   :exec-fn kaocha.runner/exec-fn
   :exec-args {:randomize? false
               :fail-fast? true}}

  :test/run-all
  {:extra-paths ["test"]
   :extra-deps {lambdaisland/kaocha {:mvn/version "1.87.1366"}}
   :main-opts   ["--main" "kaocha.runner"]
   :exec-fn kaocha.runner/exec-fn
   :exec-args {:randomize? false
               :fail-fast? false}}

  ;; Kaocha test runner in watch mode
  ;; clojure -X:test/watch
  ;; - `:fail-fast? false` argument to run all tests
  :test/watch
  {:extra-paths ["test"]
   :extra-deps {lambdaisland/kaocha {:mvn/version "1.87.1366"}}
   :main-opts   ["--main" "kaocha.runner" "--watch" "--fail-fast" "--skip-meta" ":slow"]
   :exec-fn kaocha.runner/exec-fn
   :exec-args {:watch? true
               :randomize? false
               :fail-fast? true}}

  :test/cljs
  {:extra-paths ["test"]
   :extra-deps  {lambdaisland/kaocha      {:mvn/version "1.87.1366"}
                 lambdaisland/kaocha-cljs {:mvn/version "1.5.154"}}
   :main-opts   ["--main" "kaocha.runner" "unit-cljs"]}

  ;; https://github.com/lambdaisland/kaocha-cucumbe
  ;; - used for kaocha-runner.el to run Kaocha test runner in Emacs Cider
  :lib/kaocha
  {:extra-deps {lambdaisland/kaocha {:mvn/version "1.87.1366"}}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Test Coverage tools

  ;; Cloverage - Simple clojure coverage tool
  ;; https://github.com/cloverage/cloverage
  ;; In the root of your Clojure project, run the command:
  ;; clojure -M:test/coverage
  ;; clojure -X:test/coverage
  :test/coverage
  {:extra-paths ["test"]
   :extra-deps  {cloverage/cloverage {:mvn/version "1.2.4"}}
   :main-opts   ["--main" "cloverage.coverage"
                 "--src-ns-path" "src"
                 "--test-ns-path" "test"]
   :exec-fn     cloverage.coverage/run-project
   :exec-args   {:src-ns-path  ["src"]
                 :test-ns-path ["test"]}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Visualizing dependencies

  ;; Morpheus - visualize project var relationships
  ;; https://github.com/benedekfazekas/morpheus
  ;; Options:
  ;; -d to specify output directory (this must exist)
  ;; -f to specify image format, dot (default), png or svg
  ;; Options are followed by list of paths to analyze.

  ;; clojure -M:graph/vars -d graphs -f png src test
  :graph/vars
  {:extra-deps {thomasa/morpheus
                {:git/url "https://github.com/benedekfazekas/morpheus.git"
                 :sha     "9d6f2c1ede8be7ab4508065fe6b7e40e0c099ab6"}}
   :main-opts  ["--main" "thomasa.morpheus.main"]}

  ;; Generate PNG image of dependency graph in directory called `graphs`
  ;; clojure -M:graph/vars-png
  :graph/vars-png
  {:extra-deps {thomasa/morpheus
                {:git/url "https://github.com/benedekfazekas/morpheus.git"
                 :sha     "9d6f2c1ede8be7ab4508065fe6b7e40e0c099ab6"}}
   :main-opts  ["--main" "thomasa.morpheus.main"
                "-d" "graphs" "-f" "png" "src" "test"]}

  ;; Generate SVG image of dependency graph in directory called `graphs`
  ;; clojure -M:graph/vars-svg
  :graph/vars-svg
  {:extra-deps {thomasa/morpheus
                {:git/url "https://github.com/benedekfazekas/morpheus.git"
                 :sha     "9d6f2c1ede8be7ab4508065fe6b7e40e0c099ab6"}}
   :main-opts  ["--main" "thomasa.morpheus.main"
                "-d"  "graphs" "-f" "svg" "src" "test"]}

  ;; Visualize connections between library dependencies and project namespaces
  ;; https://github.com/SevereOverfl0w/vizns
  ;; clojure -M:graph/ns-deps
  :graph/ns-deps
  {:extra-deps {io.dominic/vizns {:git/url "https://github.com/SevereOverfl0w/vizns.git"
                                  :sha     "34706190d41cb243f6270fe5a7324601a8404d30"}}
   :main-opts  ["--main" "io.dominic.vizns.core"]}

  ;; Generate single PNG image of library dependencies
  :graph/ns-deps-png
  {:extra-deps {io.dominic/vizns {:git/url "https://github.com/SevereOverfl0w/vizns.git"
                                  :sha     "34706190d41cb243f6270fe5a7324601a8404d30"}}
   :main-opts  ["--main" "io.dominic.vizns.core" "single" "-o" "deps-graph.png" "-f" "png"]}

  ;; GraphViz of project dependencies
  ;; https://github.com/clojure/tools.deps.graph
  ;; clojure -T:graph/deps
  :graph/deps
  {:replace-paths []
   :replace-deps  {org.clojure/tools.deps.graph {:mvn/version "1.1.84"}}
   :ns-default    clojure.tools.deps.graph
   :exec-fn       graph
   :exec-args     {:output "project-dependencies-graph.png"
                   :size   true}}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Performance testing

  ;; Benchmarking library for Clojure
  ;; https://github.com/hugoduncan/criterium/
  ;; (require '[criterium.core :refer [bench quick-bench]]) ; require criterium
  ;; (bench (adhoc-expression)) ; timing of a self contained expression
  ;;
  ;; (require '[practicalli/namespace-name]) ; require project source code
  ;; (in-ns 'practicalli/namespace-name)
  ;; (quick-bench (project-function args))
  :performance/benchmark
  {:extra-deps {criterium/criterium {:mvn/version "0.4.6"}}}

  ;; clj-memory-meter
  ;; - see https://github.com/clojure-goes-fast/clj-memory-meter
  ;; - (require '[clj-memory-meter.core :as memory-meter])
  ;; - (memory-meter/measure (your-expression))
  :performance/memory-meter
  {:extra-deps {com.clojure-goes-fast/clj-memory-meter {:mvn/version "0.3.0"}}
   :jvm-opts   ["-Djdk.attach.allowAttachSelf"]}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Zulip Event announcement
  :community/zulip-event
  {:replace-paths []
   :replace-deps  {clojurians-zulip/feeds
                   {:git/url "https://gitlab.com/clojurians-zulip/feeds.git"
                    :sha     "4bf8109afc5cd5ab2f409151d4dd583644028b4a"}}
   :main-opts     ["--main" "inclined.main"
                   "--ns" "clojurians-zulip.events" "--"]}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Services

  ;; https://github.com/kachayev/nasus
  ;; simple zero-configuration command-line HTTP files server
  :service/webserver
  {:replace-deps {nasus/nasus {:mvn/version "0.1.7"}}
   :main-opts    ["--main" "http.server"]}

  ;; alternative name for webserver alias
  :service/http
  {:replace-deps {nasus/nasus {:mvn/version "0.1.7"}}
   :main-opts    ["--main" "http.server"]}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; Socket REPL

  ;; Clojure Socket REPL on port 55555:
  ;; clojure -X:repl/socket
  :repl/socket
  {:exec-fn clojure.core.server/start-server
   :exec-args {:name "socket-repl-server"
               :port 55555
               :accept clojure.core.server/repl
               :server-daemon false}}

  ;; tubular - socket repl client
  ;; https://github.com/mfikes/tubular
  ;; Connect to a socket repl, e.g. :repl/socket
  ;; clojure -M:repl/socket-client
  :repl/socket-client
  {:extra-deps {tubular/tubular {:mvn/version "1.4.0"}}
   :main-opts  ["--main" "tubular.core"
                "-p" "55555"]}
  ;; ---------------------------------------------------

  ;; ---------------------------------------------------
  ;; My Personal Aliases (Tyler Wardhaugh)
  :nrepl/nrepl {:extra-deps {nrepl/nrepl {:mvn/version "0.9.0-beta1"}}}

  :depify {:extra-deps {depify/depify {:git/url "https://github.com/hagmonk/depify"
                                       :sha     "b3f61517c860518c1990133aa6eb54caf1e4d591"}}
           :main-opts  ["-m" "depify.project"]}
  :try {:extra-deps {deps-try/deps-try
                         {:git/url "https://gitlab.com/eval/deps-try",
                          :sha "f3989ab8ccb11f3aa00cb6bb251bab8dd44449d9"}}
        :main-opts ["-m" "deps-try.main"]}
  :depsviz {:extra-deps {cnuernber/depsviz {:mvn/version "0.10"}}
            :main-opts ["-m" "cnuernber.depsviz"]}
  :hashp {:extra-deps {hashp/hashp {:mvn/version "0.2.1"}}
          :main-opts ["-e" "(do (in-ns,'user)(use,'[hashp.core]))"]}
  :cljdev {:extra-deps {cljdev/cljdev {:git/url "https://github.com/justone/cljdev.git"
                                :sha "dc9171f9f091e476a734714d128704876c7fa679"}}
           :main-opts  ["-m" "cljdev.repl"]
           :exec-fn cljdev.repl/start}
  :deps-infer {:extra-deps {borkdude/deps-infer {:git/url "https://github.com/borkdude/deps-infer"
                                                 :sha "a5b6d8db0189abb98302fba7ee6f32de14ce6a9c"}}
               :main-opts  ["-m" "deps-infer.main"]}

  ;; specific versions of Clojure
  ; See:
  ;   https://search.maven.org/artifact/org.clojure/clojure
  ;   https://mvnrepository.com/artifact/org.clojure/clojure
  :1.11 {:override-deps {org.clojure/clojure {:mvn/version "1.11.1"}}}

  ;; development
  ; scratch/quick experiments: see https://www.karimarttila.fi/clojure/2020/10/26/clojure-power-tools-part-1.html
  :scratch {:extra-paths ["scratch"]
            :extra-deps {hashp/hashp {:mvn/version "0.2.1"}
                         com.gfredericks/debug-repl {:mvn/version "0.0.12"}}}

  ;; [From Sean Corfield's dot-clojure repo::
  ; REPL-related tools:
  ; - start repl with Portal and a socket REPL:
  ;     clj -M:inspect/portal-cli:sc/dev
  :sc/dev {:main-opts ["-e" "(load-file,(str,(System/getProperty,\"user.home\"),\"/.clojure/dev.clj\"))"]}

  ;; https://github.com/camsaul/whitespace-linter
  ; usage: clj -T:whitespace-linter lint
  :whitespace-linter {:deps {com.github.camsaul/whitespace-linter
                             {:sha "b25716745f5875194bc38364e498d0ddda51f4b0"}}
                      :ns-default whitespace-linter}

  ;; https://github.com/babashka/neil
  :neil {:deps {io.github.babashka/neil {:git/tag "v0.0.31"
                                       :git/sha "61e9d2f"}}
         :main-opts ["-m" "babashka.neil"]}

  ;; End of My Personal Aliases (Tyler Wardhaugh)
  ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

  ;; Format tool friendly way to highlight end of configuration sections
  :end/aliases {}}
 :end/config {}}