summaryrefslogtreecommitdiff
path: root/qpid/python/README.txt
blob: bae9f6ab0b0fc5ffc9afc614cc3322668b7f65df (plain)
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
= INSTALLATION =

Extract the release archive into a directory of your choice and set
your PYTHONPATH accordingly:

  tar -xzf qpid-python-<version>.tar.gz -C <install-prefix>
  export PYTHONPATH=<install-prefix>/qpid-<version>/python

= GETTING STARTED =

The python client includes a simple hello-world example that publishes
and consumes a message:

  cp <install-prefix>/qpid-<version>/python/hello-world .
  ./hello-world

= EXAMPLES =

More comprehensive examples can be found here:

  cd <install-prefix>/qpid-<version>/python/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.

Simplest way to run the tests:

  1. Run a broker on the default port

  2. ./run-tests -s <version>

Where <version> is one of "0-8", "0-9", or "0-10-errata".

See the run-tests usage for for additional options:

  ./run-tests -h

== Expected failures ==

Certain tests are expected to fail due to incomplete functionality or
unresolved interop issues. To skip expected failures for the C++ or
Java brokers:

  ./run-tests -I <file-name>

Where <file-name> is one of the following files:

  * cpp_failing_0-10.txt
  * cpp_failing_0-9.txt
  * cpp_failing_0-8.txt
  * java_failing_0-9.txt
  * java_failing_0-8.txt