NAME

Bot::Cobalt::Logger - Log handler for Bot::Cobalt

SYNOPSIS

  my $logger = Bot::Cobalt::Logger->new(
    ## Required, one of: debug info warn error
    level => 'info',
  
    ## Optional, passed to Bot::Cobalt::Logger::Output
    time_format => "%Y/%m/%d %H:%M:%S"
    log_format  => "%time% %pkg% (%level%) %msg%"
  );

  ## Add outputs
  ## (See Bot::Cobalt::Logger::Output for details)
  $logger->output->add(
    'Output::File' =>
      { file => $path_to_log },

    'Output::Term' =>
      { },
  );

  ## Log messages
  $logger->debug("Debugging message", @more_info );
  $logger->info("Informative message");
  $logger->warn("Warning message");
  $logger->error("Error message");

DESCRIPTION

This is the log handler for Bot::Cobalt.

Configured outputs must be added before log messages actually go anywhere (see the "SYNOPSIS"). See Bot::Cobalt::Logger::Output for details.

Log Levels

A level is required at construction-time; messages logged to the specified level or any level below it will be recorded.

For example, a level of 'warn' will discard log messages to 'debug' and 'info' and report only 'warn' and 'error' messages.

Valid levels, from high to low:

  debug
  info
  warn
  error

These should be called as methods to log to the appropriate level:

  $logger->info("This is some information");

If a list is provided, it will be concatenated with an empty space between items:

  $logger->info("Some info", "more info");

Methods

level

Returns the currently tracked log level.

set_level

Changes the current log level.

time_format

Sets a date/time formatting string to be fed to strftime -- see Bot::Cobalt::Logger::Output

log_format

Sets a formatting template string for log messages -- see Bot::Cobalt::Logger::Output

output

Returns the Bot::Cobalt::Logger::Output object.

AUTHOR

Jon Portnoy <avenj@cobaltirc.org>