zaqar/tests/functional
Fei Long Wang b6efb90a0b Improve cleanup of test_insert_queue_header_asterisk
Based on current implement, the queue created by
test_insert_queue_header_asterisk won't be deleted.
As a result, develper will run into unit test failure
like 204!=201. This fix will add the headers param to
make sure the queue can be cleaned up.

Closes-Bug: #1284995

Change-Id: If415c4f73604ae0f9d2d37daba3aa3f0ca693b6a
2014-03-28 13:37:15 +08:00
..
wsgi Improve cleanup of test_insert_queue_header_asterisk 2014-03-28 13:37:15 +08:00
__init__.py Pull actual tests out of marconi/tests 2013-09-06 10:56:41 +02:00
README.rst Merge "Fix functional config file instructions" 2014-03-25 03:27:18 +00:00

Marconi Functional Tests ====================

Marconi's functional tests treat Marconi 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)

  1. Setup a Marconi server. Refer to the Marconi README on how to run Marconi locally, or simply use an existing server.

  2. Change $MARCONI_TESTS_CONFIGS_DIR/functional-tests.conf and set run_tests to True.

  3. Run tests. :

    $ tox
  4. Filter tests. :

    $ tox -- --tests tests.functional.wsgi.v1.test_messages
  5. Run tests for specific environments. :

    $ tox -epy27,pep8

Running the Functional Tests (Without Tox)

  1. Setup a Marconi server. Refer to the Marconi README on how to run Marconi locally, or simply use an existing server.

  2. Install functional tests dependencies. :

    pip install -r requirements.txt
    pip install -r test-requirements.txt
  3. cd to the marconi/tests/functional directory

  4. Copy tests/etc/functional-marconi.conf to one of the following locations:

    ~/.marconi/functional-tests.conf
    /etc/marconi/functional-tests.conf
  5. Update the config file to point to the Marconi server you want to run the tests against

  6. If leaving keystone auth enabled, update system-tests.conf with a valid set of credentials.

  7. Now, to run the system tests, simply use the nosetests commands, e.g.:

    Run all test suites: :

    nosetests --tests tests.functional -v

Adding New Tests

  1. Add test case to an appropriate test case file: :

    queue/test_queue.py
    messages/test_messages.py
    claim/test_claims.py