https://github.com/python/cpython/commit/4cf3e80eeeb4763bae4ab5fb1b91c146c3da0876
commit: 4cf3e80eeeb4763bae4ab5fb1b91c146c3da0876
branch: 3.13
author: Serhiy Storchaka <[email protected]>
committer: serhiy-storchaka <[email protected]>
date: 2025-02-04T14:25:18Z
summary:
[3.13] Use roles :data: and :const: for referencing module variables
(GH-129507) (GH-129649)
(cherry picked from commit 078ab828b9a21ed0e683941bd141d5017b5f62d9)
files:
M Doc/howto/free-threading-python.rst
M Doc/library/datetime.rst
M Doc/library/decimal.rst
M Doc/library/filecmp.rst
M Doc/library/importlib.metadata.rst
M Doc/library/importlib.rst
M Doc/library/logging.rst
M Doc/library/plistlib.rst
M Doc/library/select.rst
M Doc/library/site.rst
M Doc/library/ssl.rst
M Doc/whatsnew/2.3.rst
M Doc/whatsnew/2.7.rst
M Doc/whatsnew/3.12.rst
M Doc/whatsnew/3.13.rst
M Doc/whatsnew/3.4.rst
M Misc/NEWS.d/3.11.0a4.rst
diff --git a/Doc/howto/free-threading-python.rst
b/Doc/howto/free-threading-python.rst
index b21e3287ecaa3f..cd920553a3a461 100644
--- a/Doc/howto/free-threading-python.rst
+++ b/Doc/howto/free-threading-python.rst
@@ -43,7 +43,7 @@ Identifying free-threaded Python
================================
To check if the current interpreter supports free-threading, :option:`python
-VV <-V>`
-and :attr:`sys.version` contain "experimental free-threading build".
+and :data:`sys.version` contain "experimental free-threading build".
The new :func:`sys._is_gil_enabled` function can be used to check whether
the GIL is actually disabled in the running process.
diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
index 211e625c4303b0..4c7d3cd119dd01 100644
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -93,7 +93,7 @@ The :mod:`!datetime` module exports the following constants:
The largest year number allowed in a :class:`date` or :class:`.datetime`
object.
:const:`MAXYEAR` is 9999.
-.. attribute:: UTC
+.. data:: UTC
Alias for the UTC time zone singleton :attr:`datetime.timezone.utc`.
@@ -937,7 +937,7 @@ Other constructors, all class methods:
.. deprecated:: 3.12
- Use :meth:`datetime.now` with :attr:`UTC` instead.
+ Use :meth:`datetime.now` with :const:`UTC` instead.
.. classmethod:: datetime.fromtimestamp(timestamp, tz=None)
@@ -1009,7 +1009,7 @@ Other constructors, all class methods:
.. deprecated:: 3.12
- Use :meth:`datetime.fromtimestamp` with :attr:`UTC` instead.
+ Use :meth:`datetime.fromtimestamp` with :const:`UTC` instead.
.. classmethod:: datetime.fromordinal(ordinal)
diff --git a/Doc/library/decimal.rst b/Doc/library/decimal.rst
index f1bd3e8f371ee2..2332b6fc62709d 100644
--- a/Doc/library/decimal.rst
+++ b/Doc/library/decimal.rst
@@ -2245,7 +2245,7 @@ value for :attr:`~Context.prec` as well [#]_::
Decimal('904625697166532776746648320380374280103671755200316906558262375061821325312')
-For inexact results, :attr:`MAX_PREC` is far too large on 64-bit platforms and
+For inexact results, :const:`MAX_PREC` is far too large on 64-bit platforms and
the available memory will be insufficient::
>>> Decimal(1) / 3
diff --git a/Doc/library/filecmp.rst b/Doc/library/filecmp.rst
index 282d0e0d8db5cf..abd1b8c826d170 100644
--- a/Doc/library/filecmp.rst
+++ b/Doc/library/filecmp.rst
@@ -189,7 +189,7 @@ The :class:`dircmp` class
are the same type as *self*, if *self* is a subclass of
:class:`dircmp`.
-.. attribute:: DEFAULT_IGNORES
+.. data:: DEFAULT_IGNORES
.. versionadded:: 3.4
diff --git a/Doc/library/importlib.metadata.rst
b/Doc/library/importlib.metadata.rst
index c38da0bd341fc9..87f40301a9953d 100644
--- a/Doc/library/importlib.metadata.rst
+++ b/Doc/library/importlib.metadata.rst
@@ -375,7 +375,7 @@ Mapping import to distribution packages
.. function:: packages_distributions()
Return a mapping from the top level module and import package
- names found via :attr:`sys.meta_path` to the names of the distribution
+ names found via :data:`sys.meta_path` to the names of the distribution
packages (if any) that provide the corresponding files.
To allow for namespace packages (which may have members provided by
diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index 03bd8b144d4c62..3d56ebd75771ee 100644
--- a/Doc/library/importlib.rst
+++ b/Doc/library/importlib.rst
@@ -746,7 +746,7 @@ ABC hierarchy::
suitable for reading (same as :attr:`pathlib.Path.open`).
When opening as text, accepts encoding parameters such as those
- accepted by :attr:`io.TextIOWrapper`.
+ accepted by :class:`io.TextIOWrapper`.
.. method:: read_bytes()
@@ -794,14 +794,14 @@ ABC hierarchy::
This module contains the various objects that help :keyword:`import`
find and load modules.
-.. attribute:: SOURCE_SUFFIXES
+.. data:: SOURCE_SUFFIXES
A list of strings representing the recognized file suffixes for source
modules.
.. versionadded:: 3.3
-.. attribute:: DEBUG_BYTECODE_SUFFIXES
+.. data:: DEBUG_BYTECODE_SUFFIXES
A list of strings representing the file suffixes for non-optimized bytecode
modules.
@@ -809,9 +809,9 @@ find and load modules.
.. versionadded:: 3.3
.. deprecated:: 3.5
- Use :attr:`BYTECODE_SUFFIXES` instead.
+ Use :const:`BYTECODE_SUFFIXES` instead.
-.. attribute:: OPTIMIZED_BYTECODE_SUFFIXES
+.. data:: OPTIMIZED_BYTECODE_SUFFIXES
A list of strings representing the file suffixes for optimized bytecode
modules.
@@ -819,9 +819,9 @@ find and load modules.
.. versionadded:: 3.3
.. deprecated:: 3.5
- Use :attr:`BYTECODE_SUFFIXES` instead.
+ Use :const:`BYTECODE_SUFFIXES` instead.
-.. attribute:: BYTECODE_SUFFIXES
+.. data:: BYTECODE_SUFFIXES
A list of strings representing the recognized file suffixes for bytecode
modules (including the leading dot).
@@ -831,7 +831,7 @@ find and load modules.
.. versionchanged:: 3.5
The value is no longer dependent on ``__debug__``.
-.. attribute:: EXTENSION_SUFFIXES
+.. data:: EXTENSION_SUFFIXES
A list of strings representing the recognized file suffixes for
extension modules.
@@ -1109,7 +1109,7 @@ find and load modules.
.. method:: is_package(fullname)
Returns ``True`` if the file path points to a package's ``__init__``
- module based on :attr:`EXTENSION_SUFFIXES`.
+ module based on :const:`EXTENSION_SUFFIXES`.
.. method:: get_code(fullname)
@@ -1294,7 +1294,7 @@ find and load modules.
This module contains the various objects that help in the construction of
an :term:`importer`.
-.. attribute:: MAGIC_NUMBER
+.. data:: MAGIC_NUMBER
The bytes which represent the bytecode version number. If you need help with
loading/writing bytecode then consider :class:`importlib.abc.SourceLoader`.
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 8ab107d2a33e44..e930834209692e 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -342,7 +342,7 @@ in a module, ``__name__`` is the module's name in the
Python package namespace.
If no handler is attached to this logger (or any of its ancestors,
taking into account the relevant :attr:`Logger.propagate` attributes),
- the message will be sent to the handler set on :attr:`lastResort`.
+ the message will be sent to the handler set on :data:`lastResort`.
.. versionchanged:: 3.2
The *stack_info* parameter was added.
@@ -1495,7 +1495,7 @@ functions.
Module-Level Attributes
-----------------------
-.. attribute:: lastResort
+.. data:: lastResort
A "handler of last resort" is available through this attribute. This
is a :class:`StreamHandler` writing to ``sys.stderr`` with a level of
@@ -1507,7 +1507,7 @@ Module-Level Attributes
.. versionadded:: 3.2
-.. attribute:: raiseExceptions
+.. data:: raiseExceptions
Used to see if exceptions during handling should be propagated.
diff --git a/Doc/library/plistlib.rst b/Doc/library/plistlib.rst
index 2906ebe7822f52..075b974501e3da 100644
--- a/Doc/library/plistlib.rst
+++ b/Doc/library/plistlib.rst
@@ -71,7 +71,7 @@ This module defines the following functions:
When *aware_datetime* is true, fields with type ``datetime.datetime`` will
be created as :ref:`aware object <datetime-naive-aware>`, with
- :attr:`!tzinfo` as :attr:`datetime.UTC`.
+ :attr:`!tzinfo` as :const:`datetime.UTC`.
XML data for the :data:`FMT_XML` format is parsed using the Expat parser
from :mod:`xml.parsers.expat` -- see its documentation for possible
diff --git a/Doc/library/select.rst b/Doc/library/select.rst
index f23a249f44b485..bbac9bc4bbe3ee 100644
--- a/Doc/library/select.rst
+++ b/Doc/library/select.rst
@@ -165,7 +165,7 @@ The module defines the following:
:exc:`InterruptedError`.
-.. attribute:: PIPE_BUF
+.. data:: PIPE_BUF
The minimum number of bytes which can be written without blocking to a pipe
when the pipe has been reported as ready for writing by
:func:`~select.select`,
diff --git a/Doc/library/site.rst b/Doc/library/site.rst
index 4508091f679dc7..95aea779f82673 100644
--- a/Doc/library/site.rst
+++ b/Doc/library/site.rst
@@ -35,7 +35,7 @@ are skipped. For the tail part, it uses the empty string and
then
:file:`lib/site-packages` (on Windows) or
:file:`lib/python{X.Y[t]}/site-packages` (on Unix and macOS). (The
optional suffix "t" indicates the :term:`free threading` build, and is
-appended if ``"t"`` is present in the :attr:`sys.abiflags` constant.)
+appended if ``"t"`` is present in the :data:`sys.abiflags` constant.)
For each
of the distinct head-tail combinations, it sees if it refers to an existing
directory, and if so, adds it to ``sys.path`` and also inspects the newly
diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst
index f07d151a885692..4daacd7e3aa7fa 100644
--- a/Doc/library/ssl.rst
+++ b/Doc/library/ssl.rst
@@ -1931,8 +1931,8 @@ to speed up repeated connections from the same clients.
A :class:`TLSVersion` enum member representing the highest supported
TLS version. The value defaults to :attr:`TLSVersion.MAXIMUM_SUPPORTED`.
- The attribute is read-only for protocols other than :attr:`PROTOCOL_TLS`,
- :attr:`PROTOCOL_TLS_CLIENT`, and :attr:`PROTOCOL_TLS_SERVER`.
+ The attribute is read-only for protocols other than :const:`PROTOCOL_TLS`,
+ :const:`PROTOCOL_TLS_CLIENT`, and :const:`PROTOCOL_TLS_SERVER`.
The attributes :attr:`~SSLContext.maximum_version`,
:attr:`~SSLContext.minimum_version` and
@@ -1955,7 +1955,7 @@ to speed up repeated connections from the same clients.
.. attribute:: SSLContext.num_tickets
Control the number of TLS 1.3 session tickets of a
- :attr:`PROTOCOL_TLS_SERVER` context. The setting has no impact on TLS
+ :const:`PROTOCOL_TLS_SERVER` context. The setting has no impact on TLS
1.0 to 1.2 connections.
.. versionadded:: 3.8
diff --git a/Doc/whatsnew/2.3.rst b/Doc/whatsnew/2.3.rst
index ac463f82cfb8ca..b7e4e73f4ce4aa 100644
--- a/Doc/whatsnew/2.3.rst
+++ b/Doc/whatsnew/2.3.rst
@@ -353,7 +353,7 @@ convert them to Unicode using the ``mbcs`` encoding.
Other systems also allow Unicode strings as file names but convert them to byte
strings before passing them to the system, which can cause a
:exc:`UnicodeError`
to be raised. Applications can test whether arbitrary Unicode strings are
-supported as file names by checking :attr:`os.path.supports_unicode_filenames`,
+supported as file names by checking
:const:`os.path.supports_unicode_filenames`,
a Boolean value.
Under MacOS, :func:`os.listdir` may now return Unicode filenames.
diff --git a/Doc/whatsnew/2.7.rst b/Doc/whatsnew/2.7.rst
index 0e4dee0bd24fb2..caed3192be871d 100644
--- a/Doc/whatsnew/2.7.rst
+++ b/Doc/whatsnew/2.7.rst
@@ -1602,7 +1602,7 @@ changes, or look through the Subversion logs for all the
details.
identifier instead of the previous default value of ``'python'``.
(Changed by Sean Reifschneider; :issue:`8451`.)
-* The :attr:`sys.version_info` value is now a named tuple, with attributes
+* The :data:`sys.version_info` value is now a named tuple, with attributes
named :attr:`!major`, :attr:`!minor`, :attr:`!micro`,
:attr:`!releaselevel`, and :attr:`!serial`. (Contributed by Ross
Light; :issue:`4285`.)
diff --git a/Doc/whatsnew/3.12.rst b/Doc/whatsnew/3.12.rst
index d2b0911ed627a0..cb9f54c6897ee3 100644
--- a/Doc/whatsnew/3.12.rst
+++ b/Doc/whatsnew/3.12.rst
@@ -1467,8 +1467,8 @@ imp
``imp.NullImporter`` Insert ``None`` into
``sys.path_importer_cache``
``imp.cache_from_source()`` :func:`importlib.util.cache_from_source`
``imp.find_module()`` :func:`importlib.util.find_spec`
- ``imp.get_magic()`` :attr:`importlib.util.MAGIC_NUMBER`
- ``imp.get_suffixes()``
:attr:`importlib.machinery.SOURCE_SUFFIXES`,
:attr:`importlib.machinery.EXTENSION_SUFFIXES`, and
:attr:`importlib.machinery.BYTECODE_SUFFIXES`
+ ``imp.get_magic()`` :const:`importlib.util.MAGIC_NUMBER`
+ ``imp.get_suffixes()``
:const:`importlib.machinery.SOURCE_SUFFIXES`,
:const:`importlib.machinery.EXTENSION_SUFFIXES`, and
:const:`importlib.machinery.BYTECODE_SUFFIXES`
``imp.get_tag()`` :attr:`sys.implementation.cache_tag
<sys.implementation>`
``imp.load_module()`` :func:`importlib.import_module`
``imp.new_module(name)`` ``types.ModuleType(name)``
diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst
index 357345a802ebeb..69960b29f2b7c5 100644
--- a/Doc/whatsnew/3.13.rst
+++ b/Doc/whatsnew/3.13.rst
@@ -334,7 +334,7 @@ enabled at runtime using the environment variable
:envvar:`PYTHON_GIL` or
the command-line option :option:`-X gil=1`.
To check if the current interpreter supports free-threading, :option:`python
-VV <-V>`
-and :attr:`sys.version` contain "experimental free-threading build".
+and :data:`sys.version` contain "experimental free-threading build".
The new :func:`!sys._is_gil_enabled` function can be used to check whether
the GIL is actually disabled in the running process.
@@ -1071,7 +1071,7 @@ os
which makes the newly spawned process use the current process environment.
(Contributed by Jakub Kulik in :gh:`113119`.)
-* :func:`~os.posix_spawn` can now use the :attr:`~os.POSIX_SPAWN_CLOSEFROM`
+* :func:`~os.posix_spawn` can now use the :const:`~os.POSIX_SPAWN_CLOSEFROM`
attribute in the *file_actions* parameter on platforms that support
:c:func:`!posix_spawn_file_actions_addclosefrom_np`.
(Contributed by Jakub Kulik in :gh:`113117`.)
diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
index 71b186aeed7359..e4f602a17ee968 100644
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -994,7 +994,7 @@ The :func:`~importlib.reload` function has been moved from
:mod:`!imp` to
:mod:`importlib` as part of the :mod:`!imp` module deprecation. (Contributed
by
Berker Peksag in :issue:`18193`.)
-:mod:`importlib.util` now has a :data:`~importlib.util.MAGIC_NUMBER` attribute
+:mod:`importlib.util` now has a :const:`~importlib.util.MAGIC_NUMBER` attribute
providing access to the bytecode version number. This replaces the
:func:`!get_magic` function in the deprecated :mod:`!imp` module.
(Contributed by Brett Cannon in :issue:`18192`.)
diff --git a/Misc/NEWS.d/3.11.0a4.rst b/Misc/NEWS.d/3.11.0a4.rst
index 64e2f39ad9db18..a2d36202045887 100644
--- a/Misc/NEWS.d/3.11.0a4.rst
+++ b/Misc/NEWS.d/3.11.0a4.rst
@@ -775,8 +775,8 @@ Ensure that :func:`math.expm1` does not raise on underflow.
.. nonce: s9PuyF
.. section: Library
-Adding :attr:`F_DUP2FD` and :attr:`F_DUP2FD_CLOEXEC` constants from FreeBSD
-into the fcntl module.
+Adding :const:`!F_DUP2FD` and :const:`!F_DUP2FD_CLOEXEC` constants from FreeBSD
+into the :mod:`fcntl` module.
..
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: [email protected]
