Apache Qpid Python

Clone this repo:

Branches

  1. 4c57d9f Merge PR for readme update. This closes #1. by Robert Gemmell · 11 months ago master
  2. e2ee8fd QPID-7207: further trivial update, remove stale description and link to site. Testing GitHub integration. by Robert Gemmell · 11 months ago
  3. df06774 QPID-7207: trivial fixup, mainly testing out the JIRA integration following move to git by Robert Gemmell · 11 months ago
  4. 90e6859 QPID-7258: [Python Client for AMQP 0-8...0-9-1] Remove superfluous import (review comment from @kwall) by Lorenz Quack · 1 year, 1 month ago
  5. afb6c03 QPID-7259: delay adding transfers to completed set until we have verified queue is empty by Gordon Sim · 1 year, 1 month ago

Qpid Python

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

Getting started

  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!
    

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. 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 usage for for additional options:

$ ./qpid-python-test -h

Installation

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