new¶

Arguments: "Dict[
levels => Optional[ArrayRef[Str]],
levels_upto => Level,
coderef => Optional[CodeRef], ] $conf"

  my $l = Log::Contextual::SimpleLogger->new({
    levels  => [qw( info warn )],
    coderef => sub { print @_ }, # the default prints to STDERR
  });

or

  my $l = Log::Contextual::SimpleLogger->new({
    levels_upto => 'debug',
    coderef     => sub { print @_ }, # the default prints to STDERR
  });

Creates a new SimpleLogger object with the passed levels enabled and optionally a "CodeRef" may be passed to modify how the logs are output/stored.

"levels_upto" enables all the levels up to and including the level passed.

Levels may contain:

  trace
  debug
  info
  warn
  error
  fatal

$level¶

Arguments: @anything

All of the following six methods work the same. The basic pattern is:

  sub $level {
    my $self = shift;
    print STDERR "[$level] " . join qq{\n}, @_;
      if $self->is_$level;
  }

trace

  $l->trace( 'entered method foo with args ' join q{,}, @args );

debug

  $l->debug( 'entered method foo' );

info

  $l->info( 'started process foo' );

warn

  $l->warn( 'possible misconfiguration at line 10' );

error

  $l->error( 'non-numeric user input!' );

fatal

  $l->fatal( '1 is never equal to 0!' );

Note: "fatal" does not call "die" for you, see "EXCEPTIONS AND ERROR HANDLING" in Log::Contextual

is_$level¶

All of the following six functions just return true if their respective level is enabled.

is_trace

  say 'tracing' if $l->is_trace;

is_debug

  say 'debuging' if $l->is_debug;

is_info

  say q{info'ing} if $l->is_info;

is_warn

  say 'warning' if $l->is_warn;

is_error

  say 'erroring' if $l->is_error;

is_fatal

  say q{fatal'ing} if $l->is_fatal;