composite_logger.cr

Logger interface to write to multiple loggers for Crystal.

logger = CompositeLogger.new(loggers)
logger.info("hello")
# => (stdout) "hello"
# => (a file) "hello"

In addition, this add a Logger#formatter=(str : String) method to core library. See: src/ext/logger.cr

Installation

Add this to your application's shard.yml:

dependencies:
  composite_logger:
    github: maiha/composite_logger.cr
    version: 0.3.2

Usage

require "composite_logger"

logging to both File and STDOUT

loggers = [
  Logger.new(STDOUT),
  Logger.new(File.open("app.log")),
]
logger = CompositeLogger.new(loggers)
logger.info("hello")

in memory logging

memory: option provides a handy in-memory logging.

loggers = [Logger.new(STDOUT)]
logger = CompositeLogger.new(loggers, memory: Logger::ERROR)
...
unless logger.memory.to_s.empty?
  STDERR.puts "Some errors occurred while running program."
  exit -1
end

Logger#level=(str : String)

This library enhanced stdlib Logger#level= to accept level string for handy accessor.

logger = Logger.new(nil)
logger.level = "DEBUG"

Logger#formatter=(fmt : String)

This library enhanced stdlib Logger#formtter= to accept format string.

The traditional way to set formatter is not pretty.

logger.formatter = Logger::Formatter.new do |severity, datetime, progname, message, io|
  io << severity.to_s << "," << message
end
logger.info "foo" # => "INFO,foo\n"

This can be simply refactored by {{KEYWORD(=FORMAT)}} as follows.

logger.formatter = "{{severity}},{{message}}"
logger.info "foo" # => "INFO,foo\n"

available keywords

Keyword	Alias	Converted to	Example
{{level}}	severity	severity	"INFO"
{{level=[%-5s]}}		severity	"[INFO ]"
{{mark}}		severity.to_s[0]	"I"
{{time}}	datetime	datetime	"2019-01-24 21:03:45"
{{time=%H:%M}}		datetime.to_s("...")	"21:03"
{{prog}}	progname	progname	"main"
{{message}}		message	"foo"
{{pid=%6s}}		Process.pid	" 5361"
{{xxx}}		(leaves unknowns)	"{{xxx}}"

The default formatter in stdlib can be represented as follows.

"{{mark}}, [{{time}}\#{{pid}}] {{prog=%s: }}{{message}}"

Logger#colorize = true

This library enhanced stdlib Logger to colorize messages.

• ERROR, FATAL: red
• WARN: yellow

This is enabled only when colorize == true and above formatter= is used.

logger.formatter = "{{message}}"
logger.colorize = true
logger.error "foo" # => "\e[31mfoo\e[0m\n"

Contributing

1. Fork it (https://github.com/maiha/composite_logger.cr/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• maiha(https://github.com/maiha) maiha - creator, maintainer