tservice-core.plugins.util — com.github.yjcyxky/tservice-core 0.2.2

Common utility functions useful throughout the codebase.

call-command! clj

(call-command! cmd)

(call-command! cmd env)

(call-command! cmd workdir env)

(call-command! cmd parameters-coll workdir env)

chain-fn-coll clj

(chain-fn-coll fn-coll pred)

Run the set of functions sequentially, exit the run when pred is false and return the existing result.

datetime clj

(datetime)

format-color clj

(format-color color x)

(format-color color format-string & args)

Like format, but colorizes the output. color should be a symbol or keyword like green, red, yellow, blue, cyan, magenta, etc. See the entire list of avaliable colors here.

(format-color :red "Fatal error: %s" error-message)

get-path-variable clj

(get-path-variable)

hashmap->parameters clj

(hashmap->parameters coll)

{ '-d' 'true' '-o' 'output' } -> '-d true -o output'

make-plugin-subpath clj

(make-plugin-subpath plugin-dir dir-name plugin-name)

Return a new directory based on plugin-name and custom subdir.

now clj

(now)

(now offset)

Get the current local datetime.

one-or-many clj

(one-or-many arg)

Wraps a single element in a sequence; returns sequences as-is. In lots of situations we'd like to accept either a single value or a collection of values as an argument to a function, and then loop over them; rather than repeat logic to check whether something is a collection and wrap if not everywhere, this utility function is provided for your convenience. (u/one-or-many 1) ; -> [1] (u/one-or-many [1 2]) ; -> [1 2]

prog1 clj macro

(prog1 first-form & body)

Execute first-form, then any other expressions in body, presumably for side-effects; return the result of first-form. (def numbers (atom [])) (defn find-or-add [n] (or (first-index-satisfying (partial = n) @numbers) (prog1 (count @numbers) (swap! numbers conj n)))) (find-or-add 100) -> 0 (find-or-add 200) -> 1 (find-or-add 100) -> 0 The result of first-form is bound to the anaphor <>, which is convenient for logging: (prog1 (some-expression) (println "RESULTS:" <>)) prog1 is an anaphoric version of the traditional macro of the same name in Emacs Lisp and Common Lisp. Style note: Prefer doto when appropriate, e.g. when dealing with Java objects.

render-template clj

(render-template template env-context)

TODO: Schema for rendering environment.

Arguments: env-context: {:ENV_DEST_DIR " " :ENV_NAME "pgi" :CLONE_ENV_BIN ""}

time->int clj

(time->int datetime)

uuid clj

(uuid)

These UUID's will be guaranteed to be unique and thread-safe regardless of clock precision or degree of concurrency.

varargs clj macro

(varargs klass)

(varargs klass xs)

Make a properly-tagged Java interop varargs argument. This is basically the same as into-array but properly tags the result. (u/varargs String) (u/varargs String ["A" "B"])

with-sh-env clj macro

(with-sh-env dir env & forms)

Sets the directory for use with sh, see sh for details.