Log::Deep::Read - Read and prettily display log files generated by Log::Deep


NAME

Log::Deep::Read - Read and prettily display log files generated by Log::Deep

Back to Top


VERSION

This documentation refers to Log::Deep::Read version 0.1.0.

Back to Top


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.

Back to Top


DESCRIPTION

Provides the functionality to read and analyse log files written by Log::Deep

Back to Top


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.

display_data ( $data )

Param: $data - hash ref - The data to be displayed

Description: Displays the log lines data based on the display rules set up when the object was created.

session_colour ( $session_id )

Params: The session id that is to be coloured

Description: Colours session based on their ID's

Back to Top


DIAGNOSTICS

Back to Top


CONFIGURATION AND ENVIRONMENT

Back to Top


DEPENDENCIES

Back to Top


INCOMPATIBILITIES

Back to Top


BUGS AND LIMITATIONS

There are no known bugs in this module.

Please report problems to Ivan Wills (ivan.wills@gmail.com)

Patches are welcome.

Back to Top


AUTHOR

Ivan Wills - (ivan.wills@gmail.com)

Back to Top


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.

Back to Top

 Log::Deep::Read - Read and prettily display log files generated by Log::Deep