Python bindings: use 'pip install' instead of 'python setup.py install'

Fixes #9965

Co-authored-by: Bas Couwenberg <sebastic@xs4all.nl>

Author: rouault

doc/source/development/building_from_source.rst

@@ -2453,12 +2453,6 @@ the ``install`` CMake target.
     ``deb`` when it is detected that the Python installation looks for
     the ``site-packages`` subdirectory. Otherwise it is unspecified.
 
-.. option:: GDAL_PYTHON_INSTALL_LIB
-
-    This option can be specified to set the value of the ``--install-lib``
-    option of ``python3 setup.py install``. It is only taken into account on
-    MacOS systems, when the Python installation is a framework.
-
 .. note::
 
     The Python bindings are made of several modules (osgeo.gdal, osgeo.ogr, etc.)
@@ -2535,7 +2529,7 @@ For more details on how to build and use the C# bindings read the dedicated sect
 
 .. option:: CSHARP_APPLICATION_VERSION
 
-    Sets the .NET target Framework (in TFM format) to be used when compiling the C# sample applications. `List of acceptable contents for .NET <https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-frameworks>`_. 
+    Sets the .NET target Framework (in TFM format) to be used when compiling the C# sample applications. `List of acceptable contents for .NET <https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-frameworks>`_.
     Defaults to the highest version installed on the build system, i.e. `latest`.
 
 .. option:: GDAL_CSHARP_ONLY=OFF/ON

swig/python/CMakeLists.txt

@@ -448,7 +448,6 @@ if __name__ == '__main__':
     OUTPUT_VARIABLE SITE_PACKAGE_DIR
     OUTPUT_STRIP_TRAILING_WHITESPACE)
 
-  set(INSTALL_ARGS "--single-version-externally-managed --record=record.txt")
   set(CAN_USE_CMAKE_INSTALL_PREFIX_FROM_CMAKE_INSTALL FALSE)
   set(IGNORE_CMAKE_INSTALL_PREFIX_CONFIGURE_TIME_DIFFERENT_FROM_RUNTIME FALSE)
   if (DEFINED GDAL_PYTHON_INSTALL_PREFIX)
@@ -473,8 +472,6 @@ if __name__ == '__main__':
         OUTPUT_STRIP_TRAILING_WHITESPACE)
       if ("${STD_UNIX_LAYOUT}" STREQUAL "TRUE")
         set(CAN_USE_CMAKE_INSTALL_PREFIX_FROM_CMAKE_INSTALL TRUE)
-      elseif (DEFINED GDAL_PYTHON_INSTALL_LIB)
-        set(INSTALL_ARGS "${INSTALL_ARGS} \"--install-lib=${GDAL_PYTHON_INSTALL_LIB}\"")
       endif ()
     else ()
       set(CAN_USE_CMAKE_INSTALL_PREFIX_FROM_CMAKE_INSTALL TRUE)
@@ -484,32 +481,8 @@ if __name__ == '__main__':
   # setuptools 60.0 defaults to SETUPTOOLS_USE_DISTUTILS=local, and thus Debian's specific --install-layout distutils
   # option cannot be used
   if (DEFINED GDAL_PYTHON_INSTALL_LAYOUT)
-    set(INSTALL_ARGS "${INSTALL_ARGS} --install-layout=${GDAL_PYTHON_INSTALL_LAYOUT}")
     set(SETUPTOOLS_USE_DISTUTILS stdlib)
   elseif ("${SITE_PACKAGE_DIR}" MATCHES "dist-packages")
-
-    # We are running on Debian, but test if our setuptools version supports
-    # Debian --install-layout
-    # This might not be the case if using a regular (non-Debian patched) Python
-    # installation or setuptools (cf https://github.com/OSGeo/gdal/issues/11636)
-    execute_process(
-        COMMAND env GDAL_PYTHON_CHECK_SOURCE_FILES=no GDAL_PYTHON_BINDINGS_WITHOUT_NUMPY=yes ${Python_EXECUTABLE_CMAKE} setup.py install --help
-        OUTPUT_VARIABLE SETUP_INSTALL_HELP
-        OUTPUT_STRIP_TRAILING_WHITESPACE
-        WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
-    )
-    # If so, uses it.
-    if ("${SETUP_INSTALL_HELP}" MATCHES "install-layout")
-        set(INSTALL_ARGS "${INSTALL_ARGS} --install-layout=deb")
-    endif()
-
-    if (NOT DEFINED GDAL_PYTHON_INSTALL_LIB AND "${PREFIX_FOR_TRIMMEDSYSCONFIG}" STREQUAL "/usr/local")
-        # Scenario of https://github.com/OSGeo/gdal/issues/10242
-        # For some reason patched setuptools of Debian fails to install by default
-        # in /usr/local/lib/python{version}/dist-packages even when passing
-        # --prefix=/usr/local and --install-layout=deb
-        set(INSTALL_ARGS "${INSTALL_ARGS} \"--install-lib=${SITE_PACKAGE_DIR}\"")
-    endif()
     if(Python_VERSION VERSION_LESS 3.12)
         # It no longer seems needed to mess with SETUPTOOLS_USE_DISTUTILS
         # with Debian Python 3.12 (or maybe its setuptools 68.1.2 version...),

swig/python/install_python.cmake.in

@@ -23,10 +23,10 @@ else()
    set(PATH_SEP ":")
 endif()
 if(DEFINED INSTALL_PREFIX)
-   execute_process(COMMAND ${CMAKE_COMMAND} -E env "PATH=@PROJECT_BINARY_DIR@/apps${PATH_SEP}$ENV{PATH}" "@Python_EXECUTABLE_CMAKE@" "@SETUP_PY_FILENAME@" install ${ROOT_DIR_ARG} @INSTALL_ARGS@ "${INSTALL_PREFIX}"
+   execute_process(COMMAND ${CMAKE_COMMAND} -E env "PATH=@PROJECT_BINARY_DIR@/apps${PATH_SEP}$ENV{PATH}" "@Python_EXECUTABLE_CMAKE@" -m pip install --no-build-isolation ${ROOT_DIR_ARG} @INSTALL_ARGS@ "${INSTALL_PREFIX}" .
                    WORKING_DIRECTORY "@CMAKE_CURRENT_BINARY_DIR@" RESULT_VARIABLE res)
 else()
-   execute_process(COMMAND ${CMAKE_COMMAND} -E env "PATH=@PROJECT_BINARY_DIR@/apps${PATH_SEP}$ENV{PATH}" "@Python_EXECUTABLE_CMAKE@" "@SETUP_PY_FILENAME@" install ${ROOT_DIR_ARG} @INSTALL_ARGS@
+   execute_process(COMMAND ${CMAKE_COMMAND} -E env "PATH=@PROJECT_BINARY_DIR@/apps${PATH_SEP}$ENV{PATH}" "@Python_EXECUTABLE_CMAKE@" -m pip install --no-build-isolation ${ROOT_DIR_ARG} @INSTALL_ARGS@ .
                    WORKING_DIRECTORY "@CMAKE_CURRENT_BINARY_DIR@" RESULT_VARIABLE res)
 endif()
 if(NOT res EQUAL 0)