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 Clojure releases 
tends to be fairly fast, because it’s so stable and so easy to upgrade 
(mostly!). See http://blog.cognitect.com/blog/2017/1/31/clojure-2018-results -- 
only about 6% of users were on 1.7 or earlier as of Q1 this year.

Sean Corfield -- (970) FOR-SEAN -- (904) 302-SEAN
An Architect's View -- http://corfield.org/

"If you're not annoying somebody, you're not really alive."
-- Margaret Atwood

________________________________
From: clojure@googlegroups.com <clojure@googlegroups.com> on behalf of Howard 
Lewis Ship <hls...@gmail.com>
Sent: Friday, September 14, 2018 9:59:56 AM
To: clojure@googlegroups.com
Subject: Release a lib w/ specs

I'm thinking of releasing a tiny library (really, just one macro), and I want 
to document/validate using spec.

What's the accepted approach for bundling the macro with its spec:

- Just add the spec right in the namespace with the macro
- Have a second optional namespace that provides the spec for the macro
- Something I haven't thought of

--
Howard M. Lewis Ship

Senior Mobile Developer at Walmart Labs

Creator of Apache Tapestry

(971) 678-5210
http://howardlewisship.com
@hlship

--
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your 
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
---
You received this message because you are subscribed to the Google Groups 
"Clojure" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to 
clojure+unsubscr...@googlegroups.com<mailto:clojure+unsubscr...@googlegroups.com>.
For more options, visit https://groups.google.com/d/optout.

-- 
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your 
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"Clojure" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to