The Régis Kla Python tools library
Project description
rktools
A general purpose Python library.
[![Build Status][travis-image]][travis-url] [![Downloads Stats][npm-downloads]][npm-url]
rktools is a general purpose Python Library. It is originally designed after the needs of several small tools during Python projects development.
Introduction
The library is organized around dedicated modules for monitoring processes, for loggings events, and so forth:
- loggers: A simple Python logging wrapper that provide additional features such as http server logging handler management...
- monitors: A set of monitoring tools to provide visibility to the end user. For instance, it provide ProgressBar which is a tqdm wrapper, and so forth
Install
rktools is currently supported only for Linux systems. However, since it is written with pure Python, it should run without any problem on all platforms.
Using pip
The easiest way to install rktools is using pip to fetch it from Pypi as follows:
$ pip install rktools
Using rktools
The modules usage is as follows.
Loggers
Import the init_logger function from the rktools.loggers module:
from rktools.loggers import init_logger
Declare and initialize a logger global (or local variable) :
...
logger = init_logger(name="test_monitors", config = config)
...
The returned logger object is an instance of Python logging.Logger class. Also notice that the Python logging package can be required if you want to override the logging level:
import logging
...
logger = init_logger(name="test_monitors", config = config, level = logging.getLevelName("DEBUG"))
...
Use the logger object the same way you use the Python logging.Logger object:
...
logger.debug("A debug message!")
logger.info("A info message!")
logger.warning("A warn message!")
logger.error("A error message!")
logger.critical("A critical message!")
...
Find more details in the reference documentation here.
Monitoring
Import the ProgressBar class from the monitors module:
from rktools.monitors import ProgressBar
Changes
- 0.0.1
- Lib creation. Work in progress
Feedback
Open a ticket / fork the project on GitHub, or send me an email at klaregis@gmail.com.
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 rktools-0.0.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | eb383e56acfcd9606563c849f0b32f1bad9fd23428e84c5b4145abccbd78af20 |
|
MD5 | 24a04b164547dd1d15757878df8b9ce7 |
|
BLAKE2b-256 | 123ec86b2deb1f9887520d2041b19b931f8b06ac4feee2786ad36391aceeebba |