Instances of the Logger class represent a single logging channel. A
"logging channel" indicates an area of an application. Exactly
how an "area" is defined is up to the application developer.
Since an application can have any number of areas, logging channels are
identified by a unique string. Application areas can be nested (e.g. an
area of "input processing" might include sub-areas "read
CSV files", "read XLS files" and "read Gnumeric
files"). To cater for this natural nesting, channel names are
organized into a namespace hierarchy where levels are separated by
periods, much like the Java or Python package namespace. So in the
instance given above, channel names might be "input" for the
upper level, and "input.csv", "input.xls" and
"input.gnu" for the sub-levels. There is no arbitrary limit to
the depth of nesting.
|
__init__(self,
name,
level=0)
Initialize the logger with a name and an optional level. |
|
|
|
setLevel(self,
level)
Set the logging level of this logger. |
|
|
|
debug(self,
msg,
*args,
**kwargs)
Log 'msg % args' with severity 'DEBUG'. |
|
|
|
info(self,
msg,
*args,
**kwargs)
Log 'msg % args' with severity 'INFO'. |
|
|
|
warning(self,
msg,
*args,
**kwargs)
Log 'msg % args' with severity 'WARNING'. |
|
|
|
warn(self,
msg,
*args,
**kwargs)
Log 'msg % args' with severity 'WARNING'. |
|
|
|
error(self,
msg,
*args,
**kwargs)
Log 'msg % args' with severity 'ERROR'. |
|
|
|
exception(self,
msg,
*args)
Convenience method for logging an ERROR with exception information. |
|
|
|
critical(self,
msg,
*args,
**kwargs)
Log 'msg % args' with severity 'CRITICAL'. |
|
|
|
fatal(self,
msg,
*args,
**kwargs)
Log 'msg % args' with severity 'CRITICAL'. |
|
|
|
log(self,
level,
msg,
*args,
**kwargs)
Log 'msg % args' with the integer severity 'level'. |
|
|
|
findCaller(self)
Find the stack frame of the caller so that we can note the source
file name, line number and function name. |
|
|
|
makeRecord(self,
name,
level,
fn,
lno,
msg,
args,
exc_info,
func=None,
extra=None)
A factory method which can be overridden in subclasses to create
specialized LogRecords. |
|
|
|
_log(self,
level,
msg,
args,
exc_info=None,
extra=None)
Low-level logging routine which creates a LogRecord and then calls
all the handlers of this logger to handle the record. |
|
|
|
handle(self,
record)
Call the handlers for the specified record. |
|
|
|
addHandler(self,
hdlr)
Add the specified handler to this logger. |
|
|
|
removeHandler(self,
hdlr)
Remove the specified handler from this logger. |
|
|
|
callHandlers(self,
record)
Pass a record to all relevant handlers. |
|
|
|
|
|
isEnabledFor(self,
level)
Is this logger enabled for level 'level'? |
|
|
Inherited from Filterer :
addFilter ,
filter ,
removeFilter
|