remove Py_GetPythonHome

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_GetPythonHome`, :c:func:`PyEval_InitThreads`, and
+   been initialized: :c:func:`Py_EncodeLocale`, :c:func:`PyEval_InitThreads`, and
    :c:func:`Py_RunMain`.
 
 
@@ -772,23 +772,6 @@ Process-wide parameters
    .. deprecated-removed:: 3.11 3.15
 
 
-.. c:function:: wchar_t* Py_GetPythonHome()
-
-   Return the default "home", that is, the value set by
-   :c:member:`PyConfig.home`, or the value of the :envvar:`PYTHONHOME`
-   environment variable if it is set.
-
-   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("home") <PyConfig_Get>` or the
-      :envvar:`PYTHONHOME` environment variable instead.
-
-
 .. _threads:
 
 Thread State and the Global Interpreter Lock

Doc/data/stable_abi.dat

@@ -22,10 +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_GetPythonHome`:
-    Use :c:func:`PyConfig_Get("home") <PyConfig_Get>` or the
-    :envvar:`PYTHONHOME` environment variable instead.
-
   The `pythoncapi-compat project
   <https://github.com/python/pythoncapi-compat/>`__ can be used to get
   :c:func:`PyConfig_Get` on Python 3.13 and older.

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

@@ -2177,7 +2177,7 @@ Porting to Python 3.10
   (Contributed by Victor Stinner in :issue:`42157`.)
 
 * :c:func:`!Py_GetPath`, :c:func:`!Py_GetPrefix`, :c:func:`!Py_GetExecPrefix`,
-  :c:func:`!Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome` and
+  :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
   :ref:`init-config` API to get the :ref:`init-path-config`.

Doc/whatsnew/3.10.rst

@@ -2487,7 +2487,7 @@ Deprecated C APIs
     Get :data:`sys.executable` instead.
   * :c:func:`!Py_GetProgramName`:
     Get :data:`sys.executable` instead.
-  * :c:func:`Py_GetPythonHome`:
+  * :c:func:`!Py_GetPythonHome`:
     Get :c:member:`PyConfig.home`
     or the :envvar:`PYTHONHOME` environment variable instead.
 

Doc/whatsnew/3.13.rst

@@ -176,3 +176,7 @@ Removed C APIs
 * :c:func:`!Py_GetProgramName`:
   use :c:func:`PyConfig_Get("executable") <PyConfig_Get>`
   (:data:`sys.executable`) instead.
+* :c:func:`!Py_GetPythonHome`:
+  use :c:func:`PyConfig_Get("home") <PyConfig_Get>` or the
+  :envvar:`PYTHONHOME` environment variable instead.
+

Doc/whatsnew/3.15.rst

@@ -37,7 +37,6 @@ PyAPI_FUNC(int) Py_BytesMain(int argc, char **argv);
 Py_DEPRECATED(3.11) PyAPI_FUNC(void) Py_SetProgramName(const wchar_t *);
 
 Py_DEPRECATED(3.11) PyAPI_FUNC(void) Py_SetPythonHome(const wchar_t *);
-Py_DEPRECATED(3.13) PyAPI_FUNC(wchar_t *) Py_GetPythonHome(void);
 
 #ifdef MS_WINDOWS
 int _Py_CheckPython3(void);

Include/pylifecycle.h

@@ -1708,8 +1708,6 @@ def test_getpath_abspath_win32(self):
     def test_global_pathconfig(self):
         # Test C API functions getting the path configuration:
         #
-        # - Py_GetPythonHome()
-        #
         # The global path configuration (_Py_path_config) must be a copy
         # of the path configuration of PyInterpreter.config (PyConfig).
         ctypes = import_helper.import_module('ctypes')
@@ -1720,12 +1718,8 @@ def get_func(name):
             func.restype = ctypes.c_wchar_p
             return func
 
-        Py_GetPythonHome = get_func('Py_GetPythonHome')
-
         config = _testinternalcapi.get_configs()['config']
 
-        self.assertEqual(Py_GetPythonHome(), config['home'])
-
     def test_init_warnoptions(self):
         # lowest to highest priority
         warnoptions = [

Lib/test/test_embed.py

@@ -1396,7 +1396,7 @@ but now can get the condition by calling the new private
 .. section: C API
 
 :c:func:`!Py_GetPath`, :c:func:`!Py_GetPrefix`, :c:func:`!Py_GetExecPrefix`,
-:c:func:`!Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome` and
+: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
 :ref:`Python Initialization Configuration API <init-config>` to get the