Extension to Python `logging` functionality intended for TUNE Multiverse Integrations.
Project description
logging-mv-integrations
Extension to Python logging functionality intended for TUNE Multiverse Integrations.
Badges
info |
|
---|---|
tests |
|
package |
Install
pip install logging_mv_integrations
Architecture
logging-mv-integrations is an extension of the logging facility for Python used for TUNE Multiverse Integrations providing custom logger levels, format, and output.
Function: get_logger()
def get_logger(
logger_name,
logger_version=None,
logger_level=logging.INFO,
logger_format=LoggingFormat.JSON,
logger_output=LoggingOutput.STDOUT_COLOR,
logger_handler=None
):
get_logger(): Parameters
Parameter |
Purpose |
---|---|
logger_name |
Return a logger with the specified name or, if name is None, return a logger which is the root logger of the hierarchy. |
logger_version |
|
logger_format |
LoggingFormat |
logger_output |
LoggingOutput |
logger_handler |
logging.StreamHandler() or logging.FileHandler() |
Logging Levels
Same Python logging levels, including one additional level NOTE.
Level |
Purpose |
---|---|
DEBUG |
Detailed information, typically of interest only when diagnosing problems. |
NOTE |
Detailed information, request processing, for example, request using cURL. |
INFO |
Confirmation that things are working as expected. [DEFAULT] |
WARNING |
An indication that something unexpected happened, or indicative of some problem in the near future. The software is still working as expected. |
ERROR |
Due to a more serious problem, the software has not been able to perform some function. |
CRITICAL |
A serious error, indicating that the program itself may be unable to continue running. |
Logging Format
Format |
Purpose |
---|---|
STANDARD |
Standard logging format. |
JSON |
JSON logging format. [DEFAULT] |
class LoggingFormat(object):
"""TUNE Logging Format ENUM
"""
STANDARD = "standard"
JSON = "json"
Logging Output
Output |
Purpose |
---|---|
STDOUT |
Standard Output to terminal |
STDOUT_COLOR |
Standard Output using colored terminal |
FILE |
Standard Output to file created within ./tmp/log_<epoch time seconds>.json. |
class LoggingOutput(object):
"""TUNE Logging Output ENUM
"""
STDOUT = "stdout"
STDOUT_COLOR = "color"
FILE = "file"
Logging JSON Format
import logging
from logging_mv_integrations import (LoggingFormat, get_logger, __version__)
log = get_logger(
logger_name=__name__,
logger_version=__version__,
logger_format=LoggingFormat.JSON,
logger_level=logging.NOTE
)
log.info("logging: info", extra={'test': __name__})
log.note("logging: note", extra={'test': __name__})
log.debug("logging: debug", extra={'test': __name__})
log.warning("logging: warning", extra={'test': __name__})
log.error("logging: error", extra={'test': __name__})
log.critical("logging: critical", extra={'test': __name__})
log.exception("logging: exception", extra={'test': __name__})
Logging JSON Example Output
$ python3 examples/example_logging_json.py
{"asctime": "2017-10-20 08:31:14 -0700", "levelname": "INFO", "name": "__main__",
"version": "0.1.6", "message": "logging: info", "test": "__main__"}
{"asctime": "2017-10-20 08:31:14 -0700", "levelname": "NOTE", "name": "__main__",
"version": "0.1.6", "message": "logging: note", "test": "__main__"}
{"asctime": "2017-10-20 08:31:14 -0700", "levelname": "WARNING", "name": "__main__",
"version": "0.1.6", "message": "logging: warning", "test": "__main__"}
{"asctime": "2017-10-20 08:31:14 -0700", "levelname": "ERROR", "name": "__main__",
"version": "0.1.6", "message": "logging: error", "test": "__main__"}
{"asctime": "2017-10-20 08:31:14 -0700", "levelname": "CRITICAL", "name": "__main__",
"version": "0.1.6", "message": "logging: critical", "test": "__main__"}
{"asctime": "2017-10-20 08:31:14 -0700", "levelname": "ERROR", "name": "__main__",
"version": "0.1.6", "message": "logging: exception", "exc_info": "NoneType: None",
"test": "__main__"}
Requirements
logging-mv-integrations module is built upon Python 3 and has dependencies upon several Python modules available within Python Package Index PyPI.
make install-requirements
or
python3 -m pip uninstall --yes --no-input -r requirements.txt
python3 -m pip install --upgrade -r requirements.txt
Dependencies
coloredlogs: https://pypi.python.org/pypi/coloredlogs
pprintpp: https://pypi.python.org/pypi/pprintpp
python-json-logger: https://pypi.python.org/pypi/python-json-logger
Pygments: https://pypi.python.org/pypi/Pygments
safe-cast: https://pypi.python.org/pypi/safe-cast
Release History
0.4.0 (2017-11-24)
README
0.3.2 (2017-11-21)
README
Travis CI
0.1.7 (2017-10-26)
Using Formatted String Literals
0.1.6 (2017-10-19)
Logging Output: FILE, STDOUT, STDOUT_COLOR
0.1.5 (2017-10-17)
Fix standard format
0.1.4 (2017-10-09)
Multiple handlers fix
0.1.3 (2017-09-12)
Use python standard logging instead of tune_logging and remove all unneeded files
0.1.2 (2017-02-03)
Switch to using casting from safe-cast package
0.1.1 (2017-02-03)
Python 3.6 Upgrade
0.0.1 (2016-11-19)
First Commit
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 Distributions
Hashes for logging-mv-integrations-0.5.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 25a2197e12940842513e84262644fececf1e3059b432e86dfb17f58bb3ebef86 |
|
MD5 | 4d3eca74e05517d44bebd5f0f5090503 |
|
BLAKE2b-256 | 67319f3bff355ea590293a430b2b307139655b2273791715650f9110b342b118 |
Hashes for logging_mv_integrations-0.5.1-py3.6.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | 618ea6002e16c604b9cc1a6c6d60bd20645e8567f7b8a6b7d6ba9461679b4798 |
|
MD5 | 62414f19c816bbed31691649da4a32a2 |
|
BLAKE2b-256 | dc7d8f5620c4546ea8ac930372001beec4f63bcaeec318fc8a530a07b6d684b5 |
Hashes for logging_mv_integrations-0.5.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7ab60f0d7295606de870ababdaf1b58b1db538dc28fa9d31c8c305c1ddf0c873 |
|
MD5 | 4d90d9dea2dbe4e37e0e8c362e5166d1 |
|
BLAKE2b-256 | 543439009ab3b755eda81849a5c6eaa9831f0a6ac3b4c911b3b28952a82c6f46 |