jepsen.store — jepsen 0.1.14

Persistent storage for test runs and later analysis.

base-dir clj

class-name->ns-str clj

(class-name->ns-str class-name)

Turns a class string into a namespace string (by translating _ to -)

console-appender clj

default-edn-reader clj

(default-edn-reader tag value)

We use defrecords heavily and it's nice to be able to deserialize them.

default-nonserializable-keys clj

What keys in a test can't be serialized to disk, by default?

delete! clj

(delete!)

(delete! test-name)

(delete! test-name test-time)

Deletes all tests, or all tests under a given name, or, if given a date as well, a specific test.

delete-file-recursively! clj

(delete-file-recursively! f)

dir? clj

(dir? f)

Is this a directory?

edn-tag->constructor clj

(edn-tag->constructor tag)

Takes an edn tag and returns a constructor fn taking that tag's value and building an object from it.

file-name clj

(file-name f)

Maps a File to a string name.

fressian-file clj

(fressian-file test)

Gives the path to a fressian file encoding all the results from a test.

fressian-file! clj

(fressian-file! test)

Gives the path to a fressian file encoding all the results from a test, ensuring its containing directory exists.

latest clj

(latest)

Loads the latest test

load clj

(load test-name test-time)

Loads a specific test by name and time.

load-results clj

(load-results test-name test-time)

Loads only a results.edn by name and time.

memoized-edn-tag->constructor clj

memoized-load-results clj

nonserializable-keys clj

(nonserializable-keys test)

What keys in a test can't be serialized to disk? The union of default nonserializable keys, plus any in :nonserializable-keys.

path clj

(path test)

(path test & args)

With one arg, a test, returns the directory for that test's results. Given additional arguments, returns a file with that name in the test directory. Nested paths are flattened: (path t [:a [:b :c] :d) expands to .../a/b/c/d. Nil path components are ignored: (path t :a nil :b) expands to .../a/b.

Test must have only two keys: :name, and :start-time. :start-time may be a string, or a DateTime.

path! clj

(path! & args)

Like path, but ensures the path's containing directories exist.

read-handlers clj

save-1! clj

(save-1! test)

Writes a history and fressian file to disk and updates latest symlinks. Returns test.

save-2! clj

(save-2! test)

Phase 2: after computing results, we re-write the fressian file, histories, and also dump results as edn. Returns test.

start-logging! clj

(start-logging! test)

Starts logging to a file in the test's directory. Also updates current symlink. Test may include a :logging key, which should be a map with the following optional options:

{:overrides   A map of packages to log level keywords}

stop-logging! clj

(stop-logging!)

Resets logging to console only.

symlink? clj

(symlink? f)

Is this a symlink?

test-names clj

(test-names)

Returns a seq of all known test names.

tests clj

(tests)

(tests test-name)

If given a test name, returns a map of test runs to deref-able tests. With no test name, returns a map of test names to maps of runs to deref-able tests.

update-current-symlink! clj

(update-current-symlink! test)

Creates a current symlink to the currently running test, if a store directory exists.

update-symlink! clj

(update-symlink! test dest)

Takes a test and a symlink path. Creates a symlink from that path to the test directory, if it exists.

update-symlinks! clj

(update-symlinks! test)

Creates latest and current symlinks to the given test, if a store directory exists.

virtual-dir? clj

(virtual-dir? f)

Is this a . or .. directory entry?

with-out-file clj macro

(with-out-file test filename & body)

Binds stdout to a file for the duration of body.

write-fressian! clj

(write-fressian! test)

Write the entire test as a .fressian file

write-handlers clj

write-history! clj

(write-history! test)

Writes out history.txt and history.edn files.

write-results! clj

(write-results! test)

Writes out a results.edn file.