Hierarchical structured logging format. Easy for humans, fast for computers.
This library provides types, parsers and renderers for df1.
Consider this a preview release: The API is likely to stay stable, but extensive
testing, formalization and tooling is due.
See the BSD3 LICENSE
file to learn about the legal terms and conditions for this library.
Changes
Version 0.2
BREAKING CHANGE: Segment, Key, Value and Message don’t strip
surrounding whitespace anymore. When rendering Segment, Key and Value,
the whitespace will be percent-encoded. When rendering Message, the
whitespace will be kept as is.
BREAKING CHANGE: Segment and Key now wrap lazy Text, rather than strict
Text. This is to align their APIs with Value and Message, which already
wrapped lazy Text so as to prevent logged Values and Messages from
to use much memory. It’s unlikely that Segments and Keys are affected by
this, since in practice they are almost always created statically. So, this
change is mostly to make the API less surprising to users: Lazy Text is used
throughout.
Added draft BNF specification.
Version 0.1.2
Fixed escaping of control characters in Message.
Percent-escape less punctuation characters when rendering Key,
Segment and Value.
TODO: write spec.
Version 0.1.1
Fixed compilation.
Version 0.1
Consider this a preview release: The API is likely to stay stable, but
extensive testing, formalization and tooling is due.