picologging

警告：该项目处于测试版状态。存在一些不完整的功能（见限制）。

Picologging是一个高性能的Python日志库。picologging比标准库中的logging模块快4-10倍。

Picologging旨在作为现有使用logging的应用程序的直接替换，并支持与logging模块相同的API。

有关更多信息，请参阅文档。

安装

Picologging可以通过pip从PyPi安装

pip install picologging

或使用conda从conda forge安装

conda install -c conda-forge picologging

用法

导入picologging as logging以使用picologging而不是标准库中的logging模块。

这将修复所有注册的记录器以使用picologging记录器和格式化程序。

import picologging as logging
logging.basicConfig()

logger = logging.getLogger()

logger.info("A log message!")

logger.warning("A log message with %s", "arguments")

基准测试

使用 richbench CLI 运行 richbench benchmarks/ --markdown 来查看基准测试，以下是在 macOS 11 上的一个示例

限制

请参阅 限制

贡献

此项目欢迎贡献和建议。大多数贡献需要您同意贡献者许可协议（CLA），声明您有权并且实际上确实授予我们使用您贡献的权利。有关详细信息，请访问 cla.opensource.microsoft.com。

当您提交拉取请求时，CLA 机器人将自动确定您是否需要提供 CLA，并适当装饰 PR（例如，状态检查，评论）。只需遵循机器人提供的说明即可。您只需在整个使用我们 CLA 的存储库中做一次。

此项目已采用 Microsoft Open Source Code of Conduct。有关更多信息，请参阅 Code of Conduct FAQ 或联系 opencode@microsoft.com 有关任何额外的问题或评论。

本地开发

此项目附带一个 dev 容器，该容器设置了适当的环境。如果您为 VS Code 安装了 Dev Containers 扩展，则在此项目中打开 VS Code 应会提示它在 dev 容器中打开。

在 dev 容器中打开后，运行

pip install -e ".[dev]"
pre-commit install
python setup.py build_ext --inplace --build-type Debug

每次您对文件进行更改时，都运行构建命令。

创建一个类似以下内容的 .vscode/launch.json 文件也很有帮助

{
    "version": "0.2.0",
    "configurations": [
    {
        "name": "(gdb) Launch pytest",
        "type": "cppdbg",
        "request": "launch",
        "program": "/usr/local/bin/python",
        "args": ["-m", "pytest", "tests"],
        "stopAtEntry": false,
        "cwd": "${workspaceFolder}",
        "environment": [],
        "externalConsole": false,
        "MIMode": "gdb",
        "setupCommands": [
            {
                "description": "Enable pretty-printing for gdb",
                "text": "-enable-pretty-printing",
                "ignoreFailures": true
            },
            {
                "description":  "Set Disassembly Flavor to Intel",
                "text": "-gdb-set disassembly-flavor intel",
                "ignoreFailures": true
            },
        ]
    }
}

现在您可以通过按“运行和调试”按钮来运行来自 gdb 调试器的 pytest 并在 C 代码中使用断点调试。

如果您希望在调试时能够深入了解 CPython 代码，那么

1. 在 devcontainer 的 /workspaces/ 目录中对 devcontainer 的标记分支进行 git checkout，用于 devcontainer 的 Python 版本。您可能需要 sudo。

2. 按照 CPython README 中的说明编译代码。

3. 将以下密钥添加到 launch.json 的配置中

   "sourceFileMap": { "/usr/src/python": "/workspaces/cpython" },
   

4. 将以下命令添加到 launch.json 的 setupCommands 中

   {
       "description": "Find CPython source code",
       "text": "-gdb-set auto-load safe-path /workspaces/cpython"
   },
   

商标

出于兼容性原因，此 Python 包的一些组件来自 CPython 3.11 日志库。

CPython 3.11 采用 PSF 许可证。日志模块的版权为 (C) 2001-2019 Vinay Sajip。版权所有。

本项目可能包含项目、产品或服务的商标或标志。Microsoft 商标或标志的授权使用必须遵守并遵循Microsoft 的商标和品牌指南。在此项目的修改版本中使用 Microsoft 商标或标志时，不得引起混淆或暗示 Microsoft 的赞助。任何第三方商标或标志的使用均受该第三方政策的约束。