RETIRED, Part of OpenStack's Oslo project. New Oslo APIs go through an incubation phase in this repository before being released as part of a proper Python library.
Go to file
Jenkins b7ad6ddab8 Merge "Script for running unit tests in other projects" 2014-04-03 13:10:41 +00:00
doc/source Convert unicode strings for python3 portability 2013-05-07 11:55:56 -05:00
etc Remove rootwrap from incubator 2014-02-14 14:35:39 +01:00
openstack Ignore migrate versioning tables in utf8 sanity check 2014-04-02 10:38:07 -07:00
pypi Rename Openstack to OpenStack 2014-02-13 16:05:04 +08:00
tests Ignore migrate versioning tables in utf8 sanity check 2014-04-02 10:38:07 -07:00
tools Script for running unit tests in other projects 2014-03-27 15:19:57 -07:00
.coveragerc Update .coveragerc 2013-02-06 16:47:06 +02:00
.gitignore Remove requirements.txt from .gitignore 2014-03-06 17:03:31 +02:00
.gitreview Correcting openstack-common mv to oslo-incubator. 2012-11-11 23:44:12 +00:00
.mailmap Update mailmap for Joe Gordon 2013-10-28 10:11:02 +00:00
.testr.conf Run tests in parallel as much as possible 2014-02-10 18:10:16 +00:00
HACKING.rst Update URL for global HACKING document 2013-11-11 10:36:08 -08:00
LICENSE Incorporating MIT licensed code 2013-12-02 11:57:19 +00:00
MAINTAINERS notify calling process we are ready to serve 2014-02-26 21:00:07 +01:00
MANIFEST.in Don't include versioninfo in manifest. 2013-01-14 03:17:32 -08:00
README.rst The ability to run tests at various backend 2013-11-26 14:48:32 +02:00
TESTING.rst Creates a new file TESTING.rst. 2013-06-20 20:44:43 -04:00
requirements-py3.txt Updated from global requirements 2014-03-24 16:51:43 +00:00
requirements.txt Updated from global requirements 2014-03-24 16:51:43 +00:00
run_tests.sh Move `./run_tests.sh` to Oslo 2013-08-13 18:06:11 +03:00
setup.cfg Re-raise exception of unloadable library 2014-03-13 08:43:22 +01:00
setup.py Updated from global requirements 2013-12-10 07:23:28 -05:00
test-requirements-py3.txt Updated from global requirements 2014-02-23 09:30:30 +00:00
test-requirements.txt Updated from global requirements 2014-02-23 09:30:30 +00:00
tox.ini Merge "Python3: enable test_jsonutils.py" 2014-03-18 19:14:31 +00:00
update.py Support copying scripts outside of modules 2014-03-27 15:19:55 -07:00
update.sh Fix typo in update.py 2013-12-30 13:00:22 +08:00

README.rst

The Oslo Incubator

The Oslo program produces a set of python libraries containing infrastructure code shared by OpenStack projects. The APIs provided by these libraries should be high quality, stable, consistent and generally useful.

The process of developing a new Oslo API usually begins by taking code which is common to some OpenStack projects and moving it into this repository. Incubation shouldn't be seen as a long term option for any API - it is merely a stepping stone to inclusion into a published Oslo library.

For more information, see our wiki page:

https://wiki.openstack.org/wiki/Oslo

Running Tests

To run tests in virtualenvs (preferred):

sudo pip install tox tox

To run tests in the current environment:

sudo pip install -r requirements.txt nosetests

To run tests using MySQL or PostgreSQL as a DB backend do:

OS_TEST_DBAPI_ADMIN_CONNECTION=mysql://user:password@host/database tox -e py27

Note, that your DB user must have permissions to create and drop databases.