README.rst

Python Application Project Template

This is a Cookiecutter template for creating a Python application project.

The project layout is based on the Python Packaging User Guide. The current conventional wisdom forgoes the use of a source directory, but moving the package out of the project root provides several advantages (cf. Packaging a Python library).

The py27 branch is for Python 2.7 compatibility; it is no longer actively maintained.

Template Project Features

• Python 3.4+
• MIT License
• pytest test suite
• Sphinx documentation

Template Application Features

• CLI with subcommands
• Logging
• Hierarchical YAML configuration

Usage

Install Python requirements for using the template:

$ python -m pip install --requirement=requirements.txt --user

Create a new project directly from the template on GitHub:

$ cookiecutter gh:mdklatt/cookiecutter-python-app