Welcome to nb_log’s documentation!

Contents:

• 1.nb_log 简介
  • tips: 要想更简单简化使用日志,请安装kuai_log
  • 1.0 nb_log 安装
  • 1.0.1 nb_log不仅是日志，还对print以及sys.stdout(sys.stderr) 打了强力的猴子补丁
  • 1.0.2 nb_log 新增支持loguru包模式来记录日志，原汁原味的loguru来打印控制台和写入日志文件，见文档1.10.b
  • 1.1 nb_log 简单使用例子
    • 1.1.a nb_log 写入日志文件
    • 1.1.a2 nb_log 写入日志文件,并将错误日志同时写到另外的错误日志文件中
    • 1.1.b nb_log 的最核心函数 get_logger入参说明
    • 1.1.c nb_log配置文件的生成和导入。
    • 1.1.d nb_log配置文件的一些参数说明。
    • 1.1.1e 日志配置文件和get_logger传参的关系。
  • 1.2 nb_log功能介绍
    • 1.2.1 nb_log 支持日志根据级别自动变彩色
    • 1.2.1b 设置是否需要彩色
    • 1.2.1c 关于彩色显示效果的最终显示的说明
    • 1.2.1d pycharm中精确设置控制台颜色的方式
    • 1.2.2 nb_log 不仅支持日志变彩色，还支持项目中所有python文件的任意print自动变彩色
    • 1.2.2b print自动化效果转换的好处说明
    • 1.2.2c nb_log 五彩日志的效果截图
  • 1.3 nb_log 支持pycharm控制台点击日志精确跳转到打印日志的文件和行号
  • 1.4 nb_log是原生logging类型，兼容性 扩展性非常好。
  • 1.5 nb_log 能够简单讲日志记录到十几种地方的任意几种的组合。
  • 1.6 日志命名空间独立，采用了多实例logger，按日志命名空间区分。
  • 1.7 对内置looging包打了猴子补丁，使日志永远不会使用同种handler重复记录 ，例如，原生的
  • 1.8 nb_log使用对比原生logging和 loguru 更简单
    • 1.8.1 logging 代码方式创建logger对象
    • 1.8.2 python中 创建logger的第二种方式，logging.config.dictConfig()
    • 1.8.3 loguru的简单使用
    • 1.8.4 nb_log的使用可以比loguru更简单
  • 1.9 内置logging包的日志命名空间是什么
    • 1.9.2 看大神和小白是怎么记录flask的请求记录和报错记录的,为什么知道日志 logger 的name 很重要?
  • 1.10 nb_log比logurur有10胜
  • 1.10.b nb_log 新增支持loguru包来记录日志，原汁原味的loguru
  • 1.11 关于nb_log日志级别设置，看文档9.5 章节。
  • 1.20 完整readthedocs文档地址
• 2 nb_log的文件日志handler
  • 2.1 nb_log 支持5中文件日志切割方式
  • 2.2 演示nb_log文件日志，并且直接演示最高实现难度的多进程安全切片文件日志
  • 2.3 演示文件大小切割在多进程下的错误例子,
• 3. nb_log记录到 钉钉、Mongo、elastic、邮件等
  • 3.1 钉钉日志
  • 3.2 其他handler包括kafka日志，elastic日志，邮件日志，mongodb日志
  • 3.3 各種日志截圖
• 4.关于logging包日志观察者模式
  • 观察者模式图片
• 5.演示不懂观察者模式，日志重复记录惨烈的例子
  • 5.1 演示一个由于不好好理解观察者模式，封装的日志类在调用时候十分惨烈的例子，惨烈程度达到10级。
  • 5.2 使用博客园搜索后排名第一个的python 日志封装，也是严重重复记录。
  • 5.3 使用火热的loguru 来演示惨烈的文件日志重复记录。
• 6. 对比 loguru 10胜
  • 6.1 先比控制台屏幕流日志颜色，nb_log三胜。
  • 6.2 比文件日志性能，nb_log比loguru快400%。
    • 6.2.1 loguru快速文件写入性能，写入200万条代码
    • 6.2.2 nb_log快速文件写入性能，写入200万条代码
  • 6.3 多进程下的文件日志切割，nb_log不出错，loguru出错导致丢失大量日志。
  • 6.4 写入不同的文件，nb_log采用经典日志的命名空间区分日志，比loguru更简单
  • 6.5 按不同功模块能作用的日志设置不同的日志级别。loguru无法做到。
  • 6.6 nb_log内置自带的log handler种类远超loguru
  • 6.7 比第三方的日志handler扩展数量，nb_log完胜loguru
  • 6.8 nb_log的get_logger返回类型是原生经典logging.Logger，兼容性达到了100%。loguru独立实现日志系统，兼容性很差。
  • 6.9 易用性对比，nb_log的控制台和文件handler比loguru添加更容易
  • 6.10 nb_log可以灵活捕获所有第三方python包、库、框架的日志,loguru不行
    • 6.10.b 日志的命名空间意义很重要 ，就是那个logging.getLogger的入参，很多人还不懂。
• 7 nb_log 捕获三方包的日志
  • 7.1 nb_log 记录三方包日志的方法，requests举例子
  • 7.2 nb_log还可以记录flask/django任意三方包
  • 7.3 python日志命名空间是树形结构
  • 7.4 如何确定有哪些日志命名空间的日志可以被记录，强大的 get_logger(None)
• 8 禁止对nb_log进行二次封装
  • 8.1 禁止对nb_log进行以下形式的封装
    • 8.1b 如果非要封装nb_log,为了保证获取的代码文件和行号是正确的，
  • 8.2 其他废物封装举例子
• 9 nb_log常见疑问解答
  • 9.1 怎么把普通debug info日志写入文件a，把错误级别日志写到文件b？
  • 9.2 没有使用pycahrm run运行，直接在linux或cmd运行，生成的nb_log_config.py 位置错误，或者导入不了nb_log_config模块
  • 9.4 pyinstaller 打包后运行报错，no such file nb_log_config_default.py
    • 9.4.2 打包报错 no such file nb_log_config_default.py，解决方式2
  • 9.5 怎么屏蔽和打开某一部分日志？（选择性关闭和打开某部分日志）
    • 9.5.1 真实代码例子，说明怎么屏蔽某个日志。
    • 9.5.2 你如何知道日志的命名空间 (name) 是什么?
    • 9.5.3 经常看到三方包中写 logger = logging.getLogger(_name_) 啥意思？这个logger对象的name命名空间是什么？
    • 9.5.4 日志命名空间是树形的
    • 9.5.5 举个例子，如何打开某个日志显示(和屏蔽日志相反)
    • 9.5.6 nb_log 提前锁定日志级别的方式
    • 9.5.7 print或logger消息中包括某些字符串，屏蔽打印的设置
    • 9.5.8 nb_log 大量使用猴子补丁的原理
• 10 nb_log 更新记录
  • 10.1 2023.07 nb_log 新增 print和标准输出 自动写入到文件中
  • 10.2 2023.12 新增 错误error级别以上日志文件写入单独的日志文件中
  • 10.3 2023.12 新增 支持loguru来打印控制台和写入文件