Python 日志打印之logging.getLogger源码分析
日志打印之logging.getLogger源码分析
By:授客 QQ:1033553122
#实践环境
WIN 10
Python 3.6.5
#函数说明
logging.getLogger(name=None)
getLogger函数位于logging/__init__.py脚本
#源码分析
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | _loggerClass = Logger # ...略 root = RootLogger(WARNING) Logger.root = root Logger.manager = Manager(Logger.root) # ...略 def getLogger(name = None ): """ Return a logger with the specified name, creating it if necessary. If no name is specified, return the root logger. """ if name: return Logger.manager.getLogger(name) else : return root |
结论:如函数注释所述,如果调用getLogger时,如果没有指定函数参数(即要获取的日志打印器名称)或者参数值不为真,则默认返回root打印器
##Logger.manager.getLogger(self, name)源码分析
该函数位于logging/__init__.py脚本
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 | class Manager( object ): """ There is [under normal circumstances] just one Manager instance, which holds the hierarchy of loggers. """ def __init__( self , rootnode): """ Initialize the manager with the root node of the logger hierarchy. """ self .root = rootnode self .disable = 0 self .emittedNoHandlerWarning = False self .loggerDict = {} self .loggerClass = None self .logRecordFactory = None def getLogger( self , name): """ Get a logger with the specified name (channel name), creating it if it doesn't yet exist. This name is a dot-separated hierarchical name, such as "a", "a.b", "a.b.c" or similar. If a PlaceHolder existed for the specified name [i.e. the logger didn't exist but a child of it did], replace it with the created logger and fix up the parent/child references which pointed to the placeholder to now point to the logger. """ rv = None if not isinstance (name, str ): raise TypeError( 'A logger name must be a string' ) _acquireLock() try : if name in self .loggerDict: rv = self .loggerDict[name] if isinstance (rv, PlaceHolder): ph = rv rv = ( self .loggerClass or _loggerClass)(name) rv.manager = self self .loggerDict[name] = rv self ._fixupChildren(ph, rv) self ._fixupParents(rv) else : rv = ( self .loggerClass or _loggerClass)(name) # _loggerClass = Logger rv.manager = self self .loggerDict[name] = rv self ._fixupParents(rv) finally : _releaseLock() return rv |
###Logger源码分析
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 | _nameToLevel = { 'CRITICAL' : CRITICAL, 'FATAL' : FATAL, 'ERROR' : ERROR, 'WARN' : WARNING, 'WARNING' : WARNING, 'INFO' : INFO, 'DEBUG' : DEBUG, 'NOTSET' : NOTSET, } # ...略 def _checkLevel(level): if isinstance (level, int ): rv = level elif str (level) = = level: if level not in _nameToLevel: raise ValueError( "Unknown level: %r" % level) rv = _nameToLevel[level] else : raise TypeError( "Level not an integer or a valid string: %r" % level) return rv # ...略 class PlaceHolder( object ): """ PlaceHolder instances are used in the Manager logger hierarchy to take the place of nodes for which no loggers have been defined. This class is intended for internal use only and not as part of the public API. """ def __init__( self , alogger): """ Initialize with the specified logger being a child of this placeholder. """ self .loggerMap = { alogger : None } def append( self , alogger): """ Add the specified logger as a child of this placeholder. """ if alogger not in self .loggerMap: self .loggerMap[alogger] = None class Logger(Filterer): """ 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. """ def __init__( self , name, level = NOTSET): """ Initialize the logger with a name and an optional level. """ Filterer.__init__( self ) self .name = name self .level = _checkLevel(level) self .parent = None self .propagate = True self .handlers = [] self .disabled = False # ... 略 |
结论:如果调用logging.getLogger()时,有指定日志打印器名称,且名称为真(不为空字符串,0,False等False值),
1)如果名称为不存在的日志打印器名称,则,且参数值为真,但是即要获取的日志打印器名称)或者参数值不为真,则创建一个名为给定参数值的日志打印器,该日志打印器,默认级别默认为NOTSET,disable_existing_loggers配置为False,propagate配置为True。然后在日志打印器字典中记录该名称和日志打印器的映射关系,接着调用 _fixupParents(创建的日志打印器实例)类实例方法--为日志打印器设置上级日志打印器,最后返回该日志打印器。
2)如果名称已存在日志打印器名称,则获取该日志打印器,然后判断日志打印器是否为PlaceHolder类实例,如果是,则创建一个名为所给参数值的日志打印器,同第1)点,该日志打印器,默认级别默认为NOTSET,disable_existing_loggers配置为False,propagate配置为True。然后在日志打印器字典中记录该名称和日志打印器的映射关系,接着调用 _fixupParents(创建的打印器实例)类实例方法,_fixupChildren(PlaceHolder类实例--根据名称获取的日志打印器,新建的日志打印器实例)--为新建日志打印器设置上级日志打印器,为PlaceHolder类实例现有下级PlaceHolder日志打印器实例重新设置上级日志打印器,最后返回该日志打印器。
###_fixupParents及_fixupChildren函数源码分析
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 | # _fixupParents # ...略 class Manager( object ): # ...略 def _fixupParents( self , alogger): """ Ensure that there are either loggers or placeholders all the way from the specified logger to the root of the logger hierarchy. """ name = alogger.name # 获取日志打印器名称 i = name.rfind( "." ) rv = None # 存放alogger日志打印器的上级日志打印器 while (i > 0 ) and not rv: # 如果名称中存在英文的点,并且找到上级日志打印器 substr = name[:i] # 获取名称中位于最后一个英文的点的左侧字符串(暂且称至为 点分上级) if substr not in self .loggerDict: # 如果 点分上级 不存在日志打印器字典中 self .loggerDict[substr] = PlaceHolder(alogger) # 创建PlaceHolder实例作为 点分上级 对应的日志打印器 # 继续查找点分上级日志打印器 # 注意,这里的PlaceHolder仅是占位用,不是真的打印器,这里为了方便描述,暂且称之为PlaceHolder日志打印器 else : # 否则 obj = self .loggerDict[substr] # 获取 点分上级 对应的日志打印器 if isinstance (obj, Logger): # 如果为Logger实例,如果是,则跳出循环,执行 # 为日志打印器设置上级 rv = obj else : # 否则 assert isinstance (obj, PlaceHolder) # 断言它为PlaceHolder的实例 obj.append(alogger) # 把日志打印器添加为点分上级对应的PlaceHolder日志打印器实例的下级日志打印器 执行 # 继续查找点分上级日志打印器 i = name.rfind( "." , 0 , i - 1 ) # 继续查找点分上级日志打印器 if not rv: # 找不到点分上级、或者遍历完所有点分上级,都没找到上级日志打印器 rv = self .root # 则 把root日志打印器设置为alogger日志打印器的上级日志打印器 alogger.parent = rv # 为日志打印器设置上级 def _fixupChildren( self , ph, alogger): """ Ensure that children of the placeholder ph are connected to the specified logger. """ name = alogger.name # 获取日志打印器名称 namelen = len (name) # 获取日志打印器名称长度 for c in ph.loggerMap.keys(): # 遍历获取的PlaceHolder日志打印器实例的子级日志打印器 #The if means ... if not c.parent.name.startswith(nm) if c.parent.name[:namelen] ! = name: # 如果PlaceHolder日志打印器实例名称不以alogger日志打印器名称为前缀, alogger.parent = c.parent # 那么,设置alogger日志打印器的上级日志打印器为PlaceHolder日志打印器 c.parent = alogger # 设置alogger日志打印器为PlaceHolder日志打印器原有下级PlaceHolder日志打印器的上级 |
结论:日志打印器都是分父子级的,这个父子层级是怎么形成的,参见上述函数代码注解
作者:授客
微信/QQ:1033553122
全国软件测试QQ交流群:7156436
Git地址:https://gitee.com/ishouke
友情提示:限于时间仓促,文中可能存在错误,欢迎指正、评论!
作者五行缺钱,如果觉得文章对您有帮助,请扫描下边的二维码打赏作者,金额随意,您的支持将是我继续创作的源动力,打赏后如有任何疑问,请联系我!!!
微信打赏
支付宝打赏 全国软件测试交流QQ群
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· .NET Core 托管堆内存泄露/CPU异常的常见思路
· PostgreSQL 和 SQL Server 在统计信息维护中的关键差异
· C++代码改造为UTF-8编码问题的总结
· 【.NET】调用本地 Deepseek 模型
· CSnakes vs Python.NET:高效嵌入与灵活互通的跨语言方案对比
· DeepSeek “源神”启动!「GitHub 热点速览」
· 我与微信审核的“相爱相杀”看个人小程序副业
· Plotly.NET 一个为 .NET 打造的强大开源交互式图表库