NAME

       Mojo::Log - 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('Why is this not working?');
         $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');
         $log->on(message => sub {
           my ($log, $level, @lines) = @_;
           say "$level: ", @lines;
         });

ATTRIBUTES

       Mojo::Log implements the following attributes.

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

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

   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.

   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.

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

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

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

       Log debug message.

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

       Log error message.

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

       Log fatal message.

   format
         my $msg = $log->format(debug => 'Hi there!');
         my $msg = $log->format(debug => 'Hi', 'there!');

       Format log message.

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

       Log info message.

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

       Check log level.

   is_debug
         my $bool = $log->is_debug;

       Check for debug log level.

   is_error
         my $bool = $log->is_error;

       Check for error log level.

   is_fatal
         my $bool = $log->is_fatal;

       Check for fatal log level.

   is_info
         my $bool = $log->is_info;

       Check for info log level.

   is_warn
         my $bool = $log->is_warn;

       Check for warn log level.

   log
         $log = $log->log(debug => 'This should work.');
         $log = $log->log(debug => 'This', 'too!');

       Emit "message" event.

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

       Log warn message.

SEE ALSO

       Mojolicious, Mojolicious::Guides, <http://mojolicio.us>.