pallet.utils — dda/pallet 0.9.0

Utilities used across pallet.

apply-map clj/s macro

(apply-map & args)

as-string clj

(as-string arg)

Return the string value of the argument.

base64-md5 clj

(base64-md5 unsafe-id)

Computes the base64 encoding of the md5 of a string

classpath clj

(classpath)

Return the classpath File's for the current clojure classloader.

classpath-jarfiles clj

(classpath-jarfiles)

Returns a sequence of JarFile objects for the JAR files on classpath.

classpath-urls clj

(classpath-urls)

Return the classpath URL's for the current clojure classloader.

compare-and-swap! clj

(compare-and-swap! a f & args)

Compare and swap, returning old and new values

compiler-exception clj/s macro

(compiler-exception exception)

Create a compiler exception that wraps a cause and includes source location.

count-by clj

(count-by key-fn s)

Take a sequence and a key function, and returns a map with the count of each key.

count-values clj

(count-values s)

Take a sequence, and returns a map with the count of each value.

deep-merge clj

(deep-merge & ms)

Recursively merge maps.

dissoc-if-empty clj

(dissoc-if-empty m key)

Like clojure.core/dissoc, except it only dissoc's if the value at the keyword is nil.

dissoc-keys clj

(dissoc-keys m keys)

Like clojure.core/dissoc, except it takes a vector of keys to remove

file-for-url clj

(file-for-url url)

Convert a URL to a File.

find-var-with-require clj

(find-var-with-require sym)

(find-var-with-require ns sym)

Find the var for the given namespace and symbol. If the namespace does not exist, then it will be required. (find-var-with-require 'my.ns 'a-symbol) (find-var-with-require 'my.ns/a-symbol)

If the namespace exists, but can not be loaded, and exception is thrown. If the namespace is loaded, but the symbol is not found, then nil is returned.

first-line clj

(first-line s)

Return the first line of a string.

forward-to-script-lib clj/s macro

(forward-to-script-lib & symbols)

Forward a script to the new script lib

fwd-to-configure clj/s macro

(fwd-to-configure name & [as-name & _])

jar-file? clj

(jar-file? file)

Returns true if file is a normal file with a .jar or .JAR extension.

load-resource clj

(load-resource name)

load-resource-url clj

(load-resource-url name)

local-env clj/s macro

(local-env)

Return clojure's local environment as a map of keyword value pairs.

log-multiline clj/s macro

(log-multiline level-kw fmt string)

Log a multiline string in multiple log lines

macro-compiler-exception clj/s macro

(macro-compiler-exception exception)

Create a compiler exception that wraps a cause and includes source location.

make-user clj deprecated

(make-user username
           &
           {:keys [public-key-path private-key-path passphrase password
                   sudo-password no-sudo]
            :as options})

Creates a User record with the given username and options. Generally used in conjunction with admin-user and pallet.api/with-admin-user, or passed to lift or converge as the named :user argument.

Options:

• :public-key-path
• :private-key-path
• :passphrase
• :password
• :sudo-password (defaults to :password)
• :no-sudo

map-seq clj

(map-seq m)

Given an argument, returns the argument, or nil if passed an empty map.

map-with-keys-as-symbols clj

(map-with-keys-as-symbols m)

Produce a map that is the same as m, but with all keys are converted to symbols.

maybe-assoc clj

(maybe-assoc m k v)

'Assoc a value in an associative structure, where k is a key and v is the value to assoc. The assoc only occurs if the value is non-nil.

maybe-update-in clj

(maybe-update-in m [& ks] f & args)

'Updates' a value in a nested associative structure, where ks is a sequence of keys and f is a function that will take the old value and any supplied args and return the new value, and returns a new nested structure. If any levels do not exist, hash-maps will be created only if the update function returns a non-nil value. If the update function returns nil, the map is returned unmodified.

middleware clj/s macro

(middleware & forms)

Build a middleware processing pipeline from the specified forms. The result is a middleware.

obfuscate clj

(obfuscate pw)

Obfuscate a password, by replacing every character by an asterisk.

pipe clj/s macro

(pipe & forms)

Build a session processing pipeline from the specified forms.

pprint-lines clj

(pprint-lines s)

Pretty print a multiline string

quoted clj

(quoted s)

Return the string value of the argument in quotes.

resource-path clj

(resource-path name)

resource-properties clj

(resource-properties path)

Given a resource path, load it as a java properties file. Returns nil if resource not found.

slurp-as-byte-array clj

(slurp-as-byte-array file)

Read the given file as a byte array.

tmpdir clj

(tmpdir)

Create a temporary directory.

tmpfile clj

(tmpfile)

(tmpfile dir)

Create a temporary file

total-order-merge clj

(total-order-merge & seqs)

Merge the seqs sequences so that the ordering of the elements in result is the same as the ordering of elements present in each of the specified sequences. Throws an exception if no ordering can be found that satisfies the ordering in all the seqs.

underscore clj

(underscore s)

with-redef clj/s macro

(with-redef [& bindings] & body)

with-temp-file clj/s macro

(with-temp-file [varname content] & body)

Create a block where varname is a temporary File containing content.

with-temporary clj/s macro

(with-temporary bindings & body)

A block scope allowing multiple bindings to expressions. Each binding will have the member function delete called on it.