https://github.com/apache/qpid-python
Mirror of Apache Qpid Python
https://github.com/apache/qpid-python
amqp amqps apache messaging python qpid
Last synced: 5 months ago
JSON representation
Mirror of Apache Qpid Python
- Host: GitHub
- URL: https://github.com/apache/qpid-python
- Owner: apache
- License: apache-2.0
- Created: 2016-07-06T07:00:07.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2023-09-30T09:44:39.000Z (about 2 years ago)
- Last Synced: 2025-07-22T15:54:39.063Z (5 months ago)
- Topics: amqp, amqps, apache, messaging, python, qpid
- Language: Python
- Homepage: https://qpid.apache.org/components/messaging-api/
- Size: 1.4 MB
- Stars: 14
- Watchers: 14
- Forks: 17
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Qpid Python
This distribution contains a Python 2 AMQP 0-x client implementation and AMQP
conformance tests for [Apache Qpid](https://qpid.apache.org/).
Documentation can be found here:
>
**NOTE**: For Python 3 and AMQP 1.0 support, look instead to [Qpid Proton](http://qpid.apache.org/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 conformance 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