Log::Contextual::SimpleLogger - Super simple logger made for playing with Log::Contextual
version 0.006005
use Log::Contextual::SimpleLogger; use Log::Contextual qw( :log ), -logger => Log::Contextual::SimpleLogger->new({ levels => [qw( debug )]}); log_info { 'program started' }; # no-op because info is not in levels sub foo { log_debug { 'entered foo' }; ... }
This module is a simple logger made mostly for demonstration and initial experimentation with Log::Contextual. We recommend you use a real logger instead. For something more serious but not overly complicated, take a look at Log::Dispatchouli.
Arguments: Dict[ levels => Optional[ArrayRef[Str]], levels_upto => Level, coderef => Optional[CodeRef], ] $conf
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.
CodeRef
levels_upto enables all the levels upto and including the level passed.
levels_upto
Levels may contain:
trace debug info warn error fatal
Arguments: @anything
@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; }
$l->trace( 'entered method foo with args ' join q{,}, @args );
$l->debug( 'entered method foo' );
$l->info( 'started process foo' );
$l->warn( 'possible misconfiguration at line 10' );
$l->error( 'non-numeric user input!' );
$l->fatal( '1 is never equal to 0!' );
All of the following six functions just return true if their respective level is enabled.
say 'tracing' if $l->is_trace;
say 'debuging' if $l->is_debug;
say q{info'ing} if $l->is_info;
say 'warning' if $l->is_warn;
say 'erroring' if $l->is_error;
say q{fatal'ing} if $l->is_fatal;
Arthur Axel "fREW" Schmidt <frioux+cpan@gmail.com>
This software is copyright (c) 2015 by Arthur Axel "fREW" Schmidt.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Log::Contextual, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Log::Contextual
CPAN shell
perl -MCPAN -e shell install Log::Contextual
For more information on module installation, please visit the detailed CPAN module installation guide.