Exceptions indicated.
helins.mprop
Multiplexing test.check property and tracking failure.
See README for overview.
Multiplexing `test.check` property and tracking failure. See README for overview.
andclj/smacro
(and & form+)Like Clojure's and but an item is considered truthy if it passes clojure.test.check.results/pass?.
Great match for check as it allows for testing several assertions, even nested one, while keepin track
of where failure happens.
Like Clojure's `and` but an item is considered truthy if it passes `clojure.test.check.results/pass?`. Great match for [[check]] as it allows for testing several assertions, even nested one, while keepin track of where failure happens.
checkclj/smacro
(check beacon form)Executes form.
Any failure or thrown exception is wrapped in an object that returns false on clojure.test.check.results/pass? with
the following result data map attached:
| Key | Value |
|---|---|
:mprop/path | List of beacons, contains more than one if checks were nested and shows exactly where failure happened |
:mprop/value | Value returned by form |
Usually, checks are used with and. A beacon can be any value the user deems useful (often a human-readable string).
For example (and being and from this namespace):
(and (check "Some test"
(= 4 (+ 2 2)))
(check "Another test"
(= 3 (inc 1))))
Executes form.
Any failure or thrown exception is wrapped in an object that returns false on `clojure.test.check.results/pass?` with
the following result data map attached:
| Key | Value |
|---|---|
| `:mprop/path` | List of `beacon`s, contains more than one if checks were nested and shows exactly where failure happened |
| `:mprop/value` | Value returned by `form` |
Usually, checks are used with [[and]]. A `beacon` can be any value the user deems useful (often a human-readable string).
For example (`and` being [[and]] from this namespace):
```clojure
(and (check "Some test"
(= 4 (+ 2 2)))
(check "Another test"
(= 3 (inc 1))))
```deftestclj/smacro
(deftest sym prop)(deftest sym option+ prop)Like clojure.test.check.clojure-test/defspec.
Difference is that the number of tests and maximum size can be easily configured and calibrated at the level of the whole test suite.
option+ is a map as accepted by defspec, it can notably hold :max-size and
:num-tests.
Most of the time, it is not productive fixing absolute values. During dev, number of tests and maximum size can be kept low in order to gain a fast feedback on what is going on. During actual testing, those values can be set a lot higher.
For altering the base values, see max-size and num-tests. Each test can be
calibrated against those base values. option+ also accepts:
| Key | Value |
|---|---|
:ratio-num | Multiplies the base num-tests value |
:ratio-size | Multiplies the base max-size value |
For instance, a test that runs 10 times more with half the maximum size:
(deftest foo
{:ratio-num 10
:ratio-size 0.5}
some-property)
Like `clojure.test.check.clojure-test/defspec`.
Difference is that the number of tests and maximum size can be easily configured
and calibrated at the level of the whole test suite.
`option+` is a map as accepted by `defspec`, it can notably hold `:max-size` and
`:num-tests`.
Most of the time, it is not productive fixing absolute values. During dev, number of tests
and maximum size can be kept low in order to gain a fast feedback on what is going on.
During actual testing, those values can be set a lot higher.
For altering the base values, see [[max-size]] and [[num-tests]]. Each test can be
calibrated against those base values. `option+` also accepts:
| Key | Value |
|---|---|
| `:ratio-num` | Multiplies the base [[num-tests]] value |
| `:ratio-size` | Multiplies the base [[max-size]] value |
For instance, a test that runs 10 times more with half the maximum size:
```clojure
(deftest foo
{:ratio-num 10
:ratio-size 0.5}
some-property)
```failclj/s
(fail beacon failure)Used by check.
More rarely, can be used to return an explicit failure.
Used by [[check]]. More rarely, can be used to return an explicit failure.
max-sizeclj
Maximum size used by deftest. Can be set using the MPROP_MAX_SIZE env variable.
Default value is 200.
Maximum size used by [[deftest]]. Can be set using the `MPROP_MAX_SIZE` env variable. Default value is 200.
multclj/smacro
(mult & check+)Very common, sugar for using check with and.
Short for "multiplex".
Replicating example in check:
(mult "Some assertion"
(= 4 (+ 2 2))
"Another assertion"
(= 3 (inc 1)))
Very common, sugar for using [[check]] with [[and]].
Short for "multiplex".
Replicating example in [[check]]:
```clojure
(mult "Some assertion"
(= 4 (+ 2 2))
"Another assertion"
(= 3 (inc 1)))
```num-testsclj
Number of tests used by deftest. Can be set using the MPROP_NUM_TESTS env variable.
Default value is 100.
Number of tests used by [[deftest]]. Can be set using the `MPROP_NUM_TESTS` env variable. Default value is 100.
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close