eg — eg 0.4.11-alpha

->example-test clj/s macro

(->example-test fn-sym examples focus-metas- focus?)

Creates a clojure.test test for function being tested. Assertions are generated under the test using provided examples. Test name is derived from the fully qualified name of function under test, and by appending '-test' to it. Test may not run depending on its focus state, and of other function tests.

->examples clj/s

(->examples test-thing ge? body)

Takes in an eg body, and returns example pairs.

->expression-test clj/s macro

(->expression-test examples)

Creates a clojure.test test for expressions being tested. Assertions are generated under the test using provided expressions. Test name is created as 'eg-test-<rand-id>'.

->test-name clj/s

alter-test-var-update-fn clj/s

(alter-test-var-update-fn test-v)

Meant for use with 'alter-var-root' to decorate 'clj.test/test-var' with test check on focus state.

assoc-focus-metas clj/s

(assoc-focus-metas focus-metas- fn-meta fn-sym)

Creates a new entry in fn to focus? map for qualified function in params.

cljs-safe-namespace clj/s

(cljs-safe-namespace thing)

Like 'namespace', but occurrences of '.' are replaced with '-', to prevent compilation error in cljs. Used to create an unambiguous test name.

dont-care? clj/s

eg clj/s macro

(eg & args)

Test function using examples of parameters / expected value. See readme for usage.

eg-helper clj/s macro

(eg-helper [fn-sym & body] ge?)

Common logic between 'eg' and 'ge'.

ex clj/s macro

(ex & body)

Test arbitrary expressions against corresponding expected values. See readme for usage.

examples-acc clj/s

(examples-acc [parts part] token)

Accumulates examples, mainly taking into account operator used in example.

ffilter clj/s

(ffilter pred coll)

fill-dont-cares clj/s

(fill-dont-cares examples)

Takes in example pairs, and fills every occurrence of a don't care with values from other examples. Each '' don't care occurrence is replaced with a value from another example at the same args position. Each named don't care (prefixed with '$'), is replaced the same way as in '', then propagated to every occurrence under its expected value.

focus-metas clj/s

ge clj/s macro

(ge & args)

Like 'eg' but example components are reversed. See readme for usage.

map-dregs clj/s

(map-dregs f & colls)

Like map but when there is a different count between colls, applies input fn to the coll values until the biggest coll is empty.

named-dont-care? clj/s

(named-dont-care? thing)

operators clj/s

parse-example clj/s

(parse-example example ge?)

Normalizes an 'eg/ge' example's operator, and order of function parameters vs expected result.

parse-expression clj/s

(parse-expression expr)

Normalizes an 'ex' expression's operator, and order of test expression vs expected result.

rm-lead-colon clj/s

(rm-lead-colon s)

Motivation: 'name' does not work for processed strings.

set-eg! clj

(set-eg! & egs)

Interns 'eg', 'ge', and 'ex' in clojure.core, to be able to use those forms without requires in test ns. Then, refreshes all namespaces for cases when a test namespace is required before this function is called.

set-eg-no-refresh! clj

(set-eg-no-refresh! egs)

Interns 'eg', 'ge', and 'ex' in clojure.core, to be able to use those forms without requires in test ns.

spec-eg-acc clj/s

(spec-eg-acc [parts part] token)

Accumulates examples for a spec, mainly because some could appear negated using '!'.

test? clj/s

(test? focus-metas focus?)

Used to determine if function will be tested based on its focus state, and the focus state of the other function tests.

variadic-bang? clj/s

(variadic-bang? token)

Checks if token is a list with '!' as first element.