| commit | 5d820c717de3bc0c64e628d68c024f20e409ed33 | [log] [tgz] |
|---|---|---|
| author | Robbie Gemmell <robbie@apache.org> | Wed Nov 22 18:37:39 2017 +0000 |
| committer | Robbie Gemmell <robbie@apache.org> | Wed Nov 22 18:37:39 2017 +0000 |
| tree | 5b4f5dca420fa6fc360b7d21234d8c492b42e5f5 | |
| parent | e71238d512a993fe9c93dcbecfb1ed42d637519c [diff] |
QPID-8051: update the notes to use setup.py sdist for creating the archive
This distribution contains a Python client implementation and AMQP conformance tests for Apache Qpid.
You can read more about Qpid here:
Documentation can be found here:
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 directory contains sample programs. See examples/README.txt for more information.
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 brokers that speak the specified AMQP 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 command-line help 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