ENH: The setup.py script to install python modules is now automatically...

ENH: The setup.py script to install python modules is now automatically executed as part of the CMake-generated install target.  Extra arguments for things like the install prefix can be set by changing VTK_PYTHON_SETUP_ARGS.

Wrapping/Python/CMakeLists.txt

@@ -287,6 +287,36 @@ IF(PYTHON_EXECUTABLE)
   ADD_DEPENDENCIES(vtkpython_pyc 
       vtkpython
       ${vtkpython_pyc_depends})
+
+  # Add a rule to use python distutils to install the python wrappers.
+  IF(NOT VTK_INSTALL_NO_PYTHON)
+    SET(DOLLAR "$")
+
+    # Create default python setup arguments if they are not set.
+    IF(DEFINED VTK_PYTHON_SETUP_ARGS)
+    ELSE(DEFINED VTK_PYTHON_SETUP_ARGS)
+      SET(VTK_PYTHON_SETUP_ARGS "--prefix=\"${DOLLAR}{CMAKE_INSTALL_PREFIX}\""
+        CACHE STRING "Arguments passed to \"python setup.py install ...\" during installation.")
+      MARK_AS_ADVANCED(VTK_PYTHON_SETUP_ARGS)
+    ENDIF(DEFINED VTK_PYTHON_SETUP_ARGS)
+
+    # If there are multiple configurations then add a BUILD_TYPE=...
+    # argument to the python setup.py call.  The build type to use is set
+    # in the CMake variable BUILD_TYPE while running the install script.
+    IF(CMAKE_CONFIGURATION_TYPES)
+      SET(VTK_PYTHON_SETUP_BUILD_TYPE "BUILD_TYPE=${DOLLAR}{BUILD_TYPE}")
+    ELSE(CMAKE_CONFIGURATION_TYPES)
+      SET(VTK_PYTHON_SETUP_BUILD_TYPE)
+    ENDIF(CMAKE_CONFIGURATION_TYPES)
+
+    # Configure the post-install script to run python on setup.py.
+    CONFIGURE_FILE(${VTK_SOURCE_DIR}/Wrapping/Python/PythonInstall.cmake.in
+                   ${VTK_BINARY_DIR}/Wrapping/Python/PythonInstall.cmake
+                   @ONLY IMMEDIATE)
+    SET_TARGET_PROPERTIES(vtkpython_pyc PROPERTIES POST_INSTALL_SCRIPT
+      ${VTK_BINARY_DIR}/Wrapping/Python/PythonInstall.cmake
+      )
+  ENDIF(NOT VTK_INSTALL_NO_PYTHON)
 ENDIF(PYTHON_EXECUTABLE)
 
 # Create the setup.py file.

Wrapping/Python/PythonInstall.cmake.in

+# Configured file and directory locations.
+SET(PYTHON_EXECUTABLE "@PYTHON_EXECUTABLE@")
+SET(CMAKE_INSTALL_PREFIX "@CMAKE_INSTALL_PREFIX@")
+SET(VTK_BINARY_DIR "@VTK_BINARY_DIR@")
+
+# Convert the prefix to a windows path if necessary.  The python
+# distutils implementation seems sensitive to the slash direction.
+IF(WIN32)
+  IF(NOT CYGWIN)
+    STRING(REGEX REPLACE "/" "\\\\" CMAKE_INSTALL_PREFIX
+      "${CMAKE_INSTALL_PREFIX}")
+  ENDIF(NOT CYGWIN)
+ENDIF(WIN32)
+
+# Run python on setup.py to install the python modules.
+EXEC_PROGRAM("${PYTHON_EXECUTABLE}" "${VTK_BINARY_DIR}/Wrapping/Python" ARGS
+  "setup.py" "install" @VTK_PYTHON_SETUP_BUILD_TYPE@ @VTK_PYTHON_SETUP_ARGS@
+  )