NAME

Log::Minimal::Instance - Instance based on Log::Minimal

SYNOPSIS

  use Log::Minimal::Instance;

  # log to file
  my $log = Log::Minimal::Instance->new(
      base_dir => 'log',
      pattern  => 'myapp.log.%Y%m%d',  # File::Stamped style
  );

  # same as Log::Minimal method
  $log->debugf('debug');
  $log->infof('info');

  # ./log/myapp.log.20130101
  2013-01-01T16:15:39 [DEBUG] debug at lib/MyApp.pm line 10
  2013-01-01T16:15:39 [INFO] info at lib/MyApp.pm line 11

  # log to stderr
  $log = Log::Minimal::Instance->new();

  # specified $Log::Minimal::LOG_LEVEL
  $log = Log::Minimal::Instance->new(
      level => 'WARN',
  );

  # original methods
  $log->infod(\%hash);
  $log->warnd(\@array);
  $log->log_to('finish.log.%Y%m%d', $message); # log to log/finish.log.20130101

DESCRIPTION

Log::Minimal::Instance is used in Log::Minimal based module to create an instance.

IMPORTED METHODS

See Log::Minimal

new(%args)

Create new instance of Log::Minimal::Instance based on Log::Minimal.

Attributes are following:

level

  Set to $Log::Minimal::LOG_LEVEL

base_dir

  Base directory for log file

pattern

  This is file name pattern that is same of L<File::Stamped>.

symlink

  Generate symlink file for log file.

callback

  See L<File::Stamped>.

close_after_write

  Default value is 1.

iomode

  Default value is '>>:utf8'.

autoflush

  Default value is true.

rotationtime

  Default value is true.

auto_make_dir

  Default value is false.

critf

warnf

infof

debugf

critff

warnff

infoff

debugff

ORIGINAL METHODS

critd($value)

warnd($value)

infod($value)

debugd($value)

When expressed in code the above methods:

  use Log::Minimal;
  infof( ddf(\%hash) );

log_to($pattern, $message)

log_to([ $pattern, $symlink ], $message)

log_to({ pattern => $pattern, symlink => $symlink, ... }, $message)

  # $pattern is File::Stamped style.
  $log->log_to('trace.log.%Y%m%d', 'traceroute');

  # ./log/trace.log.20130101
  2013-01-01T16:15:40 traceroute at lib/MyApp.pm line 13

  # with symlink
  $log->log_to([ 'trace.log.%Y%m%d', 'trace.log' ], 'blah blah blah');

AUTHOR

Kosuke Arisawa <arisawa {at} gmail.com>

COPYRIGHT

Copyright 2013- Kosuke Arisawa

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Log::Minimal

File::Stamped