python_template_with_config

This is a template for a simple Python project including:

unit test with test environment (via environment variable)
main file with argparse template for command line arguments
config folder with simple structure for testing and production environments
future imports to make Python 3 porting easier
logging configured with ISO-8601 date (parseable by dateutil.parser), process number, file and line number

Python coding template including ENV environment variable configuration::

$ PYTHON_TEMPLATE_CONFIG=testing python test_start_here.py  # run unit tests

To run the main code use::

$ PYTHON_TEMPLATE_CONFIG=production python start_here.py --help

Note that 'testing' will be assumed in config/init.py if PYTHON_TEMPLATE_CONFIG is not available as an environment variable.

Some notes:

for unit testing it is useful to add nosetests (pip install nose) and Ned Batchelder's coverage.py.
pip is useful for installing, use pip freeze > requirements.txt to free versions of the libraries you're using
when logging prefer to use %r or %s in the message rather than more specific types (e.g. %d) as e.g. a %d will raise another exception if None is received but %r can handle the None and a decimal number

CONSIDER ADDING:

suitable subdir structure for setup.py and a setup.py with deployment notes