remove Py_GetExecPrefix

Author: picnixz

Doc/c-api/init.rst

@@ -78,8 +78,7 @@ The following functions can be safely called before Python is initialized:
    Despite their apparent similarity to some of the functions listed above,
    the following functions **should not be called** before the interpreter has
    been initialized: :c:func:`Py_EncodeLocale`, :c:func:`Py_GetPath`,
-   :c:func:`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`,
-   :c:func:`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:`PyEval_InitThreads`, and
+   :c:func:`Py_GetPrefix`, :c:func:`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:`PyEval_InitThreads`, and
    :c:func:`Py_RunMain`.
 
 
@@ -633,54 +632,6 @@ Process-wide parameters
       <venv-def>` need to be handled.
 
 
-.. c:function:: wchar_t* Py_GetExecPrefix()
-
-   Return the *exec-prefix* for installed platform-*dependent* files.  This is
-   derived through a number of complicated rules from the program name set with
-   :c:member:`PyConfig.program_name` and some environment variables; for example, if the
-   program name is ``'/usr/local/bin/python'``, the exec-prefix is
-   ``'/usr/local'``.  The returned string points into static storage; the caller
-   should not modify its value.  This corresponds to the :makevar:`exec_prefix`
-   variable in the top-level :file:`Makefile` and the ``--exec-prefix``
-   argument to the :program:`configure` script at build  time.  The value is
-   available to Python code as ``sys.base_exec_prefix``.  It is only useful on
-   Unix.
-
-   Background: The exec-prefix differs from the prefix when platform dependent
-   files (such as executables and shared libraries) are installed in a different
-   directory tree.  In a typical installation, platform dependent files may be
-   installed in the :file:`/usr/local/plat` subtree while platform independent may
-   be installed in :file:`/usr/local`.
-
-   Generally speaking, a platform is a combination of hardware and software
-   families, e.g.  Sparc machines running the Solaris 2.x operating system are
-   considered the same platform, but Intel machines running Solaris 2.x are another
-   platform, and Intel machines running Linux are yet another platform.  Different
-   major revisions of the same operating system generally also form different
-   platforms.  Non-Unix operating systems are a different story; the installation
-   strategies on those systems are so different that the prefix and exec-prefix are
-   meaningless, and set to the empty string. Note that compiled Python bytecode
-   files are platform independent (but not independent from the Python version by
-   which they were compiled!).
-
-   System administrators will know how to configure the :program:`mount` or
-   :program:`automount` programs to share :file:`/usr/local` between platforms
-   while having :file:`/usr/local/plat` be a different filesystem for each
-   platform.
-
-   This function should not be called before :c:func:`Py_Initialize`, otherwise
-   it returns ``NULL``.
-
-   .. versionchanged:: 3.10
-      It now returns ``NULL`` if called before :c:func:`Py_Initialize`.
-
-   .. deprecated-removed:: 3.13 3.15
-      Use :c:func:`PyConfig_Get("base_exec_prefix") <PyConfig_Get>`
-      (:data:`sys.base_exec_prefix`) instead. Use
-      :c:func:`PyConfig_Get("exec_prefix") <PyConfig_Get>`
-      (:data:`sys.exec_prefix`) if :ref:`virtual environments <venv-def>` need
-      to be handled.
-
 .. c:function:: wchar_t* Py_GetProgramFullPath()
 
    .. index::

Doc/c-api/intro.rst

@@ -782,7 +782,6 @@ front of the standard path by setting :envvar:`PYTHONPATH`.
 .. index::
    single: Py_GetPath (C function)
    single: Py_GetPrefix (C function)
-   single: Py_GetExecPrefix (C function)
    single: Py_GetProgramFullPath (C function)
 
 The embedding application can steer the search by setting
@@ -791,7 +790,7 @@ The embedding application can steer the search by setting
 :envvar:`PYTHONHOME` still overrides this and :envvar:`PYTHONPATH` is still
 inserted in front of the standard path.  An application that requires total
 control has to provide its own implementation of :c:func:`Py_GetPath`,
-:c:func:`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, and
+:c:func:`Py_GetPrefix`, and
 :c:func:`Py_GetProgramFullPath` (all defined in :file:`Modules/getpath.c`).
 
 .. index:: single: Py_IsInitialized (C function)

Doc/data/refcounts.dat

@@ -3007,8 +3007,6 @@ Py_GetCompiler:const char*:::
 
 Py_GetCopyright:const char*:::
 
-Py_GetExecPrefix:wchar_t*:::
-
 Py_GetPath:wchar_t*:::
 
 Py_GetPlatform:const char*:::

Doc/data/stable_abi.dat

@@ -30,12 +30,6 @@ Pending removal in Python 3.15
     (:data:`sys.base_prefix`) instead. Use :c:func:`PyConfig_Get("prefix")
     <PyConfig_Get>` (:data:`sys.prefix`) if :ref:`virtual environments
     <venv-def>` need to be handled.
-  * :c:func:`Py_GetExecPrefix`:
-    Use :c:func:`PyConfig_Get("base_exec_prefix") <PyConfig_Get>`
-    (:data:`sys.base_exec_prefix`) instead. Use
-    :c:func:`PyConfig_Get("exec_prefix") <PyConfig_Get>`
-    (:data:`sys.exec_prefix`) if :ref:`virtual environments <venv-def>` need to
-    be handled.
   * :c:func:`Py_GetProgramFullPath`:
     Use :c:func:`PyConfig_Get("executable") <PyConfig_Get>`
     (:data:`sys.executable`) instead.

Doc/deprecations/c-api-pending-removal-in-3.15.rst

@@ -2176,7 +2176,7 @@ Porting to Python 3.10
   ``unicodedata.ucnhash_CAPI`` has been moved to the internal C API.
   (Contributed by Victor Stinner in :issue:`42157`.)
 
-* :c:func:`Py_GetPath`, :c:func:`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`,
+* :c:func:`Py_GetPath`, :c:func:`Py_GetPrefix`, :c:func:`!Py_GetExecPrefix`,
   :c:func:`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome` and
   :c:func:`!Py_GetProgramName` functions now return ``NULL`` if called before
   :c:func:`Py_Initialize` (before Python is initialized). Use the new

Doc/whatsnew/3.10.rst

@@ -2477,7 +2477,7 @@ Deprecated C APIs
 
   * :c:func:`PySys_ResetWarnOptions`:
     Clear :data:`sys.warnoptions` and :data:`!warnings.filters` instead.
-  * :c:func:`Py_GetExecPrefix`:
+  * :c:func:`!Py_GetExecPrefix`:
     Get :data:`sys.exec_prefix` instead.
   * :c:func:`Py_GetPath`:
     Get :data:`sys.path` instead.

Doc/whatsnew/3.13.rst

@@ -155,7 +155,12 @@ Deprecated C APIs
 Removed C APIs
 --------------
 
+* :c:func:`!Py_GetExecPrefix`:
+  use :c:func:`PyConfig_Get("base_exec_prefix") <PyConfig_Get>`
+  (:data:`sys.base_exec_prefix`) instead.
+  Use :c:func:`PyConfig_Get("exec_prefix") <PyConfig_Get>`
+  (:data:`sys.exec_prefix`) if :ref:`virtual environments <venv-def>`
+  need to be handled.
 * :c:func:`!Py_GetProgramName`:
   use :c:func:`PyConfig_Get("executable") <PyConfig_Get>`
   (:data:`sys.executable`) instead.
-

Doc/whatsnew/3.15.rst

@@ -41,7 +41,6 @@ Py_DEPRECATED(3.13) PyAPI_FUNC(wchar_t *) Py_GetPythonHome(void);
 
 Py_DEPRECATED(3.13) PyAPI_FUNC(wchar_t *) Py_GetProgramFullPath(void);
 Py_DEPRECATED(3.13) PyAPI_FUNC(wchar_t *) Py_GetPrefix(void);
-Py_DEPRECATED(3.13) PyAPI_FUNC(wchar_t *) Py_GetExecPrefix(void);
 Py_DEPRECATED(3.13) PyAPI_FUNC(wchar_t *) Py_GetPath(void);
 #ifdef MS_WINDOWS
 int _Py_CheckPython3(void);

Include/pylifecycle.h

@@ -1708,7 +1708,6 @@ def test_getpath_abspath_win32(self):
     def test_global_pathconfig(self):
         # Test C API functions getting the path configuration:
         #
-        # - Py_GetExecPrefix()
         # - Py_GetPath()
         # - Py_GetPrefix()
         # - Py_GetProgramFullPath()
@@ -1726,7 +1725,6 @@ def get_func(name):
 
         Py_GetPath = get_func('Py_GetPath')
         Py_GetPrefix = get_func('Py_GetPrefix')
-        Py_GetExecPrefix = get_func('Py_GetExecPrefix')
         Py_GetProgramFullPath = get_func('Py_GetProgramFullPath')
         Py_GetPythonHome = get_func('Py_GetPythonHome')
 
@@ -1735,7 +1733,6 @@ def get_func(name):
         self.assertEqual(tuple(Py_GetPath().split(os.path.pathsep)),
                          config['module_search_paths'])
         self.assertEqual(Py_GetPrefix(), config['prefix'])
-        self.assertEqual(Py_GetExecPrefix(), config['exec_prefix'])
         self.assertEqual(Py_GetProgramFullPath(), config['executable'])
         self.assertEqual(Py_GetPythonHome(), config['home'])