summaryrefslogtreecommitdiff
path: root/python/README.txt
blob: 772271cffe3e81996906ca7fc5e1414bf5283ac1 (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
= 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.

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