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 15ea4ffdbc Merge "db.sqlalchemy.session add [sql].idle_timeout" 2013-12-11 04:01:54 +00:00
doc/source Convert unicode strings for python3 portability 2013-05-07 11:55:56 -05:00
etc/oslo Remove unused etc/openstack-common.conf.test 2013-01-21 13:10:53 +00:00
openstack Merge "db.sqlalchemy.session add [sql].idle_timeout" 2013-12-11 04:01:54 +00:00
pypi Update references with new Mailing List location 2013-07-29 08:56:33 -07:00
tests Merge "db.sqlalchemy.session add [sql].idle_timeout" 2013-12-11 04:01:54 +00:00
tools Replace data structures' attribute with six module 2013-11-29 04:37:05 -08:00
.coveragerc Update .coveragerc 2013-02-06 16:47:06 +02:00
.gitignore Add eclipse project files to .gitignore 2013-07-18 22:45:38 +00: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 The ability to run tests at various backend 2013-11-26 14:48:32 +02: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 Merge "Remove authutils" 2013-12-03 13:51:08 +00: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.txt Updated from global requirements 2013-12-10 07:23:28 -05:00
run_tests.sh Move `./run_tests.sh` to Oslo 2013-08-13 18:06:11 +03:00
setup.cfg Add IgnoreAttemptedHostsFilter to oslo 2013-12-07 18:09:55 -05:00
setup.py Updated from global requirements 2013-12-10 07:23:28 -05:00
test-requirements.txt Pin sphinx to <1.2 2013-12-10 20:14:57 +00:00
tox.ini Fix locking in migration tests 2013-12-02 18:28:02 +00:00
update.py Remove vim header 2013-11-25 12:16:11 +08:00
update.sh readd update.sh to address bootstrapping issue 2013-02-20 08:45:12 -05: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.