Package: picologging
picologgingWarningThis project is inbeta.
There are some incomplete features (seeLimitations).Picologging is a high-performance logging library for Python. picologging is 4-10x faster than theloggingmodule in the standard library.Picologging is designed to be used as adrop-inreplacement for applications which already use logging, and supports the same API as theloggingmodule.Check out theDocumentationfor more.InstallationPicologging can be installed from PyPi using pip:pip install picologgingOr from conda forge using conda:conda install -c conda-forge picologgingUsageImportpicologging as loggingto use picologging instead of the standard library logging module.This patches all the loggers registered to use picologging loggers and formatters.importpicologgingaslogginglogging.basicConfig()logger=logging.getLogger()logger.info("A log message!")logger.warning("A log message with%s","arguments")BenchmarksRunrichbench benchmarks/ --markdownwith the richbench CLI to see the benchmarks, here is a sample on macOS 11:BenchmarkMinMaxMeanMin (+)Max (+)Mean (+)FileHandler()0.1380.1510.1430.055 (2.5x)0.063 (2.4x)0.058 (2.5x)WatchedFileHandler()0.1890.1970.1930.097 (1.9x)0.101 (1.9x)0.099 (1.9x)RotatingFileHandler()0.2870.3040.2960.174 (1.6x)0.178 (1.7x)0.176 (1.7x)QueueHandler()1.1091.1951.1300.142 (7.8x)0.151 (7.9x)0.147 (7.7x)QueueListener() + QueueHandler()0.1570.1670.1620.034 (4.6x)0.039 (4.3x)0.037 (4.3x)MemoryHandler()0.1260.1440.1330.051 (2.5x)0.059 (2.5x)0.054 (2.5x)LogRecord()0.2250.2480.2330.026 (8.7x)0.029 (8.5x)0.028 (8.4x)Formatter().format()0.0760.0860.0810.004 (18.7x)0.005 (18.9x)0.004 (19.1x)Formatter().format() with date0.2980.3110.3040.081 (3.7x)0.087 (3.6x)0.084 (3.6x)Logger(level=DEBUG).debug()0.7260.7430.7340.059 (12.3x)0.061 (12.3x)0.060 (12.3x)Logger(level=DEBUG).debug() with args0.7610.8090.7770.081 (9.4x)0.087 (9.3x)0.084 (9.2x)Logger(level=INFO).debug()0.0160.0180.0170.004 (4.3x)0.005 (3.8x)0.004 (4.1x)Logger(level=INFO).debug() with args0.0180.0190.0180.005 (3.8x)0.005 (3.8x)0.005 (3.7x)LimitationsSeeLimitationsContributingThis project welcomes contributions and suggestions.  Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visitcla.opensource.microsoft.com.When you submit a pull request, a CLA bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.This project has adopted theMicrosoft Open Source Code of Conduct.
For more information see theCode of Conduct FAQor
contactopencode@microsoft.comwith any additional questions or comments.Local developmentThis project comes bundled with a dev container which sets up an appropriate environment. If you install the Dev Containers extension for VS Code, then opening this project in VS Code should prompt it to open it in the dev container.Once opened in the dev container, run:pip install -e ".[dev]"pre-commit installpython setup.py build_ext --inplace --build-type DebugRun the build command whenever you make changes to the files.It's also helpful to create a.vscode/launch.jsonfile like this one:{"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},]}}Now you can press the "Run and debug" button to runpytestfrom thegdbdebugger
and use breakpoint debugging in the C code.If you would like to be able to dive into the CPython code while debugging, then:Do a git checkout of the tagged branch for the devcontainer's Python version
into the devcontainer's/workspaces/directory. You may need tosudo.Follow the instructions in the CPython README to compile the code.Add the following key to the the configuration inlaunch.json:"sourceFileMap":{"/usr/src/python":"/workspaces/cpython"},Add the following command to thesetupCommandsinlaunch.json:{"description":"Find CPython source code","text":"-gdb-set auto-load safe-path /workspaces/cpython"},TrademarksSome components of this Python package are from CPython 3.11 logging library for compatibility reasons.CPython 3.11 is licensed under the PSF license.
The logging module is Copyright (C) 2001-2019 Vinay Sajip. All Rights Reserved.This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must followMicrosoft's Trademark & Brand Guidelines.
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.