deb-python-pyngus/tests

Unit Tests

The unit test are run using the tox command from the tox automation project for more detail. It is assumed tox is available on your system.

To run the tests:

1. The Proton Python binding must be installed [1]
2. From the topmost directory (that contains the tox.ini file) execute the tox command
3. That's it!

The unit tests may be run without tox, but your environment must be set up so that the pyngus module is able to be imported by the test scripts. For example, setting the PYTHONPATH environment variable to include the path to the build directory.

[1] You can still run the tests without installing Proton. You can run the tests using a build of the Proton sources instead. In order to do this you MUST source the config.sh file supplied in the Proton sources prior to running the unit tests. This script adds the Proton Python bindings to the search path used by the unit tests.

Performance Test

perf-test.py is a static performance test. It simulates sending many small messages over many links. It can be used to gauge the performance impact of code changes during development.

Example:

$ ./tests/perf-test.py Total: 200000 messages; credit window: 10; proton (0, 13, 1) 6434 Messages/second; Latency avg: 24.581ms min: 10.419ms max: 45.249ms

Historical Results

Lenovo W541

v2.1.3: Python 2.7.11 Total: 200000 messages; credit window: 10; proton (0, 15, 0) 7964 Messages/second; Latency avg: 19.609ms min: 9.463ms max: 28.257ms

v2.1.1 Python 2.7.11 Total: 200000 messages; credit window: 10; proton (0, 13, 1) 6434 Messages/second; Latency avg: 24.581ms min: 10.419ms max: 45.249ms