1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
# 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` 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
|
