cletus 1.0.15

A library of command line utilities

Cletus is a library to help with commmand line python programs.

It includes: - cletus_config: makes it easy for a program to combine config files, environmental variables, and arguments into a single schema-validated config. - cletus_supp: allows programs and users to “suppress” actions with a program simply by touching a file in a dedicated directory. The suppression action may be to quit, or to simply sleep or temporarily suspend processing. - cletus_log: just boilerplate for common logging. - cletus_job: a well-tested mechanism that uses a pid file to ensure that the same file doesn’t get run twice.

More info is on the cletus wiki here: https://github.com/kenfar/cletus/wiki

Installation

• Using pip (preferred) or easyinstall:

  _~ $ pip install cletus $ easy_install cletus _~

• Or install manually from pypi:

  _~ $ mkdir ~$ wget https://pypi.python.org/packages/source/d/cletus/cletus-0.1.tar.gz $ tar -xvf easy_install cletus $ cd ~-* $ python setup.py install _~

Dependencies

• Any of: python 2.7, 3.4, 3.5 or pypy

Licensing

• Cletus uses the BSD license - see the separate LICENSE file for further information

Copyright

• Copyright 2013, 2014, 2015, 2016 Ken Farmer

v1.0.15 - 2018-05

• setup

  • alter: replace pip’s req module with simple readline to deal with pip 10

v1.0.14 - 2016-08

• cletus_logger

  • add: user-customizable delimiter to log output

v1.0.13 - 2016-05

• all

  • add: minor changes tox.ini to support python 2.7, 3.4, 3.5, and pypy

v1.0.12 - 2015-09

• cletus_supp.py

  • add: silent arg to SuppressCheck() class to suppress all logging. Needed to handle logging volume when continually-checking for suppressions.

v1.0.11 - 2015-05

• cletus_config.py

  • fix: improved defaulting

• everything:

  • ran modernizer to make the code more python3-ready

v1.0.10 - 2015-03

• cletus_config.py

  • fix: diminished logging

v1.0.8 - 2015-01

• cletus_config.py

  • added tests to confirm optional column NULLs

  • added remove_null_overrides to simplify use

  • added apply_defaults to simplify use

  • fix: stopped putting copy of sample configs in /tmp

v1.0.6 - 2014-07

• cletus_archiver.py

  • added comments

  • added config to setup

v1.0.5 - 2014-07

• cletus_archiver.py

  • moved to script dir from example

  • setup changed to include archiver & config file

• cletus_supp.py

  • check suppressions directory only when the suppressions method is called, so it can be called repeatedly at checkpoints by an app.

  • changed suppressions method behavior to default app_name to init app_name.

v1.0.4 - 2014-07

• cletus_job

  • changed to use flock exclusively rather than the pid from the pidfile and a check to see if that pid was still being used. This eliminates a big race condition.

  • added concurrency testing

• cletus_config

  • added namespace, dictionary and env config inputs

  • added namespace

  • added test harness

v1.0.1 - 2014-03

• cletus_log

  • initial add

• cletus_config

  • initial add

• cletus_supp

  • initial add

• cletus_job

  • initial add