Cookiecutter Template for new OpenStack projects
Python Shell
Latest commit a293dca Nov 18, 2016 @jimrollenhagen jimrollenhagen Sync with global-requirements
* Update test-requirements to match global-requirements
* Bump pbr to 1.8 to match global-requirements
* Update to match global requirements version

Change-Id: I32879b6a2f446e434dc5740a4f2c2ad46b0824b5



Cookiecutter template for an OpenStack project. See

  • Free software: Apache license
  • pbr: Set up to use Python Build Reasonableness
  • hacking: Enforces the OpenStack Hacking Guidelines
  • testrepository: Runs tests using testrepository
  • OpenStack-Infra: Ready for OpenStack Continuous Integration testing
  • Tox testing: Setup to easily test for Python 2.6, 2.7, 3.3, 3.4
  • Sphinx docs: Documentation ready for generation and publication


Generate a Python package project:


OpenStack projects require a working git repo for pbr to work, on newer versions of cookiecutter (>= 0.7.0 released 2013-11-09) this inital commit will be done automatically. Otherwise you will need to init a repo and commit to it before doing anything else:

cd $repo_name
git init
git add .
git commit -a


  • Add the project to the OpenStack Infrastructure