Apache Qpid Python

Clone this repo:
  1. 8800358 NO-JIRA: add .asf.yaml file with github repo metadata by Robbie Gemmell · 3 weeks ago master
  2. 959e782 update readme, add note for folks looking for Python 3 and/or AMQP 1.0 support to use Proton by Robbie Gemmell · 3 weeks ago
  3. 5f37bd6 NO-JIRA: update year in NOTICE file by Robbie Gemmell · 9 months ago
  4. aeca885 NO-JIRA: trivial readme change, testing out repo and github mirror following git-wip-us to gitbox migration by Robbie Gemmell · 10 months ago
  5. df68238 QPID-8170: Add build and install stages by Justin Ross · 1 year, 6 months ago

Qpid Python

This distribution contains a Python 2 AMQP 0-x client implementation and AMQP conformance tests for Apache Qpid.

Documentation can be found here:

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

NOTE: For Python 3 and AMQP 1.0 support, look instead to Qpid Proton.

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 directory contains sample programs. See examples/README.txt for more information.

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

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