Package epydoc :: Module log :: Class Logger

Class Logger

An abstract base class that defines the interface for loggers, which are used by epydoc to report information back to the user. Loggers are responsible for tracking two types of information:

Messages, such as warnings and errors.
Progress on the current task.

This abstract class allows the command-line interface and the graphical interface to each present this information to the user in the way that's most natural for each interface. To set up a logger, create a subclass of Logger that overrides all methods, and register it using register_logger.

Instance Methods

[hide private]

log(self, level, message)
Display a message.

source code

close(self)
Perform any tasks needed to close this logger.

source code

start_block(self, header)
Start a new message block.

source code

end_block(self)
End a warning block.

source code

start_progress(self, header=None)
Begin displaying progress for a new task.

source code
call graph

end_progress(self)
Finish off the display of progress for the current task.

source code
call graph

progress(self, percent, message='')
Update the progress display. source code
call graph

Method Details

[hide private]

log(self, level, message)

source code

Display a message.

Parameters:

message - The message string to display. message may contain newlines, but does not need to end in a newline.
level - An integer value indicating the severity of the message.

start_block(self, header)

source code

Start a new message block. Any calls to info(), warning(), or error() that occur between a call to start_block and a corresponding call to end_block will be grouped together, and displayed with a common header. start_block can be called multiple times (to form nested blocks), but every call to start_block must be balanced by a call to end_block.

end_block(self)

source code

End a warning block. See start_block for details.

start_progress(self, header=None)

source code
call graph

Begin displaying progress for a new task. header is a description of the task for which progress is being reported. Each call to start_progress must be followed by a call to end_progress (with no intervening calls to start_progress).

end_progress(self)

source code
call graph

Finish off the display of progress for the current task. See start_progress for more information.

progress(self, percent, message=`''`)

source code
call graph

Update the progress display.

Parameters:

percent - A float from 0.0 to 1.0, indicating how much progress has been made.
message - A message indicating the most recent action that contributed towards that progress.

Class Logger

log(self, level, message)

start_block(self, header)

end_block(self)

start_progress(self, header=None)

end_progress(self)

progress(self, percent, message='')

progress(self, percent, message=`''`)