crispin.core — crispin 0.3.6

Managing system-wide configuration.

Configuration map is assumed immutable and can be safely cached. Configuration is static. When the config changes, service should be restarted. Design choice is to have stateless fail-fast services, that have their configuration stored on various places.

bget clj

(bget cfg k)

(bget cfg k default)

Like get, but coerces to boolean. Does not parse default value. Defaults to false

bget-in clj

(bget-in cfg ks)

(bget-in cfg ks default-value)

Like get-in, but coerces to boolean. Does not parse default value. Defaults to false.

bmap clj

cfg clj

(cfg)

(cfg search-in)

(cfg search-in include-raw?)

Provides map merged from various sources, in following order:

• :cp Configuration file in the root classpath
• :profile Project specific environment variables (set e.g. in lein project.clj or profiles.clj) Users must use lein-environ plugin to enable this
• custom-cfg reference
• :env Environment variables, translating keys
• :sys Java system properties, translating keys
• :res Custom configuration resources pointed from [:crispin] property, guessing format from filename, defaulting to .edn

Sources are also optionally put under :raw key.

Accepted file names for configuration files, loaded in following order:

• config.json
• config.edn
• config.clj

Conflicts when merging branch and non-branch nodes are resolved into creation of branch node with previous non-branch node put under nil key.

custom-cfg clj

A reference to map that will be merged into configuration map. Used e.g. by boot to inject custom configuration.

escape-map clj

fetch-cp-entry clj

(fetch-cp-entry entry ppath)

fetch-env clj

(fetch-env)

Returns map that represents current environment variables. Name of the environment variable is translated into sequence of keys, e.g. JAVA_HOME will result into {:java {:home "/usr/lib/..."}} map

fetch-resource clj

(fetch-resource uri)

(fetch-resource parser uri)

Returns map loaded from resource specified by _uri_, parsed with _parser_. UTF-8 encoding is assumed and the resource must produce exactly one parsed value. Returns nil if resource does not exists

fetch-root clj

(fetch-root)

fetch-sys clj

(fetch-sys)

Returns map that represents current system properties Name of the environment variable is translated into sequence of keys, e.g. java.home will result into {:java {:home "/usr/lib/..."}} map

filenames-in-jar clj

(filenames-in-jar jar-file)

Returns a sequence of Strings naming the non-directory entries in the _jar-file_.

instance?* clj

(instance?* t m)

IResource clj protocol

-get-uri clj

(-get-uri this)

jar-file? clj

(jar-file? f)

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

merge-cfg clj

(merge-cfg & maps)

nget clj

(nget cfg k)

(nget cfg k default)

Like get, but coerces to number. Does not parse default value. Allows nil values.

nget-in clj

(nget-in cfg ks)

(nget-in cfg ks default-value)

Like get-in, but parses value with edn reader and asserts that it is a number. Does not parse default value. Allows nil values.

preescape-map clj

provide-sequential clj

(provide-sequential x)

sget clj

(sget cfg k)

(sget cfg k default)

Like get, but coerces to string. Does not parse default value. Allows nil values.

sget-in clj

(sget-in cfg ks)

(sget-in cfg ks default-value)

Like get-in, but coerces to string. Does not parse default value. Nil is not coerced into a string.

transform-keys clj

(transform-keys coll separator)

unescape clj

(unescape s m)