NAME
Log::Deep::Read - Read and prettily display log files generated by Log::Deep
VERSION
This documentation refers to Log::Deep::Read version 0.0.2.
SYNOPSIS
use Log::Deep::Read;
# Brief but working code example(s) here showing the most common usage(s)
# This section will be as far as many users bother reading, so make it as
# educational and exemplary as possible.
DESCRIPTION
Provides the functionality to read and analyse log files written by Log::Deep
SUBROUTINES/METHODS
new ()
Return: Log::Deep::Read - A new Log::Deep::Read object
Description:
read_files ( @files )
Param: @files
- List of strings - A list of files to be read
Description: Reads and parses all the log files specified
read_file ( $file, $fh )
Param: $file
- string - The name of the file to read
Param: $fh
- File Handle - A (possibly) previously open file handle to $file.
Return: File Handle - The opened file handle
Description: Reads through the lines of $file
parse_line ( $line )
Param: $line
- string - Line from a Log::Deep log file
Return: Array - The elements of the log line
Description: Parses the log line and returns the data that the is stored on the log line.
show_line ( $time, $session, $level, $message, $data )
Params: The data for the current log line
Description: Determines if a line should be shown or not (checks the line against the filter)
display_line ( $time, $session, $level, $message, $data )
Params: The data for the current log line
Description: Actually prints out the line, colouring the out put as necessary.
session_colour ( $session_id )
Params: The session id that is to be coloured
Description: Colours session based on their ID's
DIAGNOSTICS
CONFIGURATION AND ENVIRONMENT
DEPENDENCIES
INCOMPATIBILITIES
BUGS AND LIMITATIONS
There are no known bugs in this module.
Please report problems to Ivan Wills (ivan.wills@gmail.com).
Patches are welcome.
AUTHOR
Ivan Wills - (ivan.wills@gmail.com)
LICENSE AND COPYRIGHT
Copyright (c) 2009 Ivan Wills (14 Mullion Close, Hornsby Heights, NSW 2077). All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.