clj-utils

Unrelated Clojure utilities

Usage

[acyclic/utils "0.0.2"]

Define cli-options as per clojure.tools.cli and a function doit that takes a key-value map and returns some result. Then

  (defn -main [& args] (edn-app args cli-options doit)

If you do not specify corresponding options yourself, then you'll get for free:

--log LOGLEVEL (e.g. "debug", "info", etc., which will be keyworded and passed to timbre
--help (prints out an unfriendly but useful dump of option definitions)
--id SOMESTRING (Anything to uniquely identify this invocation)
--hang SECS (Sleep for SECS before exiting)
--opts EDNMAP (The entire options map in EDN parseable form, e.g. {:yournum 3 :id \"XYZ\"}

Options will be processed into key-value pairs (as per clojure.tools.cli again) and the return value of doit will be wrapped as

{:result return-value-of-doit
 :exception nil-or-stack-trace
 :log nil-or-vector
 :id the-id-you-specified-or-X
}

and printed to standard output in EDN parseable form.

A few handy functions that I and probably nobody else will use in concert with taoensso.timbre.

(strack-trace e) - returns a full stack trace from an Exception as a vector of strings
(fname f) - returns the qualified name of a clojure function, as a string
(set-logging level) - Sets the timbre logging level as specified and installs an appender that
accrues log events in a vector
prints them to stderr as well
(with-accrued-log m) - places the vector of accrued events into map m, keyed by :log.

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.