README.txt

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