Re: Release a lib w/ specs

2018-09-16 Thread Robert Luo
My two cents: Adding spec inside the original namespace is more readable, provide documentation just in place, and the user do not need to require a separate namespace to get spec of your API, I will prefer it. For users stay in < clojure 1.9.0, I use this macro in my code: (defmacro opt-requi

Re: Release a lib w/ specs

2018-09-14 Thread Alex Miller
Those are the two obvious options and both are fine. The latter makes loading and use of the spec optional. If you do that, we recommend putting specs in the.namespace.specs for the.namespace. On Friday, September 14, 2018 at 12:00:30 PM UTC-5, Howard M. Lewis Ship wrote: > > I'm thinking of r

RE: Release a lib w/ specs

2018-09-14 Thread Sean Corfield
If you’re planning to target versions of Clojure prior to 1.9, you’ll want the specs in a separate file – as does clojure.java.jdbc (supports Clojure 1.7+). If you’re only planning to target 1.9+, I’d probably lean toward putting the spec in the same namespace at this point. Adoption of new Cloj