trident.util — trident/docs 0.1.4-4-SNAPSHOT

Utility library. Docstrings are omitted for simple functions; read the source to see what they do.

capture clj/s macro

(capture & xs)

char->int cljs

cljs-import-vars clj/s macro

(cljs-import-vars nspace & syms)

Like potemkin/import-vars but supports importing cljs-only functions.

Example:

(cljs-import-vars my.namespace.core
                  foo bar baz)

condas-> clj/s macro

(condas-> expr name & clauses)

Combination of cond-> and as->.

defconfig clj/s macro

(defconfig default)

Defines config and init-config! vars.

Example:

(defconfig
  {:first-name "John"
   :last-name  "Doe"
   :full-name ^:derived #(str (:first-name %) " " (:last-name %))})

config
=> {:first-name "John" :last-name  "Doe" :full-name "John Doe"}

(init-config! {:first-name "Jane"})
config
=> {:first-name "Jane" :last-name  "Doe" :full-name "Jane Doe"}

default is a map. Any values with a truthy :derived metadata value must be single-argument functions. These functions will be replaced with their return values, with the config map as the argument.

init-config! takes any number of maps and merges them onto the provided config map using taoensso.encore/nested-merge, deriving values afterward.

derive-config clj/s

(derive-config m)

Replaces any ^:derived values in m. See defconfig.

doclines clj/s

(doclines _var)

Returns the docstring of a var as a collection of lines, removing indentation.

for-every? clj/s macro

(for-every? & forms)

for-some? clj/s macro

(for-some? & forms)

forcat clj/s macro

(forcat & forms)

format cljs

alias for goog.string.format

forv clj/s macro

(forv & body)

inherit clj/s macro

(inherit child-name [parent-instance :as fields] & overrides)

Like deftype but with default function implementations.

The first field is the "parent": for any protocol functions you don't define, the function will be called again with the parent as the first argument instead of the current object.

Example:

(defprotocol P
  (foo [this])
  (bar [this]))

(deftype Parent []
  P
  (foo [_] "parent foo")
  (bar [_] "parent bar"))

(inherit Child [parent]
  P
  (foo [_] "child foo"))

(def parent (Parent.))
(def child (Child. parent))

(foo child)
=> "child foo"
(bar child)
=> "parent bar"

instant? clj/s

(instant? x)

js<! clj/s macro

(js<! form)

Like <! but for js promises. See to-chan.

load-fns clj/s macro

(load-fns & forms)

Defines a bunch of "dynamic functions" (see loadf).

Example:

(load-fns
  foo my.lib/foo
  bar my.lib/bar
  baz your.lib/baz)
(foo) ; same as (do (require 'my.lib) (my.lib/foo))

load-var clj

(load-var sym)

Dynamically loads a var.

sym: a fully-qualified var symbol.

loadf clj

(loadf sym)

Returns a function that dynamically loads and calls the specified function.

sym: a fully-qualified function symbol.

map-kv clj/s

(map-kv f xs)

ord clj/s

pad clj/s

(pad n _val coll)

parse-int clj/s

(parse-int s)

pprint clj/s

pred-> clj/s

(pred-> x f g)

rand-str clj/s

(rand-str len)

text clj/s macro

(text & forms)

Generates a string from pairs of conditions and lines of text.

The right-hand side values will be flattened, so you can give strings, collections of strings, or nested collections of strings. nils are removed.

Example:

(println (text
           true  ["foo" nil "bar"]
           false "baz"
           true  "quux"))
foo
bar
quux

text-columns clj/s

(text-columns rows)

Formats rows of text into columns.

Example:

(doseq [row (text-columns [["hellooooooooo " "there"]
                           ["foo " "bar"]
                           ["one column"]])]
  (println row))
hellooooooooo there
foo           bar
one column

to-chan cljs

(to-chan p)

Converts a js promise to a channel. If the promise throws an error, logs to the console and closes the channel.