History

Chang Bo Guo 683206d237 Follow hacking rules about import

This patch follows the rules about import in HACKING.rst
https://github.com/openstack/marconi/blob/master/HACKING.rst#imports

* reorder imports
* Add missing blank lines before code

Change-Id: I4abcfb3a2640499c5df34cbf75b5eaecb3d19823

2013-10-11 20:06:35 -07:00

wsgi

Follow hacking rules about import

2013-10-11 20:06:35 -07:00

__init__.py

Pull actual tests out of marconi/tests

2013-09-06 10:56:41 +02:00

README.rst

Move functional tests into wsgi/v1

2013-09-10 11:47:40 +02:00

README.rst

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)

Setup a Marconi server. Refer to the Marconi README on how to run Marconi locally, or simply use an existing server.
Change $MARCONI_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 Marconi server. Refer to the Marconi README on how to run Marconi 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 marconi/tests/functional directory
Copy marconi/tests/etc/functional-tests.conf-sample to one of the following locations:
```
~/.marconi/functional-tests.conf
/etc/marconi/functional-tests.conf
```
Update the config file to point to the Marconi server you want to run the tests against
If leaving keystone auth enabled, update system-tests.conf with a valid set of credentials.
Now, to run the sytem tests, simply use the nosetests commands, e.g.:
Run all test suites: :
```
nosetests --tests tests.functional -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