Easy configure logging
Project description
easylogconfig
This python library provides simple wrapper for standart logging module.
If you want something more than "logging.basicConfig", but don't want to read a lot of documentation and to write a lot of code.
Usage
You can find examples in ./examples directory
import logging
import easylogconfig
log = logging.getLogger(__name__)
# print messages to the stdout, add debug level
easylogconfig.auto(debug=True)
# or print messages to the syslog
easylogconfig.auto(syslog_tag="example_tag")
# or print messages to the file without datetime but with thread names
easylogconfig.auto(file_name="/var/log/example.log", file_backup_count=30,
datetime=False, thread=True)
log.info("info message")
log.debug("debug message")
# output format:
# 2019-03-22/10:17:28 INFO info message
Configuration
Library provides one simple function auto with arguments:
- formatter arguments:
- debug=False: add debug messages to output?
- thread=False: add thread names to messages?
- datetime=True: add datetime to messages?
- level=False: add level names to messages?
- SysLogHandler arguments:
- syslog_tag=None: if set to str, log messages to syslog with this tag
- syslog_address="/dev/log": syslog server address
- TimedRotatingFileHandler arguments:
- file_name=None: if set to str, log messages to this tile
- file_when="midnight": file rotating time
- file_backup_count=7: keep last files
Log handlers configuration rules:
- StreamHandler will be used if syslog_tag or file_name are omitted or empty strings
- SysLogHandler will be used if syslog_tag is set to none-empty string
- TimedRotatingFileHandler will be used if file_name is set to none-empty string
- ValueError will be raised if both syslog_tag and file_name are set to none-empty string
Installation
pip install -U easylogconfig
# or
pip install -U git+https://github.com/tierpod/easylogconfig#egg=easylogconfig
Development
make venv
source ./venv/bin/activate
(venv) make init-dev init
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
easylogconfig-0.1.4.tar.gz
(3.2 kB
view hashes)
Built Distribution
Close
Hashes for easylogconfig-0.1.4-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 93dbc89a71b1862681ff2e789fd8fb656788228e51e732b69c259d8fd3045e27 |
|
MD5 | 4287d3090ab7efc294df9b86afd28365 |
|
BLAKE2b-256 | c7d71ed20dc70c02b7487e530b77e615281a542425ac50d9e5460a59498012ae |