frereth.weald.logging — com.frereth/weald 0.0.5-g4910dcc

Functional logging mechanism

async-log-factory clj/s

(async-log-factory ch)

AsyncLogger cljs

atomically! clj/s

(atomically! log-atom log-fn & args)

Accumulate log messages into an atom

This can frequently be more convenient than returning the updated state.

clean-fork clj/s

(clean-fork src child-context)

Fork the context/lamport clock without the logs.

Main use-case is exception handlers in weird side-effecty places where it isn't convenient to propagate a log line or 2 that will show up later.

composite-log-factory clj/s

(composite-log-factory loggers-to-combine)

CompositeWriter cljs

console-log-factory cljs

(console-log-factory)

ConsoleLogger cljs

debug clj/s≠

clj

(debug log-state__1133__auto__ label__1134__auto__)

(debug log-state__1133__auto__ label__1134__auto__ message__1135__auto__)

(debug log-state__1133__auto__
       label__1134__auto__
       message__1135__auto__
       details__1136__auto__)

cljs

(debug log-state__5271__auto__ label__5272__auto__)

(debug log-state__5271__auto__ label__5272__auto__ message__5273__auto__)

(debug log-state__5271__auto__
       label__5272__auto__
       message__5273__auto__
       details__5274__auto__)

do-sync-clock clj/s

(do-sync-clock remote-lamport)

Synchronize my clock with another's

Low-level function used to build do-synchronize-clock-with-state

do-synchronize-clock-with-state clj/s

(do-synchronize-clock-with-state state)

Coordinate state's clock with our internal counter

error clj/s≠

clj

(error log-state__1133__auto__ label__1134__auto__)

(error log-state__1133__auto__ label__1134__auto__ message__1135__auto__)

(error log-state__1133__auto__
       label__1134__auto__
       message__1135__auto__
       details__1136__auto__)

cljs

(error log-state__5271__auto__ label__5272__auto__)

(error log-state__5271__auto__ label__5272__auto__ message__5273__auto__)

(error log-state__5271__auto__
       label__5272__auto__
       message__5273__auto__
       details__5274__auto__)

exception clj/s

(exception log-state ex label)

(exception log-state ex label message)

(exception log-state ex label message original-details)

exception-details clj/s

(exception-details ex)

fatal clj/s≠

clj

(fatal log-state__1133__auto__ label__1134__auto__)

(fatal log-state__1133__auto__ label__1134__auto__ message__1135__auto__)

(fatal log-state__1133__auto__
       label__1134__auto__
       message__1135__auto__
       details__1136__auto__)

cljs

(fatal log-state__5271__auto__ label__5272__auto__)

(fatal log-state__5271__auto__ label__5272__auto__ message__5273__auto__)

(fatal log-state__5271__auto__
       label__5272__auto__
       message__5273__auto__
       details__5274__auto__)

file-writer-factory clj

(file-writer-factory file-name)

flush-atomically! clj/s

(flush-atomically! logger log-atom)

Flush an accumulation of log messages

flush-logs! clj/s

(flush-logs! logger {:keys [:frereth.weald.specs/context] :as log-state})

For the side-effects to write the accumulated logs.

Returns a fresh set of log entries

fork clj/s

(fork src)

(fork src child-context)

Return shape depends on arity

format-log-string clj/s

(format-log-string caller-stack-holder entry)

get-official-clock clj/s

(get-official-clock)

info clj/s≠

clj

(info log-state__1133__auto__ label__1134__auto__)

(info log-state__1133__auto__ label__1134__auto__ message__1135__auto__)

(info log-state__1133__auto__
      label__1134__auto__
      message__1135__auto__
      details__1136__auto__)

cljs

(info log-state__5271__auto__ label__5272__auto__)

(info log-state__5271__auto__ label__5272__auto__ message__5273__auto__)

(info log-state__5271__auto__
      label__5272__auto__
      message__5273__auto__
      details__5274__auto__)

init clj/s

(init context)

(init context start-clock)

merge-entries clj/s

(merge-entries xs ys)

Combine entries from two sets of logs

Note that this is a relatively expensive operation

merge-state clj/s

(merge-state x y)

Combine the entries of two log states

This is mostly meant for logs that have diverged from the same context.

std-err-log-factory clj

(std-err-log-factory)

std-out-log-factory clj

(std-out-log-factory)

stream-log-factory clj

(stream-log-factory stream)

synchronize clj/s

(synchronize {l-clock :frereth.weald.specs/lamport
              l-ctx :frereth.weald.specs/context
              :as lhs}
             {r-clock :frereth.weald.specs/lamport
              r-ctx :frereth.weald.specs/context
              :as rhs})

Fix 2 clocks that have probably drifted apart

trace clj/s≠

clj

(trace log-state__1133__auto__ label__1134__auto__)

(trace log-state__1133__auto__ label__1134__auto__ message__1135__auto__)

(trace log-state__1133__auto__
       label__1134__auto__
       message__1135__auto__
       details__1136__auto__)

cljs

(trace log-state__5271__auto__ label__5272__auto__)

(trace log-state__5271__auto__ label__5272__auto__ message__5273__auto__)

(trace log-state__5271__auto__
       label__5272__auto__
       message__5273__auto__
       details__5274__auto__)

warn clj/s≠

clj

(warn log-state__1133__auto__ label__1134__auto__)

(warn log-state__1133__auto__ label__1134__auto__ message__1135__auto__)

(warn log-state__1133__auto__
      label__1134__auto__
      message__1135__auto__
      details__1136__auto__)

cljs

(warn log-state__5271__auto__ label__5272__auto__)

(warn log-state__5271__auto__ label__5272__auto__ message__5273__auto__)

(warn log-state__5271__auto__
      label__5272__auto__
      message__5273__auto__
      details__5274__auto__)