Clojure Spec: Adding generators to an existing spec

Question

Is there a clean way of adding spec generators in test code that apply to a spec defined in another source file? For example, say I have the following under my main src/ directory:

(s/fdef my-func
   :args (s/cat 
           :statement (partial instance? java.sql.PreparedStatement))
   :ret bool?)

In order to do generative testing I will need a generator for the statement argument, say one that generates mock statements, but I'd rather not mix test code with production nor make other projects that use this library also transitively pull down the test libraries.

So what I'm looking for is a convention to apply generators atop an existing spec without having to modify the source for that spec.

Since specs use a global registry, writing your spec last most likely is the way to go — cfrick
– cfrick, Commented Nov 10, 2020 at 20:58

Taylor Wood · Accepted Answer · 2020-11-12 00:15:35Z

2

clojure.spec.test.alpha/check takes an optional map of generator overrides: https://clojure.github.io/spec.alpha/clojure.spec.test.alpha-api.html#clojure.spec.test.alpha/check

:gen        map from spec names to generator overrides

Note that you need to use a named spec, so in your example above you'd need to s/def something like ::statement:

(s/def ::statement (partial instance? java.sql.PreparedStatement))

Then your function spec :args would look like (s/cat :statement ::statement).

You could then supply a generator to check like this in your test project:

(st/check sym-or-syms {:gen {::statement my-test-proj-generator}})

a convention to apply generators atop an existing spec without having to modify the source for that spec

I think with-gen is appropriate for this: it takes an existing spec and returns that spec with a given generator.

edited Nov 12, 2020 at 0:15

answered Nov 10, 2020 at 22:03

Taylor Wood

16.2k1 gold badge24 silver badges38 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Tim Clemons Over a year ago

To verify, should your call to st/check actually look like the following: (st/check sym-or-syms {:gen {::statement my-test-proj-generator}}) ?

Collectives™ on Stack Overflow

Clojure Spec: Adding generators to an existing spec

1 Answer 1

1 Comment

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

1 Comment

Your Answer

Sign up or log in

Post as a guest

Related