36e63c9a45
This patch renames every package, file, match of Marconi in the codebase to Zaqar *except* for the .gitreview file, which will have to be updated *after* I8e587af588d9be0b5ebbab4b0f729b106a2ae537 lands. Implements blueprint: project-rename Change-Id: I63cf2c680cead4641f3e430af379452058bce5b3
63 lines
1.5 KiB
ReStructuredText
63 lines
1.5 KiB
ReStructuredText
Zaqar Functional Tests
|
|
======================
|
|
|
|
Zaqar's functional tests treat Zaqar as a black box. In other
|
|
words, the API calls attempt to simulate an actual user. Unlike unit tests,
|
|
the functional tests do not use mockendpoints.
|
|
|
|
|
|
Running functional tests (With Tox)
|
|
-----------------------------------
|
|
|
|
#. Setup a Zaqar server. Refer to the Zaqar `README`_ on
|
|
how to run Zaqar locally, or simply use an existing server.
|
|
|
|
#. Change `$ZAQAR_TESTS_CONFIGS_DIR/functional-tests.conf` and
|
|
set `run_tests` to True.
|
|
|
|
#. Run tests. ::
|
|
|
|
$ tox
|
|
|
|
#. Filter tests. ::
|
|
|
|
$ tox -- --tests tests.functional.wsgi.v1.test_messages
|
|
|
|
#. Run tests for specific environments. ::
|
|
|
|
$ tox -epy27,pep8
|
|
|
|
Running the Functional Tests (Without Tox)
|
|
------------------------------------------
|
|
|
|
#. Setup a Zaqar server. Refer to the Zaqar `README`_ on
|
|
how to run Zaqar locally, or simply use an existing server.
|
|
|
|
#. Install functional tests dependencies. ::
|
|
|
|
pip install -r requirements.txt
|
|
pip install -r test-requirements.txt
|
|
|
|
#. cd to the tests/etc directory
|
|
|
|
#. If leaving keystone auth enabled, update functional-tests.conf with a
|
|
valid set of credentials.
|
|
|
|
#. Now, to run the system tests, simply use the nosetests commands, e.g.:
|
|
|
|
Run all test suites: ::
|
|
|
|
nosetests -v
|
|
|
|
Adding New Tests
|
|
----------------
|
|
|
|
#. Add test case to an appropriate test case file: ::
|
|
|
|
queue/test_queue.py
|
|
messages/test_messages.py
|
|
claim/test_claims.py
|
|
|
|
.. _README : https://github.com/openstack/zaqar/blob/master/README.rst
|
|
.. _requests : https://pypi.python.org/pypi/requests
|