Cookiecutter Template for new Oslo libraries
Go to file
Doug Hellmann 4f98d98cba Fix .gitreview and use of oslosphinx
Update the endpoint for git review and switch from oslo.sphinx
to oslosphinx.

Change-Id: I395760e06e572a631ed7f1ab07b215a51c878067
2014-02-18 08:47:29 -05:00
oslo.{{cookiecutter.module_name}} Fix .gitreview and use of oslosphinx 2014-02-18 08:47:29 -05:00
.gitignore Ignore created boilerplate/ dir. 2013-08-16 20:59:16 +02:00
.gitreview Fix .gitreview and use of oslosphinx 2014-02-18 08:47:29 -05:00
CONTRIBUTING.rst Add a CONTRIBUTING file with bug tracker info 2013-09-20 16:44:41 -07:00
README.rst Update for use with oslo libraries 2014-01-31 15:22:08 -08:00
cookiecutter.json Update for use with oslo libraries 2014-01-31 15:22:08 -08:00

README.rst

oslo-cookiecutter-openstack

Cookiecutter template for an Oslo library (part of the 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/oslo-cookiecutter.git

Oslo libraries require a working git repo for pbr to work, so you need to init a repo and commit to it before doing anything else:

cd oslo.$module_name
git init
git add .
git commit -a

Then:

  • Add the project to the OpenStack Infrastructure