Merge pull request #10 from SimpleITK/ensure-wheels-are-available-on-the-host

BUG: manylinux: Ensure generated wheels are available on the host

Author: jcfr

README.md

@@ -2,23 +2,68 @@
 
 This project provides a `setup.py` script that build SimpleITK Python wheel. [SimpleITK](http://www.simpleitk.org) is a simplified programming layer on top of the [Insight Segmentation and Registration Toolkit](https://itk.org) (ITK).  ITK is an open-source, cross-platform system that provides developers with an extensive suite of software tools for image analysis.
 
-## Building the SimpleITK Python wheel module
+## Automated wheels building with scripts
 
-Building the wheel requires:
+Steps required to build wheels on Linux, MacOSX and Windows have been automated. The
+following sections outline how to use the associated scripts.
+
+### Linux
+
+On any linux distribution with `docker` and `bash` installed, running the script
+`dockcross-manylinux-build-wheels.sh` will create 32 and 64-bit wheels for both
+python 2.x and python 3.x in the `dist` directory.
+
+For example:
+
+```bash
+$ git clone git://github.com/SimpleITK/SimpleITKPythonPackage.git
+[...]
+
+$ ./scripts/dockcross-manylinux-build-wheels.sh
+[...]
+
+$ ls -1 dist/
+SimpleITK-0.11.0-cp27-cp27m-manylinux1_i686.whl
+SimpleITK-0.11.0-cp27-cp27m-manylinux1_x86_64.whl
+SimpleITK-0.11.0-cp27-cp27mu-manylinux1_i686.whl
+SimpleITK-0.11.0-cp27-cp27mu-manylinux1_x86_64.whl
+SimpleITK-0.11.0-cp33-cp33m-manylinux1_i686.whl
+SimpleITK-0.11.0-cp33-cp33m-manylinux1_x86_64.whl
+SimpleITK-0.11.0-cp34-cp34m-manylinux1_i686.whl
+SimpleITK-0.11.0-cp34-cp34m-manylinux1_x86_64.whl
+SimpleITK-0.11.0-cp35-cp35m-manylinux1_i686.whl
+SimpleITK-0.11.0-cp35-cp35m-manylinux1_x86_64.whl
+```
+
+### MacOSX
+
+*To be documented*
+
+### Windows
+
+*To be documented*
+
+## Prerequisites
+
+Building wheels requires:
 * [CMake](https://cmake.org)
 * Git
-* C++ Compiler
+* C++ Compiler - Platform specific requirements are summarized in [scikit-build documentation](http://scikit-build.readthedocs.io).
 * Python
 
+## Detailed build instructions
+
+### Building SimpleITK Python wheels
+
 Build the SimpleITK Python wheel with the following command:
 
 ```
 mkvirtualenv build-sitk
-pip install -r requirements.txt
+pip install -r requirements-dev.txt
 python setup.py bdist_wheel
 ```
 
-## Efficiently building wheels for different version of python
+### Efficiently building wheels for different version of python
 
 If on a given platform you would like to build wheels for different version of python, you can build the SimpleITK core libraries first and reuse them when building each wheel.
 
@@ -35,7 +80,7 @@ python setup.py bdist_wheel -- \
 ```
 
 ## Miscellaneous
-Written by Jean-Christophe Fillion-Robin from the Kitware Inc.
+Written by Jean-Christophe Fillion-Robin from Kitware Inc.
 
 It is covered by the Apache License, Version 2.0:
 

requirements.txt requirements-dev.txtrequirements.txt renamed to requirements-dev.txt

@@ -12,6 +12,8 @@ script_dir="`cd $(dirname $0); pwd`"
 
 # Build wheels
 pushd $script_dir/..
-/tmp/dockcross-manylinux-x64 ./scripts/internal/manylinux-build-wheels.sh
-/tmp/dockcross-manylinux-x86 ./scripts/internal/manylinux-build-wheels.sh
+mkdir -p dist
+DOCKER_ARGS="-v $(pwd)/dist:/work/dist/"
+/tmp/dockcross-manylinux-x64 -a "$DOCKER_ARGS" ./scripts/internal/manylinux-build-wheels.sh
+/tmp/dockcross-manylinux-x86 -a "$DOCKER_ARGS" ./scripts/internal/manylinux-build-wheels.sh
 popd

scripts/dockcross-manylinux-build-wheels.sh

@@ -54,7 +54,7 @@ for PYBIN in /opt/python/*/bin; do
     echo "PYTHON_INCLUDE_DIR:${PYTHON_INCLUDE_DIR}"
     echo "PYTHON_LIBRARY:${PYTHON_LIBRARY}"
 
-    ${PYBIN}/pip install --user -r /work/requirements-dev.txt
+    ${PYBIN}/pip install -r /work/requirements-dev.txt
     ${PYBIN}/python setup.py bdist_wheel -G Ninja -- \
       -DSimpleITK_DIR:PATH=/work/standalone-${arch}-build/SimpleITK-superbuild/SimpleITK-build \
       -DSimpleITK_SOURCE_DIR:PATH=/work/standalone-${arch}-build/SimpleITK \