frereth.weald.logging — frereth.weald 0.0.2

Functional logging mechanism

async-log-factory clj/s

(async-log-factory ch)

AsyncLogger cljs

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 logs-to-combine)

CompositeWriter cljs

console-log-factory cljs

(console-log-factory)

ConsoleLogger cljs

debug clj/s≠

clj

(debug log-state__1086__auto__ label__1087__auto__)

(debug log-state__1086__auto__ label__1087__auto__ message__1088__auto__)

(debug log-state__1086__auto__
       label__1087__auto__
       message__1088__auto__
       details__1089__auto__)

cljs

(debug log-state__6316__auto__ label__6317__auto__)

(debug log-state__6316__auto__ label__6317__auto__ message__6318__auto__)

(debug log-state__6316__auto__
       label__6317__auto__
       message__6318__auto__
       details__6319__auto__)

do-sync-clock clj/s

(do-sync-clock log-state)

Synchronize my clock with a state's

error clj/s≠

clj

(error log-state__1086__auto__ label__1087__auto__)

(error log-state__1086__auto__ label__1087__auto__ message__1088__auto__)

(error log-state__1086__auto__
       label__1087__auto__
       message__1088__auto__
       details__1089__auto__)

cljs

(error log-state__6316__auto__ label__6317__auto__)

(error log-state__6316__auto__ label__6317__auto__ message__6318__auto__)

(error log-state__6316__auto__
       label__6317__auto__
       message__6318__auto__
       details__6319__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__1086__auto__ label__1087__auto__)

(fatal log-state__1086__auto__ label__1087__auto__ message__1088__auto__)

(fatal log-state__1086__auto__
       label__1087__auto__
       message__1088__auto__
       details__1089__auto__)

cljs

(fatal log-state__6316__auto__ label__6317__auto__)

(fatal log-state__6316__auto__ label__6317__auto__ message__6318__auto__)

(fatal log-state__6316__auto__
       label__6317__auto__
       message__6318__auto__
       details__6319__auto__)

file-writer-factory clj

(file-writer-factory file-name)

flush-logs! clj/s

(flush-logs! logger {:keys [:frereth.weald/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__1086__auto__ label__1087__auto__)

(info log-state__1086__auto__ label__1087__auto__ message__1088__auto__)

(info log-state__1086__auto__
      label__1087__auto__
      message__1088__auto__
      details__1089__auto__)

cljs

(info log-state__6316__auto__ label__6317__auto__)

(info log-state__6316__auto__ label__6317__auto__ message__6318__auto__)

(info log-state__6316__auto__
      label__6317__auto__
      message__6318__auto__
      details__6319__auto__)

init clj/s

(init context)

(init context start-clock)

Logger clj/s≠ protocol

Extend this for logging side-effects

log! clj/s

(log! this msg)

At least queue up a log message to side-effect

flush! clj/s

(flush! this)

Some loggers need to do this at the end of a batch

merge-entries clj/s

(merge-entries xs ys)

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/lamport l-ctx :frereth.weald/context :as lhs}
  {r-clock :frereth.weald/lamport r-ctx :frereth.weald/context :as rhs})

Fix 2 clocks that have probably drifted apart

trace clj/s≠

clj

(trace log-state__1086__auto__ label__1087__auto__)

(trace log-state__1086__auto__ label__1087__auto__ message__1088__auto__)

(trace log-state__1086__auto__
       label__1087__auto__
       message__1088__auto__
       details__1089__auto__)

cljs

(trace log-state__6316__auto__ label__6317__auto__)

(trace log-state__6316__auto__ label__6317__auto__ message__6318__auto__)

(trace log-state__6316__auto__
       label__6317__auto__
       message__6318__auto__
       details__6319__auto__)

warn clj/s≠

clj

(warn log-state__1086__auto__ label__1087__auto__)

(warn log-state__1086__auto__ label__1087__auto__ message__1088__auto__)

(warn log-state__1086__auto__
      label__1087__auto__
      message__1088__auto__
      details__1089__auto__)

cljs

(warn log-state__6316__auto__ label__6317__auto__)

(warn log-state__6316__auto__ label__6317__auto__ message__6318__auto__)

(warn log-state__6316__auto__
      label__6317__auto__
      message__6318__auto__
      details__6319__auto__)