# 1.76.1230 (2023-01-25 / 2b9d9df)

## Added

- `kaocha.repl/config` accepts a `:profile` key when specifying extra options.

## Fixed

- Configuration errors and circular dependencies are reported as warnings,
    rather than causing the entire watcher to crash. (thanks
    [@frenchy64](https://github.com/frenchy64))
- Fix bug added in [#384](#384):
    assertions in the tail position of an each fixture would return the result
    of the assertion instead of the testable object with the merged report data.
    (thanks [@NoahTheDuke](https://github.com/NoahTheDuke))

## Changed

.VERSION_PREFIX

@@ -1 +1 @@
-1.75
+1.76

CHANGELOG.md

@@ -1,4 +1,4 @@
-# Unreleased
+# 1.76.1230 (2023-01-25 / 2b9d9df)
 
 ## Added
 
@@ -986,4 +986,4 @@ namespace.
 - The configuration format has changed, you should now start with the `#kaocha
   {}` tagged reader literal in `tests.edn` to provide defaults. If you want more
   control then overwrite `tests.edn` with the output of `--print-config` and
-  tweak.
+  tweak.

README.md

@@ -58,6 +58,7 @@ There is also a [#kaocha](https://clojurians.slack.com/messages/CCY2V0U6A/convo/
 - [CLI: `--reporter` option](https://cljdoc.org/d/lambdaisland/kaocha/CURRENT/doc/cli-reporter-option)
 - [CLI: Selecting test suites](https://cljdoc.org/d/lambdaisland/kaocha/CURRENT/doc/cli-selecting-test-suites)
 - [Configuration: Bindings](https://cljdoc.org/d/lambdaisland/kaocha/CURRENT/doc/configuration-bindings)
+- [Configuration: Warnings](https://cljdoc.org/d/lambdaisland/kaocha/CURRENT/doc/configuration-warnings)
 - [Focusing based on metadata](https://cljdoc.org/d/lambdaisland/kaocha/CURRENT/doc/focusing-based-on-metadata)
 - [Focusing on specific tests](https://cljdoc.org/d/lambdaisland/kaocha/CURRENT/doc/focusing-on-specific-tests)
 - [Skipping based on metadata](https://cljdoc.org/d/lambdaisland/kaocha/CURRENT/doc/skipping-based-on-metadata)
@@ -103,7 +104,7 @@ Add Kaocha as a dependency, preferably under an alias.
 ;; deps.edn
 {:deps { ,,, }
  :aliases
- {:test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.75.1190"}}
+ {:test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.76.1230"}}
          :main-opts ["-m" "kaocha.runner"]}}}
 ```
 
@@ -124,7 +125,7 @@ Add a profile and alias
 ;; project.clj
 (defproject my-proj "0.1.0"
   :dependencies [,,,]
-  :profiles {:kaocha {:dependencies [[lambdaisland/kaocha "1.75.1190"]]}}
+  :profiles {:kaocha {:dependencies [[lambdaisland/kaocha "1.76.1230"]]}}
   :aliases {"kaocha" ["with-profile" "+kaocha" "run" "-m" "kaocha.runner"]})
 ```
 
@@ -168,7 +169,7 @@ options.  If you nonetheless prefer `:exec-fn`/`-X`, you can set up `deps.edn`:
 ;; deps.edn
 {:deps { ,,, }
  :aliases 
- {:test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.75.1190"}}
+ {:test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.76.1230"}}
          :exec-fn kaocha.runner/exec-fn
          :exec-args {}}}}
 ```
@@ -189,10 +190,10 @@ of tests skipped. You could save that configuration with an additional alias:
 ;; deps.edn
 {:deps { ,,, }
  :aliases 
- {:test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.75.1190"}}
+ {:test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.76.1230"}}
          :exec-fn kaocha.runner/exec-fn
          :exec-args {}}
- :watch-test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.75.1190"}}
+ :watch-test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.76.1230"}}
          :exec-fn kaocha.runner/exec-fn
          :exec-args {:watch? true
 	 :skip-meta :slow
@@ -323,4 +324,4 @@ line with the project's goals.
 Copyright © 2018-2023 Arne Brasseur and contributors
 
 Available under the terms of the Eclipse Public License 1.0, see LICENSE.txt
-<!-- /license -->
+<!-- /license -->

doc/02_installing.md

@@ -9,7 +9,7 @@ The main namespace for use at the command line is `kaocha.runner`, regardless of
 For example:
 
 ``` shell
-clojure -Sdeps '{:deps {lambdaisland/kaocha {:mvn/version "1.75.1190"}}}' -m kaocha.runner --test-help
+clojure -Sdeps '{:deps {lambdaisland/kaocha {:mvn/version "1.76.1230"}}}' -m kaocha.runner --test-help
 ```
 
 Below are instructions on the recommended way to set things up for various build tools.
@@ -23,7 +23,7 @@ In `deps.edn`, create a `test` "alias" (profile) that loads the `lambdaisland/ka
 {:deps { ,,, }
  :aliases
  {:test {:main-opts ["-m" "kaocha.runner"]
-         :extra-deps {lambdaisland/kaocha {:mvn/version "1.75.1190"}}}}}
+         :extra-deps {lambdaisland/kaocha {:mvn/version "1.76.1230"}}}}}
 ```
 
 Other dependencies that are only used for tests, like test framework or assertion
@@ -82,7 +82,7 @@ options.  If you nonetheless prefer `:exec-fn`/`-X`, you can set up `deps.edn`:
 ;; deps.edn
 {:deps { ,,, }
  :aliases 
- {:test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.75.1190"}}
+ {:test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.76.1230"}}
          :exec-fn kaocha.runner/exec-fn
          :exec-args {}}}}
 ```
@@ -103,10 +103,10 @@ of tests skipped. You could save that configuration with an additional alias:
 ;; deps.edn
 {:deps { ,,, }
  :aliases 
- {:test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.75.1190"}}
+ {:test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.76.1230"}}
          :exec-fn kaocha.runner/exec-fn
          :exec-args {}}
- :watch-test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.75.1190"}}
+ :watch-test {:extra-deps {lambdaisland/kaocha {:mvn/version "1.76.1230"}}
          :exec-fn kaocha.runner/exec-fn
          :exec-args {:watch? true
 	 :skip-meta :slow
@@ -123,7 +123,7 @@ Add Kaocha to your `:dev` profile, then add an alias that invokes `lein run -m k
 ``` clojure
 (defproject my-proj "0.1.0"
   :dependencies [,,,]
-  :profiles {:dev {:dependencies [,,, [lambdaisland/kaocha "1.75.1190"]]}}
+  :profiles {:dev {:dependencies [,,, [lambdaisland/kaocha "1.76.1230"]]}}
   :aliases {"kaocha" ["run" "-m" "kaocha.runner"]})
 ```
 
@@ -156,7 +156,7 @@ alias that activates the profile and invokes `lein run -m kaocha.runner`:
 ``` clojure
 (defproject my-proj "0.1.0"
   :dependencies [,,,]
-  :profiles {:kaocha {:dependencies [[lambdaisland/kaocha "1.75.1190"]]}}
+  :profiles {:kaocha {:dependencies [[lambdaisland/kaocha "1.76.1230"]]}}
   :aliases {"kaocha" ["with-profile" "+kaocha" "run" "-m" "kaocha.runner"]})
 ```
 

doc/config/warnings.md

@@ -0,0 +1,60 @@
+<!-- This document is generated based on a corresponding .feature file, do not edit directly -->
+
+# Configuration: Warnings
+
+Kaocha will warn about common mistakes.
+
+## No config
+
+- <em>Given </em> a file named "test/my/foo_test.clj" with:
+
+``` clojure
+(ns my.foo-test
+  (:require [clojure.test :refer :all]))
+
+(deftest var-test
+  (is (= 456 456)))
+```
+
+
+- <em>When </em> I run `bin/kaocha -c alt-tests.edn`
+
+- <em>Then </em> stderr should contain:
+
+``` nil
+Did not load a configuration file and using the defaults.
+```
+
+
+
+## Warn about bad configuration
+
+- <em>Given </em> a file named "tests.edn" with:
+
+``` clojure
+#kaocha/v1
+{:plugins notifier}
+```
+
+
+- <em>And </em> a file named "test/my/foo_test.clj" with:
+
+``` clojure
+(ns my.foo-test
+  (:require [clojure.test :refer :all]))
+
+(deftest var-test
+  (is (= 456 456)))
+```
+
+
+- <em>When </em> I run `bin/kaocha`
+
+- <em>Then </em> stderr should contain:
+
+``` nil
+Invalid configuration file:
+```
+
+
+