Log::Emitter - Simple logger
use Log::Emitter;
# Log to STDERR
my $log = Log::Emitter->new;
# Customize log file location and minimum log level
my $log = Log::Emitter->new(path => '/var/log/emitter.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');
Log::Emitter is a simple logger based on Mojo::Log.
Log::Emitter is compatible with Log::Contextual for global logging.
use Log::Emitter;
use Log::Contextual ':log', 'set_logger', -levels => [qw(debug info warn error fatal)];
set_logger(Log::Emitter->new);
log_info { "Here's some info" };
log_error { "Uh-oh, error occured" };
Log::Emitter composes all events from Role::EventEmitter in addition to emitting the following.
$log->on(message => sub {
my ($log, $level, @lines) = @_;
...
});
Emitted when a new message gets logged.
$log->unsubscribe('message');
$log->on(message => sub {
my ($log, $level, @lines) = @_;
say "$level: ", @lines;
});
Log::Emitter implements the following attributes.
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 ♥ Logging\n";
});
my $handle = $log->handle;
$log = $log->handle(IO::Handle->new);
Log filehandle used by default "message" event, defaults to opening "path" or STDERR
. Reset when "path" is set.
my $history = $log->history;
$log = $log->history([[time, 'debug', 'That went wrong']]);
The last few logged messages.
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 LOG_EMITTER_LEVEL
environment variable can override this value.
my $size = $log->max_history_size;
$log = $log->max_history_size(5);
Maximum number of logged messages to store in "history", defaults to 10
.
my $path = $log->path
$log = $log->path('/var/log/emitter.log');
Log file path used by "handle". Setting this attribute will reset "handle".
Log::Emitter composes all methods from Role::EventEmitter in addition to the following.
my $log = Log::Emitter->new;
Construct a new Log::Emitter object and subscribe to "message" event with default logger.
$log->append("[Thu May 15 17:47:04 2014] [info] I ♥ Logging\n");
Append message to "handle".
$log = $log->debug('You screwed up, but that is ok');
$log = $log->debug('All', 'cool');
Emit "message" event and log debug message.
$log = $log->error('You really screwed up this time');
$log = $log->error('Wow', 'seriously');
Emit "message" event and log error message.
$log = $log->fatal('Its over...');
$log = $log->fatal('Bye', 'bye');
Emit "message" event and log fatal message.
$log = $log->info('You are bad, but you prolly know already');
$log = $log->info('Ok', 'then');
Emit "message" event and log info message.
my $bool = $log->is_debug;
Check for debug log level.
my $bool = $log->is_error;
Check for error log level.
my $bool = $log->is_fatal;
Always true.
my $bool = $log->is_info;
Check for info log level.
my $bool = $log->is_warn;
Check for warn log level.
$log = $log->warn('Dont do that Dave...');
$log = $log->warn('No', 'really');
Emit "message" event and log warn message.
Report any issues on the public bugtracker.
Dan Book <[email protected]>
This software is Copyright (c) 2015 by Dan Book.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)