minilog 0.4b2

Minimalistic wrapper for Python logging.

Unix: [](https://travis-ci.org/jacebrowning/minilog) Windows: [](https://ci.appveyor.com/project/jacebrowning/minilog)<br>Metrics: [](https://coveralls.io/r/jacebrowning/minilog) [](https://scrutinizer-ci.com/g/jacebrowning/minilog/?branch=develop)<br>Usage: [](https://pypi.python.org/pypi/minilog)
Unix: [](https://travis-ci.org/jacebrowning/minilog) Windows: [](https://ci.appveyor.com/project/jacebrowning/minilog)<br>Metrics: [](https://coveralls.io/r/jacebrowning/minilog) [](https://scrutinizer-ci.com/g/jacebrowning/minilog/?branch=develop)<br>Usage: [](https://pypi.org/project/minilog)

# Overview

Every project should utilize logging, but for simple use cases, this requires a bit too much boilerplate. Instead of including all of this in your modules:

```python
import logging

logging.basicConfig(
level=logging.INFO,
format="%(levelname)s: %(name)s: %(message)s",
)

log = logging.getLogger(__name__)

def greet(name):
log.info("Hello, %s!", name)
```

with this package you can simply:

```python
import log

def greet(name):
log.info("Hello, %s!", name)
```

It will produce the exact same standard library `logging` records behind the scenes.

# Installation

```sh
$ pip install minilog
```

# Revision History

## 0.4 (unreleased)

- Added `reset=True` as `init()` option to replace all existing logging handlers.
- Added `exception` logging API.
- Added convenience alias: `log.c`, `log.exc`.

## 0.3.1 (2018/03/30)

- Fixed bug where records were written for disabled levels.

## 0.3 (2018/03/15)

- Exposed `logging` level constants on the `log` package.
- Added `log.WARN` as an alias of `log.WARNING`.

## 0.2.1 (2018/03/04)

- Removed the Python version check on installation.

## 0.2 (2018/03/03)

- Added method to force logging format: `log.init(format="...")`
- Added method to silenced named loggers: `log.silence('requests', allow_error=True)`
- Added convenience aliases: `log.d`, `log.i`, `log.w`, `log.e`

## 0.1 (2018/03/03)

- Initial release.