Mojo::Log(3) Simple logger

SYNOPSIS


use Mojo::Log;
# Log to STDERR
my $log = Mojo::Log->new;
# Customize log file location and minimum log level
my $log = Mojo::Log->new(path => '/var/log/mojo.log', level => 'warn');
# Log messages
$log->debug('Not sure what is happening here');
$log->info('FYI: it happened again');
$log->warn('This might be a problem');
$log->error('Garden variety error');
$log->fatal('Boom');

DESCRIPTION

Mojo::Log is a simple logger for Mojo projects.

EVENTS

Mojo::Log inherits all events from Mojo::EventEmitter and can emit the following new ones.

message

  $log->on(message => sub {
    my ($log, $level, @lines) = @_;
    ...
  });

Emitted when a new message gets logged.

  $log->unsubscribe('message')->on(message => sub {
    my ($log, $level, @lines) = @_;
    say "$level: ", @lines;
  });

ATTRIBUTES

Mojo::Log implements the following attributes.

format

  my $cb = $log->format;
  $log   = $log->format(sub {...});

A callback for formatting log messages.

  $log->format(sub {
    my ($time, $level, @lines) = @_;
    return "[Thu May 15 17:47:04 2014] [info] I ♥ Mojolicious\n";
  });

handle

  my $handle = $log->handle;
  $log       = $log->handle(IO::Handle->new);

Log filehandle used by default ``message'' event, defaults to opening ``path'' or "STDERR".

history

  my $history = $log->history;
  $log        = $log->history([[time, 'debug', 'That went wrong']]);

The last few logged messages.

level

  my $level = $log->level;
  $log      = $log->level('debug');

Active log level, defaults to "debug". Available log levels are "debug", "info", "warn", "error" and "fatal", in that order. Note that the "MOJO_LOG_LEVEL" environment variable can override this value.

max_history_size

  my $size = $log->max_history_size;
  $log     = $log->max_history_size(5);

Maximum number of logged messages to store in ``history'', defaults to 10.

path

  my $path = $log->path
  $log     = $log->path('/var/log/mojo.log');

Log file path used by ``handle''.

METHODS

Mojo::Log inherits all methods from Mojo::EventEmitter and implements the following new ones.

append

  $log->append("[Thu May 15 17:47:04 2014] [info] I ♥ Mojolicious\n");

Append message to ``handle''.

debug

  $log = $log->debug('You screwed up, but that is ok');
  $log = $log->debug('All', 'cool');

Emit ``message'' event and log "debug" message.

error

  $log = $log->error('You really screwed up this time');
  $log = $log->error('Wow', 'seriously');

Emit ``message'' event and log "error" message.

fatal

  $log = $log->fatal('Its over...');
  $log = $log->fatal('Bye', 'bye');

Emit ``message'' event and log "fatal" message.

info

  $log = $log->info('You are bad, but you prolly know already');
  $log = $log->info('Ok', 'then');

Emit ``message'' event and log "info" message.

is_level

  my $bool = $log->is_level('debug');

Check active log ``level''.

  # True
  $log->level('debug')->is_level('debug');
  $log->level('debug')->is_level('info');
  # False
  $log->level('info')->is_level('debug');
  $log->level('fatal')->is_level('warn');

new

  my $log = Mojo::Log->new;

Construct a new Mojo::Log object and subscribe to ``message'' event with default logger.

warn

  $log = $log->warn('Dont do that Dave...');
  $log = $log->warn('No', 'really');

Emit ``message'' event and log "warn" message.