qpid-python 0.32

Python client implementation for Apache Qpid

This distribution contains the Python client libraries for Apache Qpid.

Apache Qpid is a high-speed, language independent, platform independent enterprise messaging system. It currently provides two messaging brokers (one implemented in C++, one implemented in Java), and messaging client libraries for Java JMS, C++, C# .NET, Python, Ruby, and WCF. The messaging protocol for Apache Qpid is AMQP (Advanced Message Queuing Protocol). You can read more about Qpid here:

http://qpid.apache.org/

Documentation can be found here:

http://qpid.apache.org/documentation.html

= GETTING STARTED =

1. Make sure the Qpid Python client libraries are on your PYTHONPATH. If you have extracted the archive to the directory INSTALLPATH, the following export will work:

$ export PYTHONPATH=${PYTHONPATH}:${INSTALLPATH}/qpid-0.8/python

2. Make sure a broker is running

3. Run the ‘hello’ example from qpid-0.8/python/examples/api:

$ ./hello Hello world!

= EXAMPLES =

The examples/api directory contains several examples.

Read examples/README.txt for further details on these examples.

= RUNNING THE TESTS =

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:

1. Run a broker on the default port

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