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.

Files for rktools, version 0.0.1
Filename, size File type Python version Upload date Hashes
Filename, size rktools-0.0.1-py2.py3-none-any.whl (8.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size rktools-0.0.1.tar.gz (7.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page