Thanks Ducan, this is incredibly useful! On Tuesday, November 7, 2017 at 11:17:28 AM UTC-8, Duncan McGreggor wrote: > > > > On 7 November 2017 at 13:11, Timothy Baldridge <tbald...@gmail.com > <javascript:>> wrote: > >> I structure my code very explicitly. Normally the most common constructs >> are put in a single file named after the library itself (not in core.clj, >> do that half your files will be named core). >> >> https://github.com/halgari/odin/blob/master/src/com/tbaldridge/odin.clj >> >> Anything not in the API that should be unpublished to users is in other >> namespaces that are imported and wrapped by vars in the main namespace. >> This does several things: >> >> * Keeps the public interface in one place >> * Allows for a different public interface than the private one. Notice >> how Odin has its own version of `when`, pulling that off require a bit of >> careful macro usage, so I'd rather write that once under a different name, >> then rename it to `when`. >> * It's now simple to say "anything in this namespace is public and will >> not change" >> >> Core.async uses a pattern much like this, the API is in >> clojure.core.async, most of the logic is under *.async.impl.*. >> > > This is a great practice; it's how I do all my protocols/implementations > now. > > >> I don't recommend potemkin's import-vars at all. Clojure vars were not >> meant to exist in more than one namespace at a time, so potemkin pulls of >> its magic by linking two vars via watchers. This means that changes to one >> var can cause side-effects in the other. In addition, bindings don't convey >> properly (AFAIK), so if you using bindings on one var, the changes won't be >> seen in the other var. Remember: import-vars doesn't actually import >> anything, it simply creates a new var in the current namespace and links >> the two via a two-way binding. It's quite the hack, imo. >> > > Huh. Good to know. Will have to ponder ... > > d > > >> So I have to agree with Potemkin's tagline on github: it's an idea that's >> "almost good". >> >> Timothy >> >> On Tue, Nov 7, 2017 at 11:13 AM, Nick Mudge < >> ni...@perfectabstractions.com <javascript:>> wrote: >> >>> I am interested to know if people/you use import-vars to decouple the >>> structure of code from its API. >>> >>> import-vars is from the potemkin library: >>> https://github.com/ztellman/potemkin >>> >>> If you don't use import-vars how do you structure your code and provide >>> an API? >>> >>> >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "Clojure" group. >>> To post to this group, send email to clo...@googlegroups.com >>> <javascript:> >>> Note that posts from new members are moderated - please be patient with >>> your first post. >>> To unsubscribe from this group, send email to >>> clojure+u...@googlegroups.com <javascript:> >>> 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+u...@googlegroups.com <javascript:>. >>> For more options, visit https://groups.google.com/d/optout. >>> >> >> >> >> -- >> “One of the main causes of the fall of the Roman Empire was that–lacking >> zero–they had no way to indicate successful termination of their C >> programs.” >> (Robert Firth) >> >> -- >> You received this message because you are subscribed to the Google >> Groups "Clojure" group. >> To post to this group, send email to clo...@googlegroups.com >> <javascript:> >> Note that posts from new members are moderated - please be patient with >> your first post. >> To unsubscribe from this group, send email to >> clojure+u...@googlegroups.com <javascript:> >> 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+u...@googlegroups.com <javascript:>. >> 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.