A package that allows logs to be routed to different handlers based on a discriminant
Project description
python-log-router
A package that allows logs to be routed to different log handlers based on a discriminant. Each unique value of the discriminant is managed by a distinct handler.
Installation
pip install logrouter
Usage
Call logrouter.setup_logging()
to setup the logging configuration by providing the configuration yaml absolute file path. You can also set the configuration path using an environment variable. Specify the name of the env variable by setting the env_path
parameter.
For an example of a configuration file, refer to the default configuration file. You can specify the log handler to be used by replacing handlers.single_handler_class
with the name of the handler. The default one is logrouter.logrouter.DefaultHandler
, which inherits from logging.FileHandler
.
The default logging configuration will route all the logs based on the discriminator
field of the LogRecord object. To use the default configuration, call logrouter.setup_logging(use_default_config=True)
.
Examples
Run and look at the code and logs produced of the examples located at /examples
to experience what you can achieve with logrouter
.
Using different types of handlers
A new instance of single_handler_class
handler class is used for each discriminator unique value. This instance receives the log level and the discriminator value when created. If you want to use a differnet handler class for some discriminant values, specify them in handlers.handlers_dict
in the logging configuration file. See this example.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for logrouter-0.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1a1c3fefa172d5ef154d52a3f47a0b257246e7d6698b34b761dcf7bd53baff79 |
|
MD5 | 5e61c4d94a6d354a8297f8e487ddcda3 |
|
BLAKE2b-256 | e5be0fbf54b31a7d83de7e4ba601d93de84d8a2fae7adfca2dc1b0bffbce85af |