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