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

1. 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
   

2. Make sure a broker is running.

3. 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:

1. Run a broker on the default port.

2. 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:

1. Run a broker on the default port.

2. 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