| commit | e2ee8fd1dfb299d4dff68fe698e3f64414f00ab2 | [log] [tgz] |
|---|---|---|
| author | Robert Gemmell <robbie@apache.org> | Mon Jul 11 10:30:41 2016 +0100 |
| committer | Robert Gemmell <robbie@apache.org> | Mon Jul 11 10:30:41 2016 +0100 |
| tree | 3672acea165c3c1ce8c72d739c4fb65b0225a983 | |
| parent | df067741f0740db36538b1d402d62dc3c7ad1b8f [diff] |
QPID-7207: further trivial update, remove stale description and link to site. Testing GitHub integration.
This distribution contains a Python client implementation and AMQP conformance tests for Apache Qpid.
You can read more about Qpid here:
http://qpid.apache.org/
Documentation can be found here:
http://qpid.apache.org/documentation.html
Make sure the Qpid Python client libraries are on your PYTHONPATH. Extract the archive and add the local directory to your PYTHONPATH:
$ tar -xf qpid-python-VERSION.tar.gz $ cd qpid-python-VERSION $ export PYTHONPATH=$PWD:$PYTHONPATH
Make sure a broker is running.
Run the ‘hello’ example from examples/api:
$ cd examples/api $ ./hello Hello world!
The examples/api directory contains several examples.
Read examples/README.txt for further details on these examples.
The “tests” directory contains a collection of unit tests for the python client. The “tests_0-10”, “tests_0-9”, and “tests_0-8” directories contain protocol level conformance tests for AMQP brokers of the specified version.
The qpid-python-test script may be used to run these tests. It will by default run the python unit tests and the 0-10 conformance tests:
Run a broker on the default port.
Run the tests:
$ ./qpid-python-test
If you wish to run the 0-8 or 0-9 conformence tests, they may be selected as follows:
Run a broker on the default port.
Run the tests:
$ ./qpid-python-test tests_0-8.* [or] $ ./qpid-python-test tests_0-9.*
See the qpid-python-test usage for for additional options:
$ ./qpid-python-test -h
Other Qpid components depend on Qpid Python for testing. You can use setup.py to install Qpid Python to a standard location:
# User-local install $ python setup.py install --user $ export PYTHONPATH=$HOME/.local/lib/python2.7/site-packages $ export PATH=$HOME/.local/bin:$PATH [or] # System-wide install $ sudo python setup.py install