Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rktools-0.0.1.tar.gz (7.6 kB view hashes)

Uploaded Source

Built Distribution

rktools-0.0.1-py2.py3-none-any.whl (8.3 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page