Added changelog and doc; additional test case

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## [Unreleased](https://github.com/TypedDevs/bashunit/compare/0.11.0...main)
 
+- Add `fail()` function
+
 ## [0.11.0](https://github.com/TypedDevs/bashunit/compare/0.10.1...0.11.0) - 2024-03-02
 
 - Add `--upgrade` option to `./bashunit`

docs/assertions.md

@@ -856,3 +856,20 @@ function test_failure() {
 }
 ```
 :::
+
+## fail
+> `fail "failure message"`
+
+Unambiguously reports an error message. Useful for reporting specific message
+when testing situations not covered by any `assert_*` functions.
+
+::: code-group
+```bash [Example]
+function test_success() {
+  true || fail "This will never fail"
+}
+function test_failure() {
+  [ $(date +%-H) -lt 6 ] || fail "It's late, go to bed"
+}
+```
+:::

tests/unit/assert_test.sh

@@ -1,5 +1,9 @@
 #!/bin/bash
 
+function test_successful_fail() {
+  true || fail "This cannot fail"
+}
+
 function test_unsuccessful_fail() {
   assert_equals\
     "$(console_results::print_failure_message "Unsuccessful fail" "Failure message")"\