You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by ac...@apache.org on 2015/07/10 00:12:28 UTC
[48/50] qpid-proton git commit: NO-JIRA: update developer
documentation regarding Python support
NO-JIRA: update developer documentation regarding Python support
Project: http://git-wip-us.apache.org/repos/asf/qpid-proton/repo
Commit: http://git-wip-us.apache.org/repos/asf/qpid-proton/commit/246007f4
Tree: http://git-wip-us.apache.org/repos/asf/qpid-proton/tree/246007f4
Diff: http://git-wip-us.apache.org/repos/asf/qpid-proton/diff/246007f4
Branch: refs/heads/cjansen-cpp-client
Commit: 246007f488950b0ccbd734eadd194c690bd8a049
Parents: 2b41931
Author: Ken Giusti <kg...@apache.org>
Authored: Thu Jul 9 10:13:52 2015 -0400
Committer: Ken Giusti <kg...@apache.org>
Committed: Thu Jul 9 10:14:31 2015 -0400
----------------------------------------------------------------------
DEVELOPERS.md | 26 ++++++++++++++++++++++++++
1 file changed, 26 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/qpid-proton/blob/246007f4/DEVELOPERS.md
----------------------------------------------------------------------
diff --git a/DEVELOPERS.md b/DEVELOPERS.md
index d455ff5..3442671 100644
--- a/DEVELOPERS.md
+++ b/DEVELOPERS.md
@@ -42,11 +42,37 @@ module. Instead, you get the `cproton.py` that resides in the Java source tree
under `proton-j/src/main/resources`. This `cproton.py` and its dependent files
serve as a shim that adapts between the Java API and the C API.
+
### Running tests
To test Proton you should use the CMake build. By default this will invoke the
maven tests as well, so the maven prerequisites will additionally be required.
+By default the unit tests are run using the system's default Python
+interpreter. However, Proton's Python language bindings support both
+versions of the python language (Python 2.x and Python 3.x). These
+bindings should be tested using both versions of the Python
+interpreter. CMake makes this possible by automatically running the
+python unit tests under all versions of python installed on the
+system.
+
+Developers can ensure that Proton remains compatible with both
+versions of Python by installing the following prerequisites:
+
+_Note: currently CMake only supports multi-Python testing in **Linux**
+based environments. Non-Linux developers may skip the following two
+steps._
+
+1. Installing both Python2.x and Python3.x and their associated
+development environments on your system. Most modern Linux
+distributions support installing Python 2.x and Python 3.x in
+parallel.
+
+2. Install the **tox** Python testing tool, (e.g. for Fedora):
+
+ $ yum install python-tox
+
+
To run the tests, cd into your build directory and use the following commands:
# to run all the tests, summary mode
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org