openstack/deb-python-django-openstack-auth
Code Issues Proposed changes
Files
cf129a68837c3cc00609946afe819a0c2cef0aec
deb-python-django-openstack…/doc/source/installation.rst
James Muranga 613da0b10e Updated the installation instructions 
Changed the name of the app from keystone_auth to
openstack_auth in the installation instructions

Removed the redudant installation instructions in README.rst

Change-Id: If97c93a446754573bd6fb55b15cb4c881ad1f4e6
2014-11-12 22:47:48 +03:00

1.6 KiB
Raw Blame History

Getting Started

Installation

Installing is quick and easy:

  1. Run pip install django_openstack_auth.

  2. Add openstack_auth to settings.INSTALLED_APPS.

  3. Add 'openstack_auth.backend.KeystoneBackend' to your settings.AUTHENTICATION_BACKENDS, e.g.:

    AUTHENTICATION_BACKENDS = ('openstack_auth.backend.KeystoneBackend',)

  4. Configure your API endpoint(s) in settings.py:

    OPENSTACK_KEYSTONE_URL = "http://example.com:5000/v3"

  5. Include 'openstack_auth.urls' somewhere in your urls.py file.

  6. Use it as you would any other Django auth backend.

Running Tests

Before running tests, you should have tox installed and available in your environment:

$ pip install tox

Note

You may need to perform both the above operation and the next inside a python virtualenv, or prefix the above command with sudo, depending on your preference.

To execute the full suite of tests maintained within the project, simply run:

$ tox

Note

The first time you run tox, it will take additional time to build virtualenvs. You can later use the -r option with tox to rebuild your virtualenv in a similar manner.

To run tests for one or more specific test environments (for example, the most common configuration of Python 2.7 and PEP-8), list the environments with the -e option, separated by spaces:

$ tox -e py27,pep8

See tox.ini for the full list of available test environments.