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