Clojurians Log v2

Good Morning!

👋

Morning 🙂

Morning

morning

I really do enjoy using the cognitect aws library

easy to use 🙂

I thought the lack of functions would be an annoyance tbh. I'd love to know the rationale in the fullest.

I’ve used the lib myself, it is really good, and there are definite benefits to the design; but yes the lack of functions were a bit annoying. I found you had to use the repl doc functions a lot to inspect the docs, rather than just being able to browse them

Right, I guess it's optimized for a repl workflow, rather than a cider/tooling one.

well they’ve invented their own way of accessing docs — mostly driven by spec; which is fine… but unfortunately specs doc story isn’t great at the minute.

didn't they just try to be as thin a wrapper as possible

that way when AWS change the js specs

they still work (as much as possible)

I do sometimes wish clojure had better doc tooling for APIs etc. There are a bunch of things that don’t have a native uniform way to document in particular namespaced keywords and specs, but also a few other things that might at times be handy… - deftypes/records - defmethod implementations (contributing docs to the defmulti) Admittedly the later ones are perhaps a bit more controversial but would at times I think be useful. Though hard to know how they’d implement docs for deftypes/records; and the work arounds are sufficient.

I suppose you don't get a compiler error, you get something else instead?

yes they did — not critcising what they’ve done, it is really good… just noting a consequence of it.

yeah you essentially get a spec error iirc