Cookiecutter Template for new OpenStack projects
Go to file
Jamie Lennox 543d0e81a5 Automatically initialize git when finished.
PBR will refuse to work or allow users to run tests until there is a git
repository set up. It is easier to just do this automatically than have
to explain it in the docs.

Change-Id: Ied9ccab2665c4542e2ec2ee42174c3e15e166880
2014-09-04 14:59:03 +10:00
hooks Automatically initialize git when finished. 2014-09-04 14:59:03 +10:00
{{cookiecutter.repo_name}} Merge "Use spaces instead of tabs for indentation" 2014-08-13 12:35:16 +00:00
.gitignore Ignore created boilerplate/ dir. 2013-08-16 20:59:16 +02:00
.gitreview Add .gitreview file 2013-08-18 15:42:02 -04:00
CONTRIBUTING.rst Add a CONTRIBUTING file with bug tracker info 2013-09-20 16:44:41 -07:00
README.rst Automatically initialize git when finished. 2014-09-04 14:59:03 +10:00
cookiecutter.json Add src and bug links to README 2014-02-24 08:28:41 -08:00

README.rst

cookiecutter-openstack

Cookiecutter template for an OpenStack project. See https://github.com/audreyr/cookiecutter.

  • 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
  • Sphinx docs: Documentation ready for generation and publication

Usage

Generate a Python package project:

cookiecutter https://git.openstack.org/openstack-dev/cookiecutter.git

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

Then:

  • Add the project to the OpenStack Infrastructure