PerlIO::via::Logger 1.01

PerlIO::via::Logger is a PerlIO layer for prefixing current time to log output. SYNOPSIS use PerlIO::via::Logger; PerlIO::via::Logger->format( [%b %d, %Y %r] ); use PerlIO::via::Logger format => [%b %d, %Y %r] ; open( my $in,<:via(Logger),filein ) or die "Cant open file.ln for reading: $!n"; open( my $out,>:via(Logger),fileout ) or die "Cant open file.ln for writing: $!n"; PerlIO::via::Logger::logify(*STDOUT); # redirect stdout in one line! PerlIO::via::Logger::logify(*openhandle); # or any other handle This module implements a PerlIO layer that prefixes the current time to each line of output or input. This module was created because I frequently need to use file logging systems in daemon-style Perl systems. This module was created to fulfill three requirements: 1. Must be low overhead/fast 2. Must be simple to use (i.e. print "something to logn") 3. Must be able to add a prefix to each line (times in my case) CLASS METHODS The following two class methods allow you to alter the prefix formatting string used by the I/O layer and to redirect existing filehandles with (almost) no effort. For convienance, class methods can also be called as key-value pairs in the use statement. This allows you to use this module in an "import and forget it" fashion. Please note that the new value of the class methods that are specified, only apply to the file handles that are opened (or to which the layer is assigned using binmode()) after they have been changed. format use PerlIO::via::Logger format => [%b %d, %Y %r] ; PerlIO::via::Logger->format( [%b %d, %Y %r] ); my $format = PerlIO::via::Logger->format; The class method format returns the format that will be used for adding the time to lines. The optional input parameter specifies the format that will be used for any files that are opened in the future. You should use only the conversion specifiers defined by the ANSI C standard (C89, to play safe). These are aAbBcdHIjmMpSUwWxXyYZ% . The default is [%b %d, %Y %H:%M:%S] , though the examples throughout this document use a more elegant - but less portable - format. logify PerlIO::via::Logger::logify( $filehandle ); PerlIO::via::Logger::logify( *WRITEFH ); PerlIO::via::Logger::logify( *STDOUT ); The class method logify exists purely for convenience and my personal use. I do not recommend using it unless your systems are for development only, or you understand how it works. In short it will reopen the given filehandle through the Logger I/O layer..

Requirements:	No special requirements
Platforms:	Linux
Keyword:	Class,  Class Methods,  Current,  Current Time,  Format,  Layer,  Libraries,  Perlio Layer,  Perliovialogger,  Programming,  Time
Users rating:	0/10