Metadata-Version: 2.1
Name: logging-interceptor
Version: 0.1.0.dev0
Summary: Capture Python's standard logging messages and route them to Loguru.
Home-page: https://github.com/imcf/logging-interceptor
Keywords: logging,loguru
Author: Matthew D. Scholefield
Author-email: matthew331199@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: loguru (>=0.6.0,<0.7.0)
Project-URL: Repository, https://github.com/imcf/logging-interceptor
Description-Content-Type: text/markdown

# Python Logging Interceptor

*Capture Python's stdlib `logging` messages and route them to other logging frameworks.*

(Modified and packaged for PyPI from Matthew Scholefield's[loguru-logging-intercept][r1].)

Currently supported targets:

* [Loguru](https://github.com/Delgan/loguru)

[Loguru](https://github.com/Delgan/loguru) is a great alternative logging library for
Python. However, if you use (potentially external) code that already integrates with
Python's default logger, you'll get a combination of the two logging styles. This code
provides code for setting up an intercept handler to route calls to Python's default
`logging` module to Loguru.

## Usage

Before calls that use Python's default `logging` module, call the provided
`setup_loguru_logging_intercept()` as shown below:

```python
from logging_interceptor import setup_loguru_interceptor


setup_loguru_interceptor(modules=("foo", "foo.bar", "foo.baz"))

# now call functions from `foo` that use getLogger(__name__)
```

## Installation

Install via `pip`:

```bash
pip3 install loguru-logging-intercept
```

[r1]: https://github.com/MatthewScholefield/loguru-logging-intercept

