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 ba4d2ee166 Merge "Avoid failure of test_basic_report on 32 bit OS" 2014-02-11 01:48:26 +00:00
doc/source Convert unicode strings for python3 portability 2013-05-07 11:55:56 -05:00
etc/oslo Backport 'ident' from python 3.3 for Oslo's SysLogHandler 2014-01-20 11:02:48 +02:00
openstack Merge "Automatic retry db.api query if db connection lost" 2014-02-10 13:07:57 +00:00
pypi Update references with new Mailing List location 2013-07-29 08:56:33 -07:00
tests Merge "Avoid failure of test_basic_report on 32 bit OS" 2014-02-11 01:48:26 +00:00
tools Add tool for helping with library graduation 2014-02-05 06:46:43 -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 Make the log capture in tests more configurable 2014-01-10 18:11:01 +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 Merge "Add missing entries to MAINTAINERS" 2014-01-28 04:27:21 +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 Merge "Transition from migrate to alembic" 2014-01-27 12:51:00 +00:00
run_tests.sh Move `./run_tests.sh` to Oslo 2013-08-13 18:06:11 +03:00
setup.cfg Transition from migrate to alembic 2014-01-17 23:39:25 +00: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 Add check_maintainers.py script 2014-01-26 01:54:42 +00:00
update.py Remove vim header 2013-11-25 12:16:11 +08: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.