Metadata-Version: 2.1
Name: logutil
Version: 0.1.3
Summary: Easy initialization of standard python logging and loguru
Home-page: UNKNOWN
Author: Yaroslav Kopotilov
Author-email: datascience@tuta.io
License: Apache License, Version 2.0
Keywords: logging loguru
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: all
Requires-Dist: loguru ; extra == 'all'
Requires-Dist: notifiers ; extra == 'all'
Requires-Dist: sentry-sdk ; extra == 'all'
Provides-Extra: loguru
Requires-Dist: loguru ; extra == 'loguru'
Provides-Extra: notifiers
Requires-Dist: notifiers ; extra == 'notifiers'
Requires-Dist: sentry-sdk ; extra == 'notifiers'

# Logutil

(Extremely) easy initialization for `logging` and `loguru`

## Why

This packages makes initialization of `logging` and `loguru` with stream, file, sentry and pushover handlers (extremely) easy.

## Installation

- Logging only: `pip install logutil`
- ... + loguru: `pip install logutil[loguru]`
- ... + notifiers/sentry: `pip install logutil[notifiers]`
- ... + loguru + notifiers/sentry: `pip install logutil[all]`

## Examples

### Standard python logging

```python
from logutil import init_logging, get_logging_logger
init_logging('sub1')
logger = get_logging_logger('sub1')
logger.info('Test INFO message (logging)')
logger.warning('Test WARNING message (logging)')
```
```
2020-07-19T12:59:18.740Z sub1 INFO: Test INFO message (logging)
2020-07-19T12:59:18.740Z sub1 WARNING: Test WARNING message (logging)
```

### Loguru

```python
from logutil import init_loguru, get_loguru_logger
init_loguru()
logger = get_loguru_logger()
logger.info('Test INFO message (loguru)')
logger.warning('Test WARNING message (loguru)')
```
```
2020-07-19T12:56:20.771Z __main__ INFO: Test INFO message (loguru)
2020-07-19T12:56:20.771Z __main__ WARNING: Test WARNING message (loguru)
```

## Notes

- Formatting is ignored for `sentry` notifications with `logging`


