remove Py_GetProgramName

Author: picnixz

Doc/c-api/init.rst

@@ -79,8 +79,7 @@ The following functions can be safely called before Python is initialized:
    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:`Py_GetProgramName`, :c:func:`PyEval_InitThreads`, and
+   :c:func:`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:`PyEval_InitThreads`, and
    :c:func:`Py_RunMain`.
 
 
@@ -609,23 +608,6 @@ Process-wide parameters
    .. deprecated-removed:: 3.11 3.15
 
 
-.. c:function:: wchar_t* Py_GetProgramName()
-
-   Return the program name set with :c:member:`PyConfig.program_name`, or the default.
-   The returned string points into static storage; the caller should not modify its
-   value.
-
-   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("executable") <PyConfig_Get>`
-      (:data:`sys.executable`) instead.
-
-
 .. c:function:: wchar_t* Py_GetPrefix()
 
    Return the *prefix* for installed platform-independent files. This is derived

Doc/data/refcounts.dat

@@ -3017,8 +3017,6 @@ Py_GetPrefix:wchar_t*:::
 
 Py_GetProgramFullPath:wchar_t*:::
 
-Py_GetProgramName:wchar_t*:::
-
 Py_GetVersion:const char*:::
 
 Py_INCREF:void:::

Doc/data/stable_abi.dat

@@ -39,9 +39,6 @@ Pending removal in Python 3.15
   * :c:func:`Py_GetProgramFullPath`:
     Use :c:func:`PyConfig_Get("executable") <PyConfig_Get>`
     (:data:`sys.executable`) instead.
-  * :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/deprecations/c-api-pending-removal-in-3.15.rst

@@ -2178,7 +2178,7 @@ Porting to Python 3.10
 
 * :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_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`.
   (Contributed by Victor Stinner in :issue:`42260`.)

Doc/whatsnew/3.10.rst

@@ -2485,7 +2485,7 @@ Deprecated C APIs
     Get :data:`sys.prefix` instead.
   * :c:func:`Py_GetProgramFullPath`:
     Get :data:`sys.executable` instead.
-  * :c:func:`Py_GetProgramName`:
+  * :c:func:`!Py_GetProgramName`:
     Get :data:`sys.executable` instead.
   * :c:func:`Py_GetPythonHome`:
     Get :c:member:`PyConfig.home`

Doc/whatsnew/3.13.rst

@@ -155,3 +155,7 @@ Deprecated C APIs
 Removed C APIs
 --------------
 
+* :c:func:`!Py_GetProgramName`:
+  use :c:func:`PyConfig_Get("executable") <PyConfig_Get>`
+  (:data:`sys.executable`) instead.
+

Doc/whatsnew/3.15.rst

@@ -1630,7 +1630,7 @@ Build and C API Changes
 
 * :c:func:`!Py_SetPath` now sets :data:`sys.executable` to the program full
   path (:c:func:`Py_GetProgramFullPath`) rather than to the program name
-  (:c:func:`Py_GetProgramName`).
+  (:c:func:`!Py_GetProgramName`).
   (Contributed by Victor Stinner in :issue:`38234`.)
 
 

Doc/whatsnew/3.8.rst

@@ -35,7 +35,6 @@ PyAPI_FUNC(int) Py_BytesMain(int argc, char **argv);
 
 /* In pathconfig.c */
 Py_DEPRECATED(3.11) PyAPI_FUNC(void) Py_SetProgramName(const wchar_t *);
-Py_DEPRECATED(3.13) PyAPI_FUNC(wchar_t *) Py_GetProgramName(void);
 
 Py_DEPRECATED(3.11) PyAPI_FUNC(void) Py_SetPythonHome(const wchar_t *);
 Py_DEPRECATED(3.13) PyAPI_FUNC(wchar_t *) Py_GetPythonHome(void);

Include/pylifecycle.h

@@ -1712,7 +1712,6 @@ def test_global_pathconfig(self):
         # - Py_GetPath()
         # - Py_GetPrefix()
         # - Py_GetProgramFullPath()
-        # - Py_GetProgramName()
         # - Py_GetPythonHome()
         #
         # The global path configuration (_Py_path_config) must be a copy
@@ -1728,7 +1727,6 @@ def get_func(name):
         Py_GetPath = get_func('Py_GetPath')
         Py_GetPrefix = get_func('Py_GetPrefix')
         Py_GetExecPrefix = get_func('Py_GetExecPrefix')
-        Py_GetProgramName = get_func('Py_GetProgramName')
         Py_GetProgramFullPath = get_func('Py_GetProgramFullPath')
         Py_GetPythonHome = get_func('Py_GetPythonHome')
 
@@ -1738,7 +1736,6 @@ def get_func(name):
                          config['module_search_paths'])
         self.assertEqual(Py_GetPrefix(), config['prefix'])
         self.assertEqual(Py_GetExecPrefix(), config['exec_prefix'])
-        self.assertEqual(Py_GetProgramName(), config['program_name'])
         self.assertEqual(Py_GetProgramFullPath(), config['executable'])
         self.assertEqual(Py_GetPythonHome(), config['home'])