REPL+CLI support

.github/workflows/build.yml

@@ -0,0 +1,41 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+
+jobs:
+  test:
+    strategy:
+      matrix:
+        jdk: ['8', '11', '17']
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Cache local Maven repository
+        uses: actions/cache@v2
+        with:
+          path: |
+            ~/.m2/repository
+            ~/.gitlibs
+          key: ${{ runner.os }}-maven-${{ hashFiles('deps.edn') }}
+          restore-keys: |
+            ${{ runner.os }}-maven-
+
+      - name: Prepare java
+        uses: actions/setup-java@v2
+        with:
+          distribution: 'temurin'
+          java-version: ${{ matrix.jdk }}
+
+      - name: Install clojure tools
+        uses: DeLaGuardo/[email protected]
+        with:
+          cli: latest
+          lein: latest
+          boot: latest
+      - name: Clojure CLI tests
+        run: clojure -X:test

.gitignore

@@ -10,3 +10,6 @@ pom.xml.asc
 .hgignore
 .hg/
 .nrepl-history
+.cpcache
+test-projects/*/target
+.lein-failures

README.md

@@ -63,6 +63,90 @@ See `boot bat-test -h` for a list of available task options.
 
 See `lein bat-test help` for a list of available task options.
 
+## Clojure CLI Usage
+
+### Main style
+
+### Exec style
+
+Add the following alias to your deps.edn:
+
+```clojure
+{:aliases {:test {:extra-deps {metosin/bat-test {...}}
+                  :extra-paths ["test"]
+                  :exec-fn metosin.bat-test.cli/exec
+                  :exec-args {:test-dirs ["test"]}}}}
+```
+
+Invoke with exec (`-X`), and see `metosin.bat-test.cli/{test,exec,run-tests}` for options. Here are some examples:
+
+```sh
+# run all tests once
+clojure -X:test
+
+# continuously run tests
+clojure -X:test :watch true
+
+# run tests in parallel
+clojure -X:test :parallel true
+
+# just test files under particular directories (handy for monorepos)
+clojure -X:test :test-dirs '["module1" "module3"]'
+
+# use Leiningen-style test selectors (see next section for custom selectors)
+clojure -X:test :selectors '[:all]' # <- lein test :all
+clojure -X:test :selectors '[my-ns :only other-ns/foo]' # <- lein test my-ns :only other-ns/foo
+```
+
+### Handy default arguments
+
+Use `:exec-args` for default values. Especially useful for Leiningen-style test selectors:
+
+eg.,
+
+```clojure
+; selectors.clj
+{:default (clojure.core/complement (clojure.core/some-fn :integration :disabled))
+ :integration :integration
+ :all (clojure.core/complement :disabled)}
+```
+
+```clojure
+; deps.edn
+{:aliases {:test {:extra-deps {metosin/bat-test {...}}
+                  :extra-paths ["test"]
+                  :exec-fn metosin.bat-test.cli/exec
+                  :exec-args {:test-dirs ["test"]
+                              ;; add this line
+                              :test-selectors-form-file "selectors.clj"}}}}
+```
+
+You can share this file with Leiningen like so:
+
+```clojure
+; project.clj
+(defproject ...
+  :test-selectors ~(-> "selectors.clj" slurp read-string))
+```
+
+## REPL Usage
+
+Almost identical to Clojure CLI usage (above), except use `metosin.bat-test.cli/test`.
+
+The major difference is that `test` throws exceptions, whereas `metosin.bat-test.cli/exec` uses `System/exit` (you don't
+want this at the REPL).
+
+You may want to create your own wrapper to provide some default arguments:
+
+```clojure
+(ns my-repl-ns
+  (:refer-clojure :exclude [test])
+  (:require [metosin.bat-test.cli :as bat-test]))
+
+(defn test [args]
+  (bat-test/test (into {:test-selectors-form-file "selectors.clj"} args)))
+```
+
 ## License
 
 Copyright © 2016-2019 [Metosin Oy](http://www.metosin.fi)

build.boot

@@ -1,4 +1,4 @@
-(def +version+ "0.4.4")
+(def +version+ (slurp "version"))
 
 (set-env!
   :resource-paths #{"src"}

build.clj

@@ -0,0 +1,56 @@
+(ns build
+  (:refer-clojure :exclude [compile])
+  (:require [clojure.tools.build.api :as b]
+            [clojure.java.io :as io]
+            [clojure.string :as str]))
+
+(def lib 'metosin/bat-test)
+(def +version+ (format "%s.%s" (slurp "version") (b/git-count-revs nil)))
+(def class-dir "target/classes")
+(def basis (b/create-basis {:project "deps.edn"}))
+(def jar-file (format "target/%s-%s.jar" (name lib) +version+))
+
+(defn write-version-file [d nsym]
+  (let [f (io/file d (-> (name nsym)
+                         (str/replace #"\." "/")
+                         (str/replace #"-" "_")
+                         (str ".clj")))]
+    (io/make-parents f)
+    (spit f (format "(ns %s)\n\n(def +version+ \"%s\")" (name nsym) +version+))))
+
+;; operations
+
+(defn clean [_]
+  (b/delete {:path "target"}))
+
+(defn compile [_]
+  (write-version-file class-dir 'metosin.bat-test.version))
+
+(defn jar [_]
+  (b/write-pom {:class-dir class-dir
+                :lib lib
+                :version +version+
+                :basis basis
+                :src-dirs ["src"]})
+  (b/copy-dir {:src-dirs ["src" "resources"]
+               :target-dir class-dir})
+  (compile {})
+  (b/jar {:class-dir class-dir
+          :jar-file jar-file}))
+
+;; clojure -T:build version
+(defn version [_] (print +version+))
+
+;; clojure -T:build install
+(defn install
+  "Prints the version that was installed."
+  [_]
+  (clean {})
+  (jar {})
+  (b/install {:basis basis
+              :lib lib
+              :version +version+
+              :class-dir class-dir
+              :jar-file jar-file})
+  ;; test-projects expect version to be printed
+  (version {}))

deps.edn

@@ -0,0 +1,25 @@
+{:paths ["src"]
+ :deps {eftest/eftest {:mvn/version "0.5.9"}
+        org.clojure/tools.namespace {:mvn/version "1.2.0"}
+        cloverage/cloverage {:mvn/version "1.1.1"}
+        hawk/hawk {:mvn/version "0.2.11"}}
+ ;; Note: prep is commented out because it only generates metosin.bat-test.version,
+ ;; which is only used in leiningen.bat-test--ie., only ever from a jar. This will
+ ;; thus never be used via a deps.edn source dependency. If enabling this prep step,
+ ;; add "target/classes" to the top-level :paths entry.
+ ;; clj -X:deps prep
+ ;; https://clojure.org/guides/deps_and_cli#prep_libs
+ ;:deps/prep-lib {:alias :build
+ ;                :fn compile
+ ;                :ensure "target/classes"}
+ :aliases {;; clojure -X:test
+           :test {:extra-paths ["test"]
+                  :extra-deps {io.github.cognitect-labs/test-runner 
+                               {:git/tag "v0.5.0" :git/sha "b3fd0d2"}}
+                  :exec-fn cognitect.test-runner.api/test}
+           ;; clj -T:build clean
+           ;; clj -T:build jar
+           ;; clj -T:build install
+           ;; clj -T:build version
+           :build {:deps {io.github.clojure/tools.build {:git/tag "v0.7.5" :git/sha "34727f7"}}
+                   :ns-default build}}}