remove Py_GetPrefix

Author: picnixz

Doc/c-api/init.rst

@@ -77,7 +77,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_GetPrefix`, :c:func:`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:`PyEval_InitThreads`, and
+   been initialized: :c:func:`Py_EncodeLocale`, :c:func:`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:`PyEval_InitThreads`, and
    :c:func:`Py_RunMain`.
 
 
@@ -602,31 +602,6 @@ Process-wide parameters
    .. deprecated-removed:: 3.11 3.15
 
 
-.. c:function:: wchar_t* Py_GetPrefix()
-
-   Return the *prefix* for installed platform-independent 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 prefix is ``'/usr/local'``. The
-   returned string points into static storage; the caller should not modify its
-   value.  This corresponds to the :makevar:`prefix` variable in the top-level
-   :file:`Makefile` and the :option:`--prefix` argument to the :program:`configure`
-   script at build time.  The value is available to Python code as ``sys.base_prefix``.
-   It is only useful on Unix.  See also the next function.
-
-   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_prefix") <PyConfig_Get>`
-      (: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:function:: wchar_t* Py_GetProgramFullPath()
 
    .. index::

Doc/c-api/intro.rst

@@ -780,16 +780,15 @@ environment variable :envvar:`PYTHONHOME`, or insert additional directories in
 front of the standard path by setting :envvar:`PYTHONPATH`.
 
 .. index::
-   single: Py_GetPrefix (C function)
    single: Py_GetProgramFullPath (C function)
 
 The embedding application can steer the search by setting
 :c:member:`PyConfig.program_name` *before* calling
 :c:func:`Py_InitializeFromConfig`. Note that
 :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_GetPrefix`, and
-:c:func:`Py_GetProgramFullPath` (all defined in :file:`Modules/getpath.c`).
+control has to provide its own implementation of :c:func:`Py_GetProgramFullPath`
+(defined in :file:`Modules/getpath.c`).
 
 .. index:: single: Py_IsInitialized (C function)
 

Doc/data/refcounts.dat

@@ -3009,8 +3009,6 @@ Py_GetCopyright:const char*:::
 
 Py_GetPlatform:const char*:::
 
-Py_GetPrefix:wchar_t*:::
-
 Py_GetProgramFullPath:wchar_t*:::
 
 Py_GetVersion:const char*:::

Doc/data/stable_abi.dat

@@ -22,11 +22,6 @@ Pending removal in Python 3.15
   may return a type other than :class:`bytes`, such as :class:`str`.
 * Python initialization functions, deprecated in Python 3.13:
 
-  * :c:func:`Py_GetPrefix`:
-    Use :c:func:`PyConfig_Get("base_prefix") <PyConfig_Get>`
-    (: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_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

@@ -2481,7 +2481,7 @@ Deprecated C APIs
     Get :data:`sys.exec_prefix` instead.
   * :c:func:`!Py_GetPath`:
     Get :data:`sys.path` instead.
-  * :c:func:`Py_GetPrefix`:
+  * :c:func:`!Py_GetPrefix`:
     Get :data:`sys.prefix` instead.
   * :c:func:`Py_GetProgramFullPath`:
     Get :data:`sys.executable` instead.

Doc/whatsnew/3.13.rst

@@ -164,6 +164,12 @@ Removed C APIs
 * :c:func:`!Py_GetPath`:
   use :c:func:`PyConfig_Get("module_search_paths") <PyConfig_Get>`
   (:data:`sys.path`) instead.
+* :c:func:`!Py_GetPrefix`:
+   use :c:func:`PyConfig_Get("base_prefix") <PyConfig_Get>`
+   (: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_GetProgramName`:
   use :c:func:`PyConfig_Get("executable") <PyConfig_Get>`
   (:data:`sys.executable`) instead.

Doc/whatsnew/3.15.rst

@@ -40,7 +40,6 @@ Py_DEPRECATED(3.11) PyAPI_FUNC(void) Py_SetPythonHome(const wchar_t *);
 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);
 #ifdef MS_WINDOWS
 int _Py_CheckPython3(void);
 #endif

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_GetPrefix()
         # - Py_GetProgramFullPath()
         # - Py_GetPythonHome()
         #
@@ -1722,13 +1721,11 @@ def get_func(name):
             func.restype = ctypes.c_wchar_p
             return func
 
-        Py_GetPrefix = get_func('Py_GetPrefix')
         Py_GetProgramFullPath = get_func('Py_GetProgramFullPath')
         Py_GetPythonHome = get_func('Py_GetPythonHome')
 
         config = _testinternalcapi.get_configs()['config']
 
-        self.assertEqual(Py_GetPrefix(), config['prefix'])
         self.assertEqual(Py_GetProgramFullPath(), config['executable'])
         self.assertEqual(Py_GetPythonHome(), config['home'])