privex-loghelper 1.0.5

python 3

pip3 install privex-loghelper

python 2

pip install privex-loghelper

（可选）从git手动安装

选项1-使用pip直接从github安装

pip3 install git+https://github.com/Privex/python-loghelper

选项2-手动克隆并安装

# Clone the repository from Github
git clone https://github.com/Privex/python-loghelper
cd python-loghelper

# RECOMMENDED INSTALL METHOD# Use pip to install the source code
pip3 install .

# ALTERNATIVE INSTALL METHOD# If you don't have pip, or have issues with installing using it, then you can use setuptools instead.
python3 setup.py install

用法

代码有很好的文档记录，您可以在LogHelper.py中找到所有使用文档。

所有函数都带有类型注释，并带有详细的pydoc块注释。如果您使用的是python优化的ide，比如PyCharm，那么它应该 使用包时提供代码完成和帮助。

基本用法

最基本的用法是简单地初始化没有参数的类，并附加一个 将日志输出发送到文件的文件处理程序。

# Import the classfromprivex.loghelperimportLogHelper# The first param is logger_name - a hierarchical dot-separated name to organise loggers.# If it's not specified, or is None, it will use the root logger (which will affect some# third-party packages that don't have their own logging settings)lh=LogHelper('mylogger')# Log to a file called test.log in the current directorylh.add_file_handler('test.log')# Grab the logger instancelog=lh.get_logger()# Now let's log 'hello world' to the file.log.info('hello world')

运行以上命令后，test.log应该包含：

2018-12-05 22:05:18,915 root         INFO     hello world

将日志配置复制到其他日志记录器名称

第三方包通常使用自己的日志实例名称。以便于您复制设置 对于其他实例，可以使用copy_logger(name)方法。

# Set up logging for your app, log anything >=INFOlh=LogHelper('myapp',handler_level=logging.INFO)# Log to a file called test.log in the current directory (note: absolute path is better)lh.add_file_handler('test.log')# Now copy your logging level, handlers, and formatting to the logger privex.jsonrpclh.copy_logger('privex.jsonrpc')# You can specify multiple logger names as positional arguments. All specified loggers will# have their handlers replaced with yours, and have their logging level set to match.lh.copy_logger('example.app','otherexample')

将设置复制到命名记录器后，使用该记录器的所有日志记录都应使用指定的处理程序， 以及你的日志级别。

这包括通过logging.getLogger('loggername')和python日志包装器访问记录器的模块。 比如女贞女侍者。

将错误和调试日志拆分为不同的文件

可以更容易地筛选日志的方法是将正常的调试日志从警告和错误中分离出来。

使用标准的logging模块，这可能需要10行代码，而且重复性很强。

使用python日志助手，只需几行代码。

# Import the classfromprivex.loghelperimportLogHelper# Import logging to be able to specify the verbosity levelsimportlogging# The global level (kwarg `level`) defaults to DEBUG, but the default handler level is only INFO.# You can specify handler_level to change that. # To help prevent conflicts from other python packages which use the root ('') logger, you should set a custom# logger name.lh=LogHelper(logger_name='my_app',handler_level=logging.DEBUG)# Log messages that are DEBUG (default handler and global logging level) or higher to `debug.log`lh.add_file_handler('debug.log')# Log only WARNING or above to `error.log`lh.add_file_handler('error.log',level=logging.WARNING)# Grab the logger instancelog=lh.get_logger()# To test that logs are being sent to the correct files, let's try an `info`, a `warning` and an `error` log message.log.info('something normal is happening')log.warning('something strange is happening')log.error('something VERY BAD is happening')

运行上述python脚本后，您将看到以下日志文件：

debug.log

2018-12-05 22:10:25,253 root         INFO        something normal is happening
2018-12-05 22:10:25,254 root         WARNING     something strange is happening
2018-12-05 22:10:25,256 root         ERROR       something VERY BAD is happening

error.log

2018-12-05 22:10:25,254 root         WARNING     something strange is happening
2018-12-05 22:10:25,256 root         ERROR       something VERY BAD is happening

如您所见，debug.log保存了所有消息，而error.log只保存了警告和错误。

对数旋转

也可以进行无痛的原木旋转，无需比如logrotated。

loghelper类有一个函数add_timed_file_handler，它包装了logging.handler.TimedRotatingFileHandler。

只需指定要旋转的间隔（when）的类型、旋转的频率（interval）以及 希望在删除旧版本之前保留（backups）。如果不想删除旧日志，请将backups设置为0。

有关interval、when和backups的更多信息， 见the official logging docs

默认情况下，日志每天循环一次（间隔=1）（当'd'时），并在14天后删除（备份=14）。

# Import the classfromprivex.loghelperimportLogHelper# Using sleep to simulate time passingfromtimeimportsleeplh=LogHelper()# Log to a file called test.log in the current directory# Rotate the log every minute, and only keep up to 60 minutes of logslh.add_timed_file_handler('test.log',when='M',interval=1,backups=60)# Grab the logger instancelog=lh.get_logger()# Now let's log 'hello world' to the file.log.info('hello world')log.info('hello world 2')sleep(60)log.info('hello world 3')

现在我们可以看到它生成了两个带时间戳的日志，因为间隔设置为1分钟。

$ ls -l
    -rw-r--r--  1 user  users    585 Dec 22:58 test.log.2018-12-05_22-58
    -rw-r--r--  1 user  users    585 Dec 22:59 test.log.2018-12-05_22-59

$ cat test.log.2018-12-05_22-58
    2018-12-05 22:58:24,600 root         INFO     hello world
    2018-12-05 22:58:24,743 root         INFO     hello world 2

$ cat test.log.2018-12-05_22-59
    2018-12-05 22:59:25,512 root         INFO     hello world 3

谢谢你的阅读！

如果这个项目对您有帮助，请考虑grabbing a VPS or Dedicated Server from Privex-价格最低为8美元/月（我们采用加密货币！）

标签：

• the
• to
• log
• logging
• 记录
• logger
• 依赖性
• privex
• lh

欢迎加入QQ群-->： 979659372

推荐PyPI第三方库

• robo-gym-server-modules

  robogym的Robot服务器和服务器管理器代码

• trade-order

  python版本的 A股实盘交易接口

• srtfix

  用于重命名srt文件的工具

• AWS-Matope-Sithole-distributions

  高斯分布和二项式分布

• printListModuleAm

  打印给定列表输入的API

• Lysort

  有六个排序函数来对数据进行排序

• HiveMind-voice-sat

  Mycroft语音卫星

• jwtauthapi

  一个Django应用程序，用于执行基于会话的身份验证。

• keyboad

  未提供项目说明

• pypi-foreverchaos-test

  一个小的示例包

• GROUPmath

  一种称为组的数据结构

• moniBenzi-probabilit

  高斯分布

• spinsim

  使用cuda并行化快速准确地模拟自旋半量子系统和自旋一量子系统的软件包。

• asteriskinterfacelogger

  星号接口微服务的通用日志配置

• m2g

  神经数据MRI到图形管道