A library of command line utilities

pip install cletus==1.0.15


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


  • Using pip (preferred) or easyinstall:

    $ pip install cletus
    $ easy_install cletus
  • Or install manually from pypi:

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


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


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


  • Copyright 2013, 2014, 2015, 2016 Ken Farmer