Set by the :option:`-b` option.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_DebugFlag
Set by the :option:`-d` option and the :envvar:`PYTHONDEBUG` environment
variable.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_DontWriteBytecodeFlag
Set by the :option:`-B` option and the :envvar:`PYTHONDONTWRITEBYTECODE`
environment variable.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_FrozenFlag
Private flag used by ``_freeze_module`` and ``frozenmain`` programs.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_HashRandomizationFlag
If the flag is non-zero, read the :envvar:`PYTHONHASHSEED` environment
variable to initialize the secret hash seed.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_IgnoreEnvironmentFlag
Set by the :option:`-E` and :option:`-I` options.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_InspectFlag
Set by the :option:`-i` option and the :envvar:`PYTHONINSPECT` environment
variable.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_InteractiveFlag
Set by the :option:`-i` option.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_IsolatedFlag
.. versionadded:: 3.4
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_LegacyWindowsFSEncodingFlag
.. availability:: Windows.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_LegacyWindowsStdioFlag
.. availability:: Windows.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_NoSiteFlag
Set by the :option:`-S` option.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_NoUserSiteDirectory
Set by the :option:`-s` and :option:`-I` options, and the
:envvar:`PYTHONNOUSERSITE` environment variable.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_OptimizeFlag
Set by the :option:`-O` option and the :envvar:`PYTHONOPTIMIZE` environment
variable.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_QuietFlag
.. versionadded:: 3.2
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_UnbufferedStdioFlag
Set by the :option:`-u` option and the :envvar:`PYTHONUNBUFFERED`
environment variable.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
.. c:var:: int Py_VerboseFlag
Set by the :option:`-v` option and the :envvar:`PYTHONVERBOSE` environment
variable.
- .. deprecated-removed:: 3.12 3.15
+ .. deprecated-removed:: 3.12 3.16
Initializing and finalizing the interpreter
Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a
:c:expr:`wchar_t*` string.
- .. deprecated-removed:: 3.11 3.15
+ .. deprecated-removed:: 3.11 3.16
.. c:function:: const char* Py_GetVersion()
.. versionadded:: 3.1.3
- .. deprecated-removed:: 3.11 3.15
+ .. deprecated-removed:: 3.11 3.16
.. c:function:: void PySys_SetArgv(int argc, wchar_t **argv)
.. versionchanged:: 3.4 The *updatepath* value depends on :option:`-I`.
- .. deprecated-removed:: 3.11 3.15
+ .. deprecated-removed:: 3.11 3.16
.. c:function:: void Py_SetPythonHome(const wchar_t *home)
Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a
:c:expr:`wchar_t*` string.
- .. deprecated-removed:: 3.11 3.15
+ .. deprecated-removed:: 3.11 3.16
whether you selected a "narrow" or "wide" Unicode version of Python at
build time.
- .. deprecated-removed:: 3.13 3.15
+ .. deprecated-removed:: 3.13 3.16
.. c:function:: int PyUnicode_READY(PyObject *unicode)
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.
-
-* Functions to configure Python's initialization, deprecated in Python 3.11:
-
- * :c:func:`!PySys_SetArgvEx()`:
- Set :c:member:`PyConfig.argv` instead.
- * :c:func:`!PySys_SetArgv()`:
- Set :c:member:`PyConfig.argv` instead.
- * :c:func:`!Py_SetProgramName()`:
- Set :c:member:`PyConfig.program_name` instead.
- * :c:func:`!Py_SetPythonHome()`:
- Set :c:member:`PyConfig.home` instead.
- * :c:func:`!PySys_ResetWarnOptions`:
- Clear :data:`sys.warnoptions` and :data:`!warnings.filters` instead.
-
- The :c:func:`Py_InitializeFromConfig` API should be used with
- :c:type:`PyConfig` instead.
-
-* Global configuration variables:
-
- * :c:var:`Py_DebugFlag`:
- Use :c:member:`PyConfig.parser_debug` or
- :c:func:`PyConfig_Get("parser_debug") <PyConfig_Get>` instead.
- * :c:var:`Py_VerboseFlag`:
- Use :c:member:`PyConfig.verbose` or
- :c:func:`PyConfig_Get("verbose") <PyConfig_Get>` instead.
- * :c:var:`Py_QuietFlag`:
- Use :c:member:`PyConfig.quiet` or
- :c:func:`PyConfig_Get("quiet") <PyConfig_Get>` instead.
- * :c:var:`Py_InteractiveFlag`:
- Use :c:member:`PyConfig.interactive` or
- :c:func:`PyConfig_Get("interactive") <PyConfig_Get>` instead.
- * :c:var:`Py_InspectFlag`:
- Use :c:member:`PyConfig.inspect` or
- :c:func:`PyConfig_Get("inspect") <PyConfig_Get>` instead.
- * :c:var:`Py_OptimizeFlag`:
- Use :c:member:`PyConfig.optimization_level` or
- :c:func:`PyConfig_Get("optimization_level") <PyConfig_Get>` instead.
- * :c:var:`Py_NoSiteFlag`:
- Use :c:member:`PyConfig.site_import` or
- :c:func:`PyConfig_Get("site_import") <PyConfig_Get>` instead.
- * :c:var:`Py_BytesWarningFlag`:
- Use :c:member:`PyConfig.bytes_warning` or
- :c:func:`PyConfig_Get("bytes_warning") <PyConfig_Get>` instead.
- * :c:var:`Py_FrozenFlag`:
- Use :c:member:`PyConfig.pathconfig_warnings` or
- :c:func:`PyConfig_Get("pathconfig_warnings") <PyConfig_Get>` instead.
- * :c:var:`Py_IgnoreEnvironmentFlag`:
- Use :c:member:`PyConfig.use_environment` or
- :c:func:`PyConfig_Get("use_environment") <PyConfig_Get>` instead.
- * :c:var:`Py_DontWriteBytecodeFlag`:
- Use :c:member:`PyConfig.write_bytecode` or
- :c:func:`PyConfig_Get("write_bytecode") <PyConfig_Get>` instead.
- * :c:var:`Py_NoUserSiteDirectory`:
- Use :c:member:`PyConfig.user_site_directory` or
- :c:func:`PyConfig_Get("user_site_directory") <PyConfig_Get>` instead.
- * :c:var:`Py_UnbufferedStdioFlag`:
- Use :c:member:`PyConfig.buffered_stdio` or
- :c:func:`PyConfig_Get("buffered_stdio") <PyConfig_Get>` instead.
- * :c:var:`Py_HashRandomizationFlag`:
- Use :c:member:`PyConfig.use_hash_seed`
- and :c:member:`PyConfig.hash_seed` or
- :c:func:`PyConfig_Get("hash_seed") <PyConfig_Get>` instead.
- * :c:var:`Py_IsolatedFlag`:
- Use :c:member:`PyConfig.isolated` or
- :c:func:`PyConfig_Get("isolated") <PyConfig_Get>` instead.
- * :c:var:`Py_LegacyWindowsFSEncodingFlag`:
- Use :c:member:`PyPreConfig.legacy_windows_fs_encoding` or
- :c:func:`PyConfig_Get("legacy_windows_fs_encoding") <PyConfig_Get>` instead.
- * :c:var:`Py_LegacyWindowsStdioFlag`:
- Use :c:member:`PyConfig.legacy_windows_stdio` or
- :c:func:`PyConfig_Get("legacy_windows_stdio") <PyConfig_Get>` instead.
- * :c:var:`!Py_FileSystemDefaultEncoding`, :c:var:`!Py_HasFileSystemDefaultEncoding`:
- Use :c:member:`PyConfig.filesystem_encoding` or
- :c:func:`PyConfig_Get("filesystem_encoding") <PyConfig_Get>` instead.
- * :c:var:`!Py_FileSystemDefaultEncodeErrors`:
- Use :c:member:`PyConfig.filesystem_errors` or
- :c:func:`PyConfig_Get("filesystem_errors") <PyConfig_Get>` instead.
- * :c:var:`!Py_UTF8Mode`:
- Use :c:member:`PyPreConfig.utf8_mode` or
- :c:func:`PyConfig_Get("utf8_mode") <PyConfig_Get>` instead.
- (see :c:func:`Py_PreInitialize`)
-
- The :c:func:`Py_InitializeFromConfig` API should be used with
- :c:type:`PyConfig` to set these options. Or :c:func:`PyConfig_Get` can be
- used to get these options at runtime.
Pending removal in Python 3.16
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-* The bundled copy of ``libmpdec``.
+* Functions to configure Python's initialization, deprecated in Python 3.11:
+
+ * :c:func:`!PySys_SetArgvEx()`:
+ Set :c:member:`PyConfig.argv` instead.
+ * :c:func:`!PySys_SetArgv()`:
+ Set :c:member:`PyConfig.argv` instead.
+ * :c:func:`!Py_SetProgramName()`:
+ Set :c:member:`PyConfig.program_name` instead.
+ * :c:func:`!Py_SetPythonHome()`:
+ Set :c:member:`PyConfig.home` instead.
+
+ The :c:func:`Py_InitializeFromConfig` API should be used with
+ :c:type:`PyConfig` instead.
+
+* Global configuration variables:
+
+ * :c:var:`Py_DebugFlag`:
+ Use :c:member:`PyConfig.parser_debug` or
+ :c:func:`PyConfig_Get("parser_debug") <PyConfig_Get>` instead.
+ * :c:var:`Py_VerboseFlag`:
+ Use :c:member:`PyConfig.verbose` or
+ :c:func:`PyConfig_Get("verbose") <PyConfig_Get>` instead.
+ * :c:var:`Py_QuietFlag`:
+ Use :c:member:`PyConfig.quiet` or
+ :c:func:`PyConfig_Get("quiet") <PyConfig_Get>` instead.
+ * :c:var:`Py_InteractiveFlag`:
+ Use :c:member:`PyConfig.interactive` or
+ :c:func:`PyConfig_Get("interactive") <PyConfig_Get>` instead.
+ * :c:var:`Py_InspectFlag`:
+ Use :c:member:`PyConfig.inspect` or
+ :c:func:`PyConfig_Get("inspect") <PyConfig_Get>` instead.
+ * :c:var:`Py_OptimizeFlag`:
+ Use :c:member:`PyConfig.optimization_level` or
+ :c:func:`PyConfig_Get("optimization_level") <PyConfig_Get>` instead.
+ * :c:var:`Py_NoSiteFlag`:
+ Use :c:member:`PyConfig.site_import` or
+ :c:func:`PyConfig_Get("site_import") <PyConfig_Get>` instead.
+ * :c:var:`Py_BytesWarningFlag`:
+ Use :c:member:`PyConfig.bytes_warning` or
+ :c:func:`PyConfig_Get("bytes_warning") <PyConfig_Get>` instead.
+ * :c:var:`Py_FrozenFlag`:
+ Use :c:member:`PyConfig.pathconfig_warnings` or
+ :c:func:`PyConfig_Get("pathconfig_warnings") <PyConfig_Get>` instead.
+ * :c:var:`Py_IgnoreEnvironmentFlag`:
+ Use :c:member:`PyConfig.use_environment` or
+ :c:func:`PyConfig_Get("use_environment") <PyConfig_Get>` instead.
+ * :c:var:`Py_DontWriteBytecodeFlag`:
+ Use :c:member:`PyConfig.write_bytecode` or
+ :c:func:`PyConfig_Get("write_bytecode") <PyConfig_Get>` instead.
+ * :c:var:`Py_NoUserSiteDirectory`:
+ Use :c:member:`PyConfig.user_site_directory` or
+ :c:func:`PyConfig_Get("user_site_directory") <PyConfig_Get>` instead.
+ * :c:var:`Py_UnbufferedStdioFlag`:
+ Use :c:member:`PyConfig.buffered_stdio` or
+ :c:func:`PyConfig_Get("buffered_stdio") <PyConfig_Get>` instead.
+ * :c:var:`Py_HashRandomizationFlag`:
+ Use :c:member:`PyConfig.use_hash_seed`
+ and :c:member:`PyConfig.hash_seed` or
+ :c:func:`PyConfig_Get("hash_seed") <PyConfig_Get>` instead.
+ * :c:var:`Py_IsolatedFlag`:
+ Use :c:member:`PyConfig.isolated` or
+ :c:func:`PyConfig_Get("isolated") <PyConfig_Get>` instead.
+ * :c:var:`Py_LegacyWindowsFSEncodingFlag`:
+ Use :c:member:`PyPreConfig.legacy_windows_fs_encoding` or
+ :c:func:`PyConfig_Get("legacy_windows_fs_encoding") <PyConfig_Get>` instead.
+ * :c:var:`Py_LegacyWindowsStdioFlag`:
+ Use :c:member:`PyConfig.legacy_windows_stdio` or
+ :c:func:`PyConfig_Get("legacy_windows_stdio") <PyConfig_Get>` instead.
+ * :c:var:`!Py_FileSystemDefaultEncoding`, :c:var:`!Py_HasFileSystemDefaultEncoding`:
+ Use :c:member:`PyConfig.filesystem_encoding` or
+ :c:func:`PyConfig_Get("filesystem_encoding") <PyConfig_Get>` instead.
+ * :c:var:`!Py_FileSystemDefaultEncodeErrors`:
+ Use :c:member:`PyConfig.filesystem_errors` or
+ :c:func:`PyConfig_Get("filesystem_errors") <PyConfig_Get>` instead.
+ * :c:var:`!Py_UTF8Mode`:
+ Use :c:member:`PyPreConfig.utf8_mode` or
+ :c:func:`PyConfig_Get("utf8_mode") <PyConfig_Get>` instead.
+ (see :c:func:`Py_PreInitialize`)
+
+ The :c:func:`Py_InitializeFromConfig` API should be used with
+ :c:type:`PyConfig` to set these options. Or :c:func:`PyConfig_Get` can be
+ used to get these options at runtime.
+
+* :c:type:`Py_UNICODE` which was deprecated by :pep:`393`.
Deprecations
============
-.. include:: pending-removal-in-3.15.rst
-
.. include:: pending-removal-in-3.16.rst
.. include:: pending-removal-in-3.17.rst
C API deprecations
------------------
-.. include:: c-api-pending-removal-in-3.15.rst
-
.. include:: c-api-pending-removal-in-3.16.rst
.. include:: c-api-pending-removal-in-3.18.rst
is deprecated. In Python 3.15, ``__cached__`` will cease to be set or
take into consideration by the import system or standard library. (:gh:`97879`)
- * Setting :attr:`~module.__package__` on a module while
- failing to set :attr:`__spec__.parent <importlib.machinery.ModuleSpec.parent>`
- is deprecated. In Python 3.15, :attr:`!__package__` will cease to be set or
- take into consideration by the import system or standard library. (:gh:`97879`)
-
* :mod:`ctypes`:
* The undocumented :func:`!ctypes.SetPointerType` function
is deprecated. In Python 3.16, :attr:`!__loader__` will cease to be set or
taken into consideration by the import system or the standard library.
+ * Setting :attr:`~module.__package__` on a module while
+ failing to set :attr:`__spec__.parent <importlib.machinery.ModuleSpec.parent>`
+ is deprecated. In Python 3.16, :attr:`!__package__` will cease to be
+ taken into consideration by the import system or standard library. (:gh:`97879`)
+
+* The bundled copy of ``libmpdec``.
+
* :mod:`array`:
* The ``'u'`` format code (:c:type:`wchar_t`)
Raise :exc:`DeprecationWarning` instead of :exc:`ImportWarning` when
falling back to :attr:`!__package__` during import resolution.
- .. deprecated-removed:: 3.13 3.15
+ .. deprecated-removed:: 3.13 3.16
:attr:`!__package__` will cease to be set or taken into consideration
by the import system or standard library.
c-api/allocation.html: deprecated-aliases
c-api/file.html: deprecated-api
+# Removed sections
library/asyncio-task.html: terminating-a-task-group
+deprecations/index.html: pending-removal-in-python-3-15
+deprecations/index.html: c-api-pending-removal-in-python-3-15
# Removed libmpdec
using/configure.html: cmdoption-with-system-libmpdec
projects / thirdparty / Python / cpython.git / commitdiff
