NAME

Log::Dispatch::CronoDir - Log dispatcher for logging to time-based directories

SYNOPSIS

use Log::Dispatch::CronoDir;

my $log = Log::Dispatch::CronoDir->new(
    dirname_pattern => '/var/log/%Y/%m/%d',
    permissions     => 0777,
    filename        => 'output.log',
    mode            => '>>:unix',
    binmode         => ':utf8',
    autoflush       => 1,
);

# Write log to file `/var/log/2000/01/01/output.log`
$log->log(level => 'error', message => 'Something has happened');

DESCRIPTION

Log::Dispatch::CronoDir is a file log dispatcher with time-based directory management.

METHODS

new(Hash %args)

Creates an instance. Accepted hash keys are:

• dirname_pattern => Str

  Directory name pattern where log files to be written to. POSIX strftime's conversion characters %Y, %m, and %d are currently accepted.

• permissions => Octal

  Directory permissions when specified directory does not exist. Optional. When not specified, creating directory's permissions are based on current umask.

  Note that this won't work on Windows OS.

• filename => Str

  Log file name to be written in the directory.

• mode => Str

  Mode to be used when opening a file handle. Default: ">>"

• binmode => Str

  Binmode to specify with binmode. Optional. Default: None

• autoflush => Bool

  Enable or disable autoflush. Default: 1

log(Hash %args)

Writes log to file.

• level => Str

  Log level.

• message => Str

  A message to write to log file.

SEE ALSO

Log::Dispatch

LICENSE

Copyright (C) yowcow.

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

AUTHOR

yowcow yowcow@cpan.org