diff options
author | Brant Knudson <bknudson@us.ibm.com> | 2014-01-12 11:04:04 -0600 |
---|---|---|
committer | Brant Knudson <bknudson@us.ibm.com> | 2014-01-14 14:47:55 -0600 |
commit | eb79d256b39660dfe0b91667ca4663f520ef20cf (patch) | |
tree | 9ae60b7dd26778a8a2b17274ded4ca0db7d13663 | |
parent | 01d26314d316d61443ee3a4c55f6d06bac477600 (diff) | |
download | keystone-eb79d256b39660dfe0b91667ca4663f520ef20cf.tar.gz |
Restructure developing.rst
The "Developing with Keystone" file was incorrectly structured.
1) The "Building the Documentation" section was under the
"dogpile.cache based Key-Value-Store (KVS)" section, which it's
got nothing to do with.
2) The "Running Tests" section was under the "Initial Sample Data"
section, which it's got nothing to do with.
3) Several testing-related sections could be put under their own
"Testing" section to keep them together.
Change-Id: Icb0c63385d9ccc24b91d17e057e60346ce1a648e
-rw-r--r-- | doc/source/developing.rst | 19 |
1 files changed, 12 insertions, 7 deletions
diff --git a/doc/source/developing.rst b/doc/source/developing.rst index 342f2abc8..f7af31497 100644 --- a/doc/source/developing.rst +++ b/doc/source/developing.rst @@ -120,6 +120,10 @@ Once run, you can see the sample data that has been created by using the $ tools/with_venv.sh keystone --os-token ADMIN --os-endpoint http://127.0.0.1:35357/v2.0/ user-list + +Testing +------- + Running Tests ============= @@ -157,7 +161,7 @@ common configuration of Python 2.7 and PEP-8), list the environments with the See ``tox.ini`` for the full list of available test environments. Test Structure --------------- +============== Not all of the tests in the tests directory are strictly unit tests. Keystone intentionally includes tests that run the service locally and drives the entire @@ -186,7 +190,7 @@ of python-keystoneclient, and then verifying it against a temporarily running local instance to explicitly verify basic functional testing across the API. Testing Schema Migrations -------------------------- +========================= The application of schema migrations can be tested using SQLAlchemy Migrate’s built-in test runner, one migration at a time. @@ -209,7 +213,7 @@ of your data during migration. Writing Tests -------------- +============= To add tests covering all drivers, update the relevant base test class (``test_backend.py``, ``test_legacy_compat.py``, and @@ -221,7 +225,7 @@ configuration of the test class in ``setUp()``. Further Testing ---------------- +=============== devstack_ is the *best* way to quickly deploy keystone with the rest of the OpenStack universe and should be critical step in your development workflow! @@ -235,8 +239,9 @@ You may also be interested in either the .. _OpenStack Integration Testing Project: https://github.com/openstack/tempest -LDAP ----- +LDAP Tests +========== + LDAP has a fake backend that performs rudimentary operations. If you are building more significant LDAP functionality, you should test against a live LDAP server. Devstack has an option to set up a directory server for @@ -445,7 +450,7 @@ globally unique. Building the Documentation -========================== +-------------------------- The documentation is generated with Sphinx uning the tox command. To create HTML docs and man pages:: |