cletus 1.0.15
A library of command line utilities
License: BSD
Keywords: utility

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 <http://www.pip-installer.org/en/latest/>`__ (preferred)
   or
   `easyinstall <http://peak.telecommunity.com/DevCenter/EasyInstall>`__:

   :sub:`~` $ pip install cletus $ easy\_install cletus :sub:`~`

-  Or install manually from
   `pypi <https://pypi.python.org/pypi/cletus>`__:

   :sub:`~` $ 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
   :sub:`~`

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