Karen Etheridge > Log-Dispatch-File-Stamped > Log::Dispatch::File::Stamped

Download:
Log-Dispatch-File-Stamped-0.15.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.15   Source  

NAME ^

Log::Dispatch::File::Stamped - Logging to date/time stamped files

VERSION ^

version 0.15

SYNOPSIS ^

  use Log::Dispatch::File::Stamped;

  my $file = Log::Dispatch::File::Stamped->new(
    name      => 'file1',
    min_level => 'info',
    filename  => 'Somefile.log',
    stamp_fmt => '%Y%m%d',
    mode      => 'append' );

  $file->log( level => 'emerg', message => "I've fallen and I can't get up\n" );

DESCRIPTION ^

This module subclasses Log::Dispatch::File for logging to date/time stamped files, respecting all its configuration options.

METHODS ^

new(%p)

This method takes the same set of parameters as Log::Dispatch::File::new(), with the following differences:

log_message( message => $ )

Sends a message to the appropriate output. Generally this shouldn't be called directly but should be called through the log() method (in Log::Dispatch::Output).

EXAMPLES ^

Assuming the current date and time is:

  % perl -e 'print scalar localtime'
  Sat Feb  8 13:56:13 2003

  Log::Dispatch::File::Stamped->new(
    name      => 'file',
    min_level => 'debug',
    filename  => 'logfile.txt',
  );

This will log to file logfile-20030208.txt.

  Log::Dispatch::File::Stamped->new(
    name      => 'file',
    min_level => 'debug',
    filename  => 'logfile.txt',
    stamp_fmt => '%d%H',
  );

This will log to file logfile-0813.txt.

SEE ALSO ^

Log::Dispatch::File, POSIX.

ACKNOWLEDGEMENTS ^

Dave Rolsky, author of the Log::Dispatch suite and many other fine modules on CPAN.

This module was rewritten to respect all present (and future) options to Log::Dispatch::File by Karen Etheridge, <ether@cpan.org>.

AUTHORS ^

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2003 by Karen Etheridge.

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

syntax highlighting: