[mirror_edk2.git] / BaseTools / Source / Python / UPT / Logger / Log.py

## @file\r
# This file implements the log mechanism for Python tools.\r
#\r
# Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>\r
#\r
# SPDX-License-Identifier: BSD-2-Clause-Patent\r
#\r
\r
'''\r
Logger\r
'''\r
\r
## Import modules\r
from sys import argv\r
from sys import stdout\r
from sys import stderr\r
import os.path\r
from os import remove\r
from logging import getLogger\r
from logging import Formatter\r
from logging import StreamHandler\r
from logging import FileHandler\r
from traceback import extract_stack\r
\r
from Logger.ToolError import FatalError\r
from Logger.ToolError import WARNING_AS_ERROR\r
from Logger.ToolError import gERROR_MESSAGE\r
from Logger.ToolError import UNKNOWN_ERROR\r
from Library import GlobalData\r
\r
#\r
# Log level constants\r
#\r
DEBUG_0 = 1\r
DEBUG_1 = 2\r
DEBUG_2 = 3\r
DEBUG_3 = 4\r
DEBUG_4 = 5\r
DEBUG_5 = 6\r
DEBUG_6 = 7\r
DEBUG_7 = 8\r
DEBUG_8 = 9\r
DEBUG_9 = 10\r
VERBOSE = 15\r
INFO    = 20\r
WARN    = 30\r
QUIET   = 40\r
QUIET_1 = 41\r
ERROR   = 50\r
SILENT  = 60\r
\r
IS_RAISE_ERROR = True\r
SUPRESS_ERROR = False\r
\r
#\r
# Tool name\r
#\r
_TOOL_NAME = os.path.basename(argv[0])\r
#\r
# For validation purpose\r
#\r
_LOG_LEVELS = [DEBUG_0, DEBUG_1, DEBUG_2, DEBUG_3, DEBUG_4, DEBUG_5, DEBUG_6, \\r
              DEBUG_7, DEBUG_8, DEBUG_9, VERBOSE, WARN, INFO, ERROR, QUIET, \\r
              QUIET_1, SILENT]\r
#\r
# For DEBUG level (All DEBUG_0~9 are applicable)\r
#\r
_DEBUG_LOGGER = getLogger("tool_debug")\r
_DEBUG_FORMATTER = Formatter("[%(asctime)s.%(msecs)d]: %(message)s", \\r
                            datefmt="%H:%M:%S")\r
#\r
# For VERBOSE, INFO, WARN level\r
#\r
_INFO_LOGGER = getLogger("tool_info")\r
_INFO_FORMATTER = Formatter("%(message)s")\r
#\r
# For ERROR level\r
#\r
_ERROR_LOGGER = getLogger("tool_error")\r
_ERROR_FORMATTER = Formatter("%(message)s")\r
\r
#\r
# String templates for ERROR/WARN/DEBUG log message\r
#\r
_ERROR_MESSAGE_TEMPLATE = \\r
('\n\n%(tool)s...\n%(file)s(%(line)s): error %(errorcode)04X: %(msg)s\n\t%(extra)s')\r
\r
__ERROR_MESSAGE_TEMPLATE_WITHOUT_FILE = \\r
'\n\n%(tool)s...\n : error %(errorcode)04X: %(msg)s\n\t%(extra)s'\r
\r
_WARNING_MESSAGE_TEMPLATE = '%(tool)s...\n%(file)s(%(line)s): warning: %(msg)s'\r
_WARNING_MESSAGE_TEMPLATE_WITHOUT_FILE = '%(tool)s: : warning: %(msg)s'\r
_DEBUG_MESSAGE_TEMPLATE = '%(file)s(%(line)s): debug: \n    %(msg)s'\r
\r
\r
#\r
# Log INFO message\r
#\r
#Info    = _INFO_LOGGER.info\r
\r
def Info(msg, *args, **kwargs):\r
    _INFO_LOGGER.info(msg, *args, **kwargs)\r
\r
#\r
# Log information which should be always put out\r
#\r
def Quiet(msg, *args, **kwargs):\r
    _ERROR_LOGGER.error(msg, *args, **kwargs)\r
\r
## Log debug message\r
#\r
#   @param  Level       DEBUG level (DEBUG0~9)\r
#   @param  Message     Debug information\r
#   @param  ExtraData   More information associated with "Message"\r
#\r
def Debug(Level, Message, ExtraData=None):\r
    if _DEBUG_LOGGER.level > Level:\r
        return\r
    if Level > DEBUG_9:\r
        return\r
    #\r
    # Find out the caller method information\r
    #\r
    CallerStack = extract_stack()[-2]\r
    TemplateDict = {\r
        "file"      : CallerStack[0],\r
        "line"      : CallerStack[1],\r
        "msg"       : Message,\r
    }\r
\r
    if ExtraData is not None:\r
        LogText = _DEBUG_MESSAGE_TEMPLATE % TemplateDict + "\n    %s" % ExtraData\r
    else:\r
        LogText = _DEBUG_MESSAGE_TEMPLATE % TemplateDict\r
\r
    _DEBUG_LOGGER.log(Level, LogText)\r
\r
## Log verbose message\r
#\r
#   @param  Message     Verbose information\r
#\r
def Verbose(Message):\r
    return _INFO_LOGGER.log(VERBOSE, Message)\r
\r
## Log warning message\r
#\r
#   Warning messages are those which might be wrong but won't fail the tool.\r
#\r
#   @param  ToolName    The name of the tool. If not given, the name of caller\r
#                       method will be used.\r
#   @param  Message     Warning information\r
#   @param  File        The name of file which caused the warning.\r
#   @param  Line        The line number in the "File" which caused the warning.\r
#   @param  ExtraData   More information associated with "Message"\r
#\r
def Warn(ToolName, Message, File=None, Line=None, ExtraData=None):\r
    if _INFO_LOGGER.level > WARN:\r
        return\r
    #\r
    # if no tool name given, use caller's source file name as tool name\r
    #\r
    if ToolName is None or ToolName == "":\r
        ToolName = os.path.basename(extract_stack()[-2][0])\r
\r
    if Line is None:\r
        Line = "..."\r
    else:\r
        Line = "%d" % Line\r
\r
    TemplateDict = {\r
        "tool"      : ToolName,\r
        "file"      : File,\r
        "line"      : Line,\r
        "msg"       : Message,\r
    }\r
\r
    if File is not None:\r
        LogText = _WARNING_MESSAGE_TEMPLATE % TemplateDict\r
    else:\r
        LogText = _WARNING_MESSAGE_TEMPLATE_WITHOUT_FILE % TemplateDict\r
\r
    if ExtraData is not None:\r
        LogText += "\n    %s" % ExtraData\r
\r
    _INFO_LOGGER.log(WARN, LogText)\r
    #\r
    # Raise an exception if indicated\r
    #\r
    if GlobalData.gWARNING_AS_ERROR == True:\r
        raise FatalError(WARNING_AS_ERROR)\r
\r
## Log ERROR message\r
#\r
# Once an error messages is logged, the tool's execution will be broken by\r
# raising an exception. If you don't want to break the execution later, you\r
# can give "RaiseError" with "False" value.\r
#\r
#   @param  ToolName    The name of the tool. If not given, the name of caller\r
#                       method will be used.\r
#   @param  ErrorCode   The error code\r
#   @param  Message     Warning information\r
#   @param  File        The name of file which caused the error.\r
#   @param  Line        The line number in the "File" which caused the warning.\r
#   @param  ExtraData   More information associated with "Message"\r
#   @param  RaiseError  Raise an exception to break the tool's execution if\r
#                       it's True. This is the default behavior.\r
#\r
def Error(ToolName, ErrorCode, Message=None, File=None, Line=None, \\r
          ExtraData=None, RaiseError=IS_RAISE_ERROR):\r
    if ToolName:\r
        pass\r
    if Line is None:\r
        Line = "..."\r
    else:\r
        Line = "%d" % Line\r
\r
    if Message is None:\r
        if ErrorCode in gERROR_MESSAGE:\r
            Message = gERROR_MESSAGE[ErrorCode]\r
        else:\r
            Message = gERROR_MESSAGE[UNKNOWN_ERROR]\r
\r
    if ExtraData is None:\r
        ExtraData = ""\r
\r
    TemplateDict = {\r
        "tool"      : _TOOL_NAME,\r
        "file"      : File,\r
        "line"      : Line,\r
        "errorcode" : ErrorCode,\r
        "msg"       : Message,\r
        "extra"     : ExtraData\r
    }\r
\r
    if File is not None:\r
        LogText =  _ERROR_MESSAGE_TEMPLATE % TemplateDict\r
    else:\r
        LogText = __ERROR_MESSAGE_TEMPLATE_WITHOUT_FILE % TemplateDict\r
\r
    if not SUPRESS_ERROR:\r
        _ERROR_LOGGER.log(ERROR, LogText)\r
    if RaiseError:\r
        raise FatalError(ErrorCode)\r
\r
\r
## Initialize log system\r
#\r
def Initialize():\r
    #\r
    # Since we use different format to log different levels of message into\r
    # different place (stdout or stderr), we have to use different "Logger"\r
    # objects to do this.\r
    #\r
    # For DEBUG level (All DEBUG_0~9 are applicable)\r
    _DEBUG_LOGGER.setLevel(INFO)\r
    _DebugChannel = StreamHandler(stdout)\r
    _DebugChannel.setFormatter(_DEBUG_FORMATTER)\r
    _DEBUG_LOGGER.addHandler(_DebugChannel)\r
    #\r
    # For VERBOSE, INFO, WARN level\r
    #\r
    _INFO_LOGGER.setLevel(INFO)\r
    _InfoChannel = StreamHandler(stdout)\r
    _InfoChannel.setFormatter(_INFO_FORMATTER)\r
    _INFO_LOGGER.addHandler(_InfoChannel)\r
    #\r
    # For ERROR level\r
    #\r
    _ERROR_LOGGER.setLevel(INFO)\r
    _ErrorCh = StreamHandler(stderr)\r
    _ErrorCh.setFormatter(_ERROR_FORMATTER)\r
    _ERROR_LOGGER.addHandler(_ErrorCh)\r
\r
\r
## Set log level\r
#\r
#   @param  Level   One of log level in _LogLevel\r
#\r
def SetLevel(Level):\r
    if Level not in _LOG_LEVELS:\r
        Info("Not supported log level (%d). Use default level instead." % \\r
             Level)\r
        Level = INFO\r
    _DEBUG_LOGGER.setLevel(Level)\r
    _INFO_LOGGER.setLevel(Level)\r
    _ERROR_LOGGER.setLevel(Level)\r
\r
## Get current log level\r
#\r
def GetLevel():\r
    return _INFO_LOGGER.getEffectiveLevel()\r
\r
## Raise up warning as error\r
#\r
def SetWarningAsError():\r
    GlobalData.gWARNING_AS_ERROR = True\r
\r
## Specify a file to store the log message as well as put on console\r
#\r
#   @param  LogFile     The file path used to store the log message\r
#\r
def SetLogFile(LogFile):\r
    if os.path.exists(LogFile):\r
        remove(LogFile)\r
\r
    _Ch = FileHandler(LogFile)\r
    _Ch.setFormatter(_DEBUG_FORMATTER)\r
    _DEBUG_LOGGER.addHandler(_Ch)\r
\r
    _Ch = FileHandler(LogFile)\r
    _Ch.setFormatter(_INFO_FORMATTER)\r
    _INFO_LOGGER.addHandler(_Ch)\r
\r
    _Ch = FileHandler(LogFile)\r
    _Ch.setFormatter(_ERROR_FORMATTER)\r
    _ERROR_LOGGER.addHandler(_Ch)\r
\r
\r
\r
Commit	Line	Data
f51461c8 LG	1	## @file\r
	2	# This file implements the log mechanism for Python tools.\r
	3	#\r
f7496d71	4	# Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>\r
f51461c8	5	#\r
2e351cbe	6	# SPDX-License-Identifier: BSD-2-Clause-Patent\r
f51461c8 LG	7	#\r
	8	\r
	9	'''\r
	10	Logger\r
	11	'''\r
	12	\r
	13	## Import modules\r
	14	from sys import argv\r
	15	from sys import stdout\r
	16	from sys import stderr\r
	17	import os.path\r
	18	from os import remove\r
	19	from logging import getLogger\r
	20	from logging import Formatter\r
	21	from logging import StreamHandler\r
	22	from logging import FileHandler\r
	23	from traceback import extract_stack\r
	24	\r
	25	from Logger.ToolError import FatalError\r
	26	from Logger.ToolError import WARNING_AS_ERROR\r
	27	from Logger.ToolError import gERROR_MESSAGE\r
	28	from Logger.ToolError import UNKNOWN_ERROR\r
	29	from Library import GlobalData\r
	30	\r
	31	#\r
	32	# Log level constants\r
	33	#\r
	34	DEBUG_0 = 1\r
	35	DEBUG_1 = 2\r
	36	DEBUG_2 = 3\r
	37	DEBUG_3 = 4\r
	38	DEBUG_4 = 5\r
	39	DEBUG_5 = 6\r
	40	DEBUG_6 = 7\r
	41	DEBUG_7 = 8\r
	42	DEBUG_8 = 9\r
	43	DEBUG_9 = 10\r
	44	VERBOSE = 15\r
	45	INFO = 20\r
	46	WARN = 30\r
	47	QUIET = 40\r
	48	QUIET_1 = 41\r
	49	ERROR = 50\r
	50	SILENT = 60\r
	51	\r
	52	IS_RAISE_ERROR = True\r
	53	SUPRESS_ERROR = False\r
	54	\r
	55	#\r
	56	# Tool name\r
	57	#\r
	58	_TOOL_NAME = os.path.basename(argv[0])\r
	59	#\r
	60	# For validation purpose\r
	61	#\r
	62	_LOG_LEVELS = [DEBUG_0, DEBUG_1, DEBUG_2, DEBUG_3, DEBUG_4, DEBUG_5, DEBUG_6, \\r
	63	DEBUG_7, DEBUG_8, DEBUG_9, VERBOSE, WARN, INFO, ERROR, QUIET, \\r
	64	QUIET_1, SILENT]\r
	65	#\r
	66	# For DEBUG level (All DEBUG_0~9 are applicable)\r
	67	#\r
	68	_DEBUG_LOGGER = getLogger("tool_debug")\r
	69	_DEBUG_FORMATTER = Formatter("[%(asctime)s.%(msecs)d]: %(message)s", \\r
	70	datefmt="%H:%M:%S")\r
71	#\r
72	# For VERBOSE, INFO, WARN level\r
73	#\r
74	_INFO_LOGGER = getLogger("tool_info")\r
75	_INFO_FORMATTER = Formatter("%(message)s")\r
76	#\r
77	# For ERROR level\r
78	#\r
79	_ERROR_LOGGER = getLogger("tool_error")\r
80	_ERROR_FORMATTER = Formatter("%(message)s")\r
81	\r
82	#\r
83	# String templates for ERROR/WARN/DEBUG log message\r
84	#\r
85	_ERROR_MESSAGE_TEMPLATE = \\r
86	('\n\n%(tool)s...\n%(file)s(%(line)s): error %(errorcode)04X: %(msg)s\n\t%(extra)s')\r
87	\r
88	__ERROR_MESSAGE_TEMPLATE_WITHOUT_FILE = \\r
89	'\n\n%(tool)s...\n : error %(errorcode)04X: %(msg)s\n\t%(extra)s'\r
90	\r
91	_WARNING_MESSAGE_TEMPLATE = '%(tool)s...\n%(file)s(%(line)s): warning: %(msg)s'\r
92	_WARNING_MESSAGE_TEMPLATE_WITHOUT_FILE = '%(tool)s: : warning: %(msg)s'\r
93	_DEBUG_MESSAGE_TEMPLATE = '%(file)s(%(line)s): debug: \n %(msg)s'\r
94	\r
95	\r
96	#\r
97	# Log INFO message\r
98	#\r
99	#Info = _INFO_LOGGER.info\r
100	\r
101	def Info(msg, args, *kwargs):\r
102	_INFO_LOGGER.info(msg, args, *kwargs)\r
103	\r
104	#\r
105	# Log information which should be always put out\r
106	#\r
107	def Quiet(msg, args, *kwargs):\r
108	_ERROR_LOGGER.error(msg, args, *kwargs)\r
109	\r
110	## Log debug message\r
111	#\r
112	# @param Level DEBUG level (DEBUG0~9)\r
113	# @param Message Debug information\r
114	# @param ExtraData More information associated with "Message"\r
115	#\r
116	def Debug(Level, Message, ExtraData=None):\r
117	if _DEBUG_LOGGER.level > Level:\r
118	return\r
119	if Level > DEBUG_9:\r
120	return\r
121	#\r
122	# Find out the caller method information\r
123	#\r
124	CallerStack = extract_stack()[-2]\r
125	TemplateDict = {\r
126	"file" : CallerStack[0],\r
127	"line" : CallerStack[1],\r
128	"msg" : Message,\r
129	}\r
130	\r
4231a819	131	if ExtraData is not None:\r
f51461c8 LG	132	LogText = _DEBUG_MESSAGE_TEMPLATE % TemplateDict + "\n %s" % ExtraData\r
	133	else:\r
	134	LogText = _DEBUG_MESSAGE_TEMPLATE % TemplateDict\r
	135	\r
	136	_DEBUG_LOGGER.log(Level, LogText)\r
	137	\r
	138	## Log verbose message\r
	139	#\r
	140	# @param Message Verbose information\r
	141	#\r
	142	def Verbose(Message):\r
	143	return _INFO_LOGGER.log(VERBOSE, Message)\r
	144	\r
	145	## Log warning message\r
	146	#\r
	147	# Warning messages are those which might be wrong but won't fail the tool.\r
	148	#\r
	149	# @param ToolName The name of the tool. If not given, the name of caller\r
	150	# method will be used.\r
	151	# @param Message Warning information\r
	152	# @param File The name of file which caused the warning.\r
	153	# @param Line The line number in the "File" which caused the warning.\r
	154	# @param ExtraData More information associated with "Message"\r
	155	#\r
	156	def Warn(ToolName, Message, File=None, Line=None, ExtraData=None):\r
	157	if _INFO_LOGGER.level > WARN:\r
	158	return\r
	159	#\r
	160	# if no tool name given, use caller's source file name as tool name\r
	161	#\r
4231a819	162	if ToolName is None or ToolName == "":\r
f51461c8 LG	163	ToolName = os.path.basename(extract_stack()[-2][0])\r
f51461c8 LG	164	\r
4231a819	165	if Line is None:\r
f51461c8 LG	166	Line = "..."\r
	167	else:\r
	168	Line = "%d" % Line\r
	169	\r
	170	TemplateDict = {\r
	171	"tool" : ToolName,\r
	172	"file" : File,\r
	173	"line" : Line,\r
	174	"msg" : Message,\r
	175	}\r
	176	\r
4231a819	177	if File is not None:\r
f51461c8 LG	178	LogText = _WARNING_MESSAGE_TEMPLATE % TemplateDict\r
	179	else:\r
	180	LogText = _WARNING_MESSAGE_TEMPLATE_WITHOUT_FILE % TemplateDict\r
	181	\r
4231a819	182	if ExtraData is not None:\r
f51461c8 LG	183	LogText += "\n %s" % ExtraData\r
	184	\r
	185	_INFO_LOGGER.log(WARN, LogText)\r
	186	#\r
fb0b35e0	187	# Raise an exception if indicated\r
f51461c8 LG	188	#\r
	189	if GlobalData.gWARNING_AS_ERROR == True:\r
	190	raise FatalError(WARNING_AS_ERROR)\r
	191	\r
	192	## Log ERROR message\r
	193	#\r
f7496d71	194	# Once an error messages is logged, the tool's execution will be broken by\r
fb0b35e0	195	# raising an exception. If you don't want to break the execution later, you\r
f51461c8 LG	196	# can give "RaiseError" with "False" value.\r
	197	#\r
	198	# @param ToolName The name of the tool. If not given, the name of caller\r
	199	# method will be used.\r
	200	# @param ErrorCode The error code\r
	201	# @param Message Warning information\r
	202	# @param File The name of file which caused the error.\r
	203	# @param Line The line number in the "File" which caused the warning.\r
	204	# @param ExtraData More information associated with "Message"\r
fb0b35e0	205	# @param RaiseError Raise an exception to break the tool's execution if\r
f51461c8 LG	206	# it's True. This is the default behavior.\r
	207	#\r
	208	def Error(ToolName, ErrorCode, Message=None, File=None, Line=None, \\r
	209	ExtraData=None, RaiseError=IS_RAISE_ERROR):\r
	210	if ToolName:\r
	211	pass\r
4231a819	212	if Line is None:\r
f51461c8 LG	213	Line = "..."\r
	214	else:\r
	215	Line = "%d" % Line\r
	216	\r
4231a819	217	if Message is None:\r
f51461c8 LG	218	if ErrorCode in gERROR_MESSAGE:\r
	219	Message = gERROR_MESSAGE[ErrorCode]\r
	220	else:\r
	221	Message = gERROR_MESSAGE[UNKNOWN_ERROR]\r
	222	\r
4231a819	223	if ExtraData is None:\r
f51461c8 LG	224	ExtraData = ""\r
	225	\r
	226	TemplateDict = {\r
	227	"tool" : _TOOL_NAME,\r
	228	"file" : File,\r
	229	"line" : Line,\r
	230	"errorcode" : ErrorCode,\r
	231	"msg" : Message,\r
	232	"extra" : ExtraData\r
	233	}\r
	234	\r
4231a819	235	if File is not None:\r
f51461c8 LG	236	LogText = _ERROR_MESSAGE_TEMPLATE % TemplateDict\r
	237	else:\r
	238	LogText = __ERROR_MESSAGE_TEMPLATE_WITHOUT_FILE % TemplateDict\r
	239	\r
	240	if not SUPRESS_ERROR:\r
	241	_ERROR_LOGGER.log(ERROR, LogText)\r
	242	if RaiseError:\r
	243	raise FatalError(ErrorCode)\r
	244	\r
f7496d71	245	\r
f51461c8 LG	246	## Initialize log system\r
	247	#\r
	248	def Initialize():\r
	249	#\r
f7496d71 LG	250	# Since we use different format to log different levels of message into\r
f7496d71 LG	251	# different place (stdout or stderr), we have to use different "Logger"\r
f51461c8 LG	252	# objects to do this.\r
	253	#\r
	254	# For DEBUG level (All DEBUG_0~9 are applicable)\r
	255	_DEBUG_LOGGER.setLevel(INFO)\r
	256	_DebugChannel = StreamHandler(stdout)\r
	257	_DebugChannel.setFormatter(_DEBUG_FORMATTER)\r
	258	_DEBUG_LOGGER.addHandler(_DebugChannel)\r
	259	#\r
	260	# For VERBOSE, INFO, WARN level\r
	261	#\r
	262	_INFO_LOGGER.setLevel(INFO)\r
	263	_InfoChannel = StreamHandler(stdout)\r
	264	_InfoChannel.setFormatter(_INFO_FORMATTER)\r
	265	_INFO_LOGGER.addHandler(_InfoChannel)\r
	266	#\r
	267	# For ERROR level\r
	268	#\r
	269	_ERROR_LOGGER.setLevel(INFO)\r
	270	_ErrorCh = StreamHandler(stderr)\r
	271	_ErrorCh.setFormatter(_ERROR_FORMATTER)\r
	272	_ERROR_LOGGER.addHandler(_ErrorCh)\r
	273	\r
	274	\r
	275	## Set log level\r
	276	#\r
	277	# @param Level One of log level in _LogLevel\r
	278	#\r
	279	def SetLevel(Level):\r
	280	if Level not in _LOG_LEVELS:\r
	281	Info("Not supported log level (%d). Use default level instead." % \\r
	282	Level)\r
	283	Level = INFO\r
	284	_DEBUG_LOGGER.setLevel(Level)\r
	285	_INFO_LOGGER.setLevel(Level)\r
	286	_ERROR_LOGGER.setLevel(Level)\r
	287	\r
	288	## Get current log level\r
	289	#\r
	290	def GetLevel():\r
	291	return _INFO_LOGGER.getEffectiveLevel()\r
	292	\r
	293	## Raise up warning as error\r
	294	#\r
	295	def SetWarningAsError():\r
	296	GlobalData.gWARNING_AS_ERROR = True\r
	297	\r
	298	## Specify a file to store the log message as well as put on console\r
	299	#\r
	300	# @param LogFile The file path used to store the log message\r
	301	#\r
	302	def SetLogFile(LogFile):\r
	303	if os.path.exists(LogFile):\r
	304	remove(LogFile)\r
	305	\r
	306	_Ch = FileHandler(LogFile)\r
	307	_Ch.setFormatter(_DEBUG_FORMATTER)\r
	308	_DEBUG_LOGGER.addHandler(_Ch)\r
	309	\r
	310	_Ch = FileHandler(LogFile)\r
	311	_Ch.setFormatter(_INFO_FORMATTER)\r
	312	_INFO_LOGGER.addHandler(_Ch)\r
	313	\r
	314	_Ch = FileHandler(LogFile)\r
	315	_Ch.setFormatter(_ERROR_FORMATTER)\r
316	_ERROR_LOGGER.addHandler(_Ch)\r
317	\r
318	\r
319	\r