Mailing-List: contact commits-help@qpid.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@qpid.apache.org
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: aconway@apache.org
To: commits@qpid.apache.org
Date: Tue, 08 Sep 2015 16:37:47 -0000
Message-Id: <1b3c6430598845a8aec4ab5fa7ef6c37@git.apache.org>
In-Reply-To: <4391ed4e15704d9c85eeba9305b98280@git.apache.org>
References: <4391ed4e15704d9c85eeba9305b98280@git.apache.org>
Subject: [29/50] [abbrv] 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/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