qpid-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From acon...@apache.org
Subject [29/50] [abbrv] qpid-proton git commit: NO-JIRA: update developer documentation regarding Python support
Date Tue, 08 Sep 2015 16:37:47 GMT
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/proton-go
Commit: 246007f488950b0ccbd734eadd194c690bd8a049
Parents: 2b41931
Author: Ken Giusti <kgiusti@apache.org>
Authored: Thu Jul 9 10:13:52 2015 -0400
Committer: Ken Giusti <kgiusti@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


Mime
View raw message