co-log-simple

Simple enhancements for logging with co-log

Stackage Nightly 2025-09-13:1.2.1
Latest on Hackage:1.2.1

See all snapshots co-log-simple appears in

ISC licensed by Dino Morelli
Maintained by [email protected]
This version can be pinned in stack with:co-log-simple-1.2.1@sha256:06ebeac192454fd681e669f9d16f0beaf0aa033982dbebcd34bec1cfafd7fa12,1793

Module documentation for 1.2.1

Used by 1 package in nightly-2025-09-13(full list with versions):

co-log-simple

Synopsis

Simple enhancements for logging with co-log

Description

A library built upon co-log that makes constructing and using LogActions simpler with some predefined formatters and a slightly enhanced Severity type

This library expresses some logging needs that recur in my work:

  1. Often I want more than one type of “info” severity to differentiate between more- or less-chatty output that’s not debug or warning/error related. This library includes a new Severity type that adds Notice between Info and Warning.
  2. I’ve often wanted different colors for severities which is much easier with co-log than hslogger
  3. This library also includes some functions for formatting different parts of a log message like the severity, stack info, or the message itself. These formatters can be composed together with the (%) and (%+) operators.

Additionally:

I found using the RichMsg/RichMessage types in co-log to be slightly on the complicated side to use. This library integrates timestamping through those types as well to make things easier while keeping the interface simple.

co-log-simple uses the ISO8601 with zone offset format for timestamps by default which I like because it sorts. The time formatters in this library also support custom format strings as defined in the Data.Time.Format module in the base time library.

For usage examples, see src/examples/Main.hs and the API docs for Colog.Simple

Development

Source code is available from Codeberg at the co-log-simple project page.

Handy command to generate Haddock docs during development if using stack. This constrains doc generation to modules in the library:

$ stack haddock --haddock --no-haddock-deps

Contact

Dino Morelli [email protected]

Changes

1.2.1 (2025-09-11)

  • Fixed a dependency problem affecting release to Stackage

1.2.0 (2025-09-10)

  • Added and adjusted some documentation
  • Some subtle formatter changes
  • Added str formatter for constant strings in log messages
  • Pushed stackage snapshot up to lts-24.9
  • Added timestamps to logging (via RichMessage/RichMsg)
  • Added date formatting capability to the date formatters

1.1.1 (2025-08-12)

  • Fixed incorrect API docs

1.1.0 (2025-08-11)

  • Exciting new formatter design, deprecated older formatters
  • Fixed various documentation issues
  • Added cabal categories

1.0.0 (2025-08-07)

  • Initial release