This namespace contains functions for testing generators. See the
jepsen.generator-test namespace in the test/ directory for a concrete
example of how these functions can be used.
NOTE: While the simulate function is considered stable at this point, the
others might still be subject to change -- use with care and expect possible
breakage in future releases.
This namespace contains functions for testing generators. See the `jepsen.generator-test` namespace in the `test/` directory for a concrete example of how these functions can be used. NOTE: While the `simulate` function is considered stable at this point, the others might still be subject to change -- use with care and expect possible breakage in future releases.
A default initial context for running these tests. Two worker threads, one nemesis.
A default initial context for running these tests. Two worker threads, one nemesis.
(imperfect gen)(imperfect ctx gen)Simulates the series of ops obtained from a generator where threads alternately fail, info, then ok, and repeat, taking 10 ns each. Returns invocations and completions.
Simulates the series of ops obtained from a generator where threads alternately fail, info, then ok, and repeat, taking 10 ns each. Returns invocations and completions.
(invocations history)Only invokes, not returns
Only invokes, not returns
(n+nemesis-context n)A context with n numeric worker threads and one nemesis.
A context with n numeric worker threads and one nemesis.
(perfect gen)(perfect ctx gen)Simulates the series of ops obtained from a generator where the system executes every operation successfully in 10 nanoseconds. Returns only invocations.
Simulates the series of ops obtained from a generator where the system executes every operation successfully in 10 nanoseconds. Returns only invocations.
(perfect* gen)(perfect* ctx gen)Simulates the series of ops obtained from a generator where the system executes every operation successfully in 10 nanoseconds. Returns full history.
Simulates the series of ops obtained from a generator where the system executes every operation successfully in 10 nanoseconds. Returns full history.
(perfect-info gen)(perfect-info ctx gen)Simulates the series of ops obtained from a generator where every operation crashes with :info in 10 nanoseconds. Returns only invocations.
Simulates the series of ops obtained from a generator where every operation crashes with :info in 10 nanoseconds. Returns only invocations.
(quick gen)(quick ctx gen)Like quick-ops, but returns just invocations.
Like quick-ops, but returns just invocations.
(quick-ops gen)(quick-ops ctx gen)Simulates the series of ops obtained from a generator where the system executes every operation perfectly, immediately, and with zero latency.
Simulates the series of ops obtained from a generator where the system executes every operation perfectly, immediately, and with zero latency.
We need tests to be deterministic for reproducibility, but also pseudorandom. Changing this seed will force rewriting some tests, but it might be necessary for discovering edge cases.
We need tests to be deterministic for reproducibility, but also pseudorandom. Changing this seed will force rewriting some tests, but it might be necessary for discovering edge cases.
(simulate gen complete-fn)(simulate ctx gen complete-fn)Simulates the series of operations obtained from a generator, given a function that takes a context and op and returns the completion for that op.
Strips out op :index fields--it's generally not as useful for testing.
Simulates the series of operations obtained from a generator, given a function that takes a context and op and returns the completion for that op. Strips out op :index fields--it's generally not as useful for testing.
(with-fixed-rands seed & body)Rebinds rand, rand-int, and rand-nth to yield a deterministic series of random values. Definitely not threadsafe, but fine for tests I think.
Rebinds rand, rand-int, and rand-nth to yield a deterministic series of random values. Definitely not threadsafe, but fine for tests I think.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |