Nov 15, 2023 · Nov 16, 2023 · Nov 16, 2023 · Nov 17, 2023 · Nov 17, 2023 · Nov 17, 2023
diff --git a/Doc/c-api/type.rst b/Doc/c-api/type.rst

   .. versionadded:: 3.11

 .. c:function:: PyObject* PyType_GetFullyQualifiedName(PyTypeObject *type)

   Return the type's :term:`fully qualified name`. Equivalent to getting the
   type's :attr:`__fully_qualified_name__ <class.__fully_qualified_name__>`
   attribute.

   .. versionadded:: 3.13

 .. c:function:: void* PyType_GetSlot(PyTypeObject *type, int slot)

   Return the function pointer stored in the given slot. If the
diff --git a/Doc/glossary.rst b/Doc/glossary.rst
      division.  Note that ``(-11) // 4`` is ``-3`` because that is ``-2.75``
      rounded *downward*. See :pep:`238`.

   fully qualified name
      The fully qualified name is the entire dotted path to a class or a
      module.

      The :attr:`class.__fully_qualified_name__` attribute includes the module
      name, except for built-in classes. Example::

         >>> import collections
         >>> collections.OrderedDict.__fully_qualified_name__
         'collections.OrderedDict'

      When used to refer to modules, the *fully qualified name* means the
      entire dotted path to the module, including any parent packages,
      e.g. ``email.mime.text``::

         >>> import email.mime.text
         >>> email.mime.text.__name__
         'email.mime.text'

   function
      A series of statements which returns some value to a caller. It can also
      be passed zero or more :term:`arguments <argument>` which may be used in
diff --git a/Doc/library/doctest.rst b/Doc/library/doctest.rst
 .. data:: IGNORE_EXCEPTION_DETAIL

   When specified, doctests expecting exceptions pass so long as an exception
   of the expected type is raised, even if the details
 (message andfully qualified exception name) don't match.
   of the expected type is raised, even if the details (message and
 :term:`fully qualified exception name <fully qualified name>`) don't match.

   For example, an example expecting ``ValueError: 42`` will pass if the actual
   exception raised is ``ValueError: 3*14``, but will fail if, say, a
   :exc:`TypeError` is raised instead.
   It will also ignore any fully qualified name included before the
   It will also ignore any:term:`fully qualified name` included before the
   exception class, which can vary between implementations and versions
   of Python and the code/libraries in use.
   Hence, all three of these variations will work with the flag specified:
diff --git a/Doc/library/email.contentmanager.rst b/Doc/library/email.contentmanager.rst
      found:

      * the type itself (``typ``)
      * the type's fully qualified name (``typ.__module__ + '.' +
        typ.__qualname__``).
      * the type's:term:`fully qualified name`
 (:attr:`typ.__fully_qualified_name__ <class.__fully_qualified_name__>`).
      * the type's qualname (``typ.__qualname__``)
      * the type's name (``typ.__name__``).

diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
        reloaded):

        - :attr:`__name__`
            The module's fully qualified name.
            The module's:term:`fully qualified name`.
            It is ``'__main__'`` for an executed module.

        - :attr:`__file__`
            as an indicator that the module is a package.

        - :attr:`__package__`
            The fully qualified name of the package the module is in (or the
            empty string for a top-level module).
            The:term:`fully qualified name` of the package the module is in
 (or theempty string for a top-level module).
            If the module is a package then this is the same as :attr:`__name__`.

        - :attr:`__loader__`

   (:attr:`__name__`)

   The module's fully qualified name.
   The module's:term:`fully qualified name`.
   The :term:`finder` should always set this attribute to a non-empty string.

   .. attribute:: loader

   (:attr:`__package__`)

   (Read-only) The fully qualified name of the package the module is in (or the
   empty string for a top-level module).
   (Read-only) The:term:`fully qualified name` of the package the module is in
 (or theempty string for a top-level module).
   If the module is a package then this is the same as :attr:`name`.

   .. attribute:: has_location
diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst
 |           | co_name           | name with which this code |
 |           |                   | object was defined        |
 +-----------+-------------------+---------------------------+
 |           | co_qualname       |fullyqualified name with |
 |           | co_qualname       | qualified name with |
 |           |                   | which this code object    |
 |           |                   | was defined               |
 +-----------+-------------------+---------------------------+
diff --git a/Doc/library/logging.config.rst b/Doc/library/logging.config.rst

  The configuring dict is searched for the following keys:

  * ``class`` (mandatory).  This is the fully qualified name of the
  * ``class`` (mandatory).  This is the:term:`fully qualified name` of the
    handler class.

  * ``level`` (optional).  The level of the handler.
diff --git a/Doc/library/pickle.rst b/Doc/library/pickle.rst
 defining module must be importable in the unpickling environment, and the module
 must contain the named object, otherwise an exception will be raised. [#]_

 Similarly, classes are pickled by fully qualified name, so the same restrictions in
 Similarly, classes are pickled by:term:`fully qualified name`, so the same restrictions in
 the unpickling environment apply.  Note that none of the class's code or data is
 pickled, so in the following example the class attribute ``attr`` is not
 restored in the unpickling environment::
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
   .. versionadded:: 3.3


 .. attribute:: class.__fully_qualified_name__

   The :term:`fully qualified name` of the class instance:
   ``f"{class.__module__}.{class.__qualname__}"``, or ``class.__qualname__`` if
   ``class.__module__`` is not a string or is equal to ``"builtins"``.

   .. versionadded:: 3.13


 .. attribute:: definition.__type_params__

   The :ref:`type parameters <type-params>` of generic classes, functions,
diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
   test name using :meth:`fnmatch.fnmatchcase`; otherwise simple case-sensitive
   substring matching is used.

   Patterns are matched against the fully qualified test method name as
   imported by the test loader.
   Patterns are matched against the:term:`fully qualified test method name
 <fully qualified name>` asimported by the test loader.

   For example, ``-k foo`` matches ``foo_tests.SomeTest.test_something``,
   ``bar_tests.SomeTest.test_foo``, but not ``bar_tests.FooTest.test_something``.
diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst
  category must be a subclass in order to match.

 * *module* is a string containing a regular expression that the start of the
  fully qualified module name must match, case-sensitively.  In :option:`-W` and
  :term:`fully qualified module name <fully qualified name>` must match,
  case-sensitively.  In :option:`-W` and
  :envvar:`PYTHONWARNINGS`, *module* is a literal string that the
  fully qualified module name must be equal to (case-sensitively), ignoring any
  whitespace at the start or end of *module*.
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
   single: co_qualname (code object attribute)

 Special read-only attributes: :attr:`co_name` gives the function name;
 :attr:`co_qualname` gives thefullyqualified function name;
 :attr:`co_qualname` gives the qualified function name;
 :attr:`co_argcount` is the total number of positional arguments
 (including positional-only arguments and arguments with default values);
 :attr:`co_posonlyargcount` is the number of positional-only arguments
diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst
 Searching
 =========

 To begin the search, Python needs the :term:`fully qualified<qualifiedname>`
 nameof the module (or package, but for the purposes of this discussion, the
 To begin the search, Python needs the :term:`fully qualified name`
 of the module (or package, but for the purposes of this discussion, the
 difference is immaterial) being imported.  This name may come from various
 arguments to the :keyword:`import` statement, or from the parameters to the
 :func:`importlib.import_module` or :func:`__import__` functions.

 .. attribute:: __name__

   The ``__name__`` attribute must be set to the fully qualified name of
   The ``__name__`` attribute must be set to the:term:`fully qualified name` of
   the module.  This name is used to uniquely identify the module in
   the import system.

 the :meth:`~importlib.abc.PathEntryFinder.find_spec` method.

 :meth:`~importlib.abc.PathEntryFinder.find_spec` takes two arguments: the
 fully qualified name of the module being imported, and the (optional) target
 :term:`fully qualified name` of the module being imported, and the (optional) target
 module.  ``find_spec()`` returns a fully populated spec for the module.
 This spec will always have "loader" set (with one exception).

   implemented on the path entry finder, the legacy methods are ignored.

   :meth:`!find_loader` takes one argument, the
   fully qualified name of the module being imported.  ``find_loader()``
 :term:`fully qualified name` of the module being imported.  ``find_loader()``
   returns a 2-tuple where the first item is the loader and the second item
   is a namespace :term:`portion`.

diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst
   whether the actual warning category of the message is a subclass of the
   specified warning category.

   The *module* field matches the(fully qualified) module name; this match is
   case-sensitive.
   The *module* field matches the:term:`fully qualified module name <fully
 qualified name>`; this match iscase-sensitive.

   The *lineno* field matches the line number, where zero matches all line
   numbers and is thus equivalent to an omitted line number.
diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst
  equivalent of the :option:`-X frozen_modules <-X>` command-line option.
  (Contributed by Yilei Yang in :gh:`111374`.)

 * Add the :attr:`__fully_qualified_name__ <class.__fully_qualified_name__>`
  read-only attribute to types: the :term:`fully qualified name` of the type.
  (Contributed by Victor Stinner in :gh:`111696`.)


 New Modules
 ===========

  :exc:`KeyError` if the key missing.
  (Contributed by Stefan Behnel and Victor Stinner in :gh:`111262`.)

 * Add :c:func:`PyType_GetFullyQualifiedName` function: get the type's
  :term:`fully qualified name`. It is equivalent to getting the type's
  :attr:`__fully_qualified_name__ <class.__fully_qualified_name__>` attribute.
  (Contributed by Victor Stinner in :gh:`111696`.)


 Porting to Python 3.13
 ----------------------
diff --git a/Include/cpython/object.h b/Include/cpython/object.h
 PyAPI_FUNC(PyObject *) _PyType_Lookup(PyTypeObject *, PyObject *);
 PyAPI_FUNC(PyObject *) PyType_GetModuleByDef(PyTypeObject *, PyModuleDef *);
 PyAPI_FUNC(PyObject *) PyType_GetDict(PyTypeObject *);
 PyAPI_FUNC(PyObject *) PyType_GetFullyQualifiedName(PyTypeObject *);

 PyAPI_FUNC(int) PyObject_Print(PyObject *, FILE *, int);
 PyAPI_FUNC(void) _Py_BreakPoint(void);
diff --git a/Lib/_collections_abc.py b/Lib/_collections_abc.py
    (Keep this roughly in sync with the typing version.)
    """
    if isinstance(obj, type):
        if obj.__module__ == 'builtins':
            return obj.__qualname__
        return f'{obj.__module__}.{obj.__qualname__}'
        return obj.__fully_qualified_name__
    if obj is Ellipsis:
        return '...'
    if isinstance(obj, FunctionType):
diff --git a/Lib/_py_abc.py b/Lib/_py_abc.py

    def _dump_registry(cls, file=None):
        """Debug helper to print the ABC registry."""
        print(f"Class: {cls.__module__}.{cls.__qualname__}", file=file)
        print(f"Class: {cls.__fully_qualified_name__}", file=file)
        print(f"Inv. counter: {get_cache_token()}", file=file)
        for name in cls.__dict__:
            if name.startswith("_abc_"):
diff --git a/Lib/abc.py b/Lib/abc.py

        def _dump_registry(cls, file=None):
            """Debug helper to print the ABC registry."""
            print(f"Class: {cls.__module__}.{cls.__qualname__}", file=file)
            print(f"Class: {cls.__fully_qualified_name__}", file=file)
            print(f"Inv. counter: {get_cache_token()}", file=file)
            (_abc_registry, _abc_cache, _abc_negative_cache,
             _abc_negative_cache_version) = _get_dump(cls)
diff --git a/Lib/codecs.py b/Lib/codecs.py
        return self

    def __repr__(self):
        return "<%s.%s object for encoding %s at %#x>" % \
                (self.__class__.__module__, self.__class__.__qualname__,
        return "<%s object for encoding %s at %#x>" % \
                (self.__class__.__fully_qualified_name__,
                 self.name, id(self))

    def __getnewargs__(self):
diff --git a/Lib/contextlib.py b/Lib/contextlib.py
            _enter = cls.__enter__
            _exit = cls.__exit__
        except AttributeError:
            raise TypeError(f"'{cls.__module__}.{cls.__qualname__}' object does "
            raise TypeError(f"'{cls.__fully_qualified_name__}' object does "
                            f"not support the context manager protocol") from None
        result = _enter(cm)
        self._push_cm_exit(cm, _exit)
            _enter = cls.__aenter__
            _exit = cls.__aexit__
        except AttributeError:
            raise TypeError(f"'{cls.__module__}.{cls.__qualname__}' object does "
            raise TypeError(f"'{cls.__fully_qualified_name__}' object does "
                            f"not support the asynchronous context manager protocol"
                           ) from None
        result = await _enter(cm)
diff --git a/Lib/doctest.py b/Lib/doctest.py
                    # They start with `SyntaxError:` (or any other class name)
                    exception_line_prefixes = (
                        f"{exception[0].__qualname__}:",
                        f"{exception[0].__module__}.{exception[0].__qualname__}:",
                        f"{exception[0].__fully_qualified_name__}:",
                    )
                    exc_msg_index = next(
                        index
diff --git a/Lib/inspect.py b/Lib/inspect.py
    if isinstance(annotation, types.GenericAlias):
        return str(annotation)
    if isinstance(annotation, type):
        if annotation.__module__in ('builtins',base_module):
        if annotation.__module__==base_module:
            return annotation.__qualname__
        return annotation.__module__+'.'+annotation.__qualname__
        return annotation.__fully_qualified_name__
    return repr(annotation)

 def formatannotationrelativeto(object):
diff --git a/Lib/multiprocessing/pool.py b/Lib/multiprocessing/pool.py

    def __repr__(self):
        cls = self.__class__
        return (f'<{cls.__module__}.{cls.__qualname__} '
        return (f'<{cls.__fully_qualified_name__} '
                f'state={self._state} '
                f'pool_size={len(self._pool)}>')

diff --git a/Lib/pdb.py b/Lib/pdb.py
            return
        # Is it a class?
        if value.__class__ is type:
            self.message('Class%s.%s' % (value.__module__, value.__qualname__))
            self.message(f'Class{value.__fully_qualified_name__}')
            return
        # None of the above...
        self.message(type(value))
diff --git a/Lib/test/support/asyncore.py b/Lib/test/support/asyncore.py
            self.socket = None

    def __repr__(self):
        status = [self.__class__.__module__+"."+self.__class__.__qualname__]
        status = [self.__class__.__fully_qualified_name__]
        if self.accepting and self.addr:
            status.append('listening')
        elif self.connected:
Original file line number	Diff line number	Diff line change
Expand Up		@@ -185,6 +185,14 @@ Type Objects

		.. versionadded:: 3.11

		.. c:function:: PyObject* PyType_GetFullyQualifiedName(PyTypeObject *type)

		Return the type's :term:`fully qualified name`. Equivalent to getting the
		type's :attr:`__fully_qualified_name__ <class.__fully_qualified_name__>`
		attribute.

		.. versionadded:: 3.13

		.. c:function:: void* PyType_GetSlot(PyTypeObject *type, int slot)

		Return the function pointer stored in the given slot. If the
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -435,6 +435,25 @@ Glossary
		division. Note that ``(-11) // 4`` is ``-3`` because that is ``-2.75``
		rounded downward. See :pep:`238`.

		fully qualified name
		The fully qualified name is the entire dotted path to a class or a
		module.

		The :attr:`class.__fully_qualified_name__` attribute includes the module
		name, except for built-in classes. Example::

		>>> import collections
		>>> collections.OrderedDict.__fully_qualified_name__
		'collections.OrderedDict'

		When used to refer to modules, the fully qualified name means the
		entire dotted path to the module, including any parent packages,
		e.g. ``email.mime.text``::

		>>> import email.mime.text
		>>> email.mime.text.__name__
		'email.mime.text'

		function
		A series of statements which returns some value to a caller. It can also
		be passed zero or more :term:`arguments <argument>` which may be used in
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -587,13 +587,13 @@ doctest decides whether actual output matches an example's expected output:
		.. data:: IGNORE_EXCEPTION_DETAIL

		When specified, doctests expecting exceptions pass so long as an exception
		of the expected type is raised, even if the details
		(message andfully qualified exception name) don't match.
		of the expected type is raised, even if the details (message and
		:term:`fully qualified exception name <fully qualified name>`) don't match.

		For example, an example expecting ``ValueError: 42`` will pass if the actual
		exception raised is ``ValueError: 3*14``, but will fail if, say, a
		:exc:`TypeError` is raised instead.
		It will also ignore any fully qualified name included before the
		It will also ignore any:term:`fully qualified name` included before the
		exception class, which can vary between implementations and versions
		of Python and the code/libraries in use.
		Hence, all three of these variations will work with the flag specified:
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -56,8 +56,8 @@
		found:

		* the type itself (``typ``)
		* the type's fully qualified name (``typ.__module__ + '.' +
		typ.__qualname__``).
		* the type's:term:`fully qualified name`
		(:attr:`typ.__fully_qualified_name__ <class.__fully_qualified_name__>`).
		* the type's qualname (``typ.__qualname__``)
		* the type's name (``typ.__name__``).

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -356,7 +356,7 @@ ABC hierarchy::
		reloaded):

		- :attr:`__name__`
		The module's fully qualified name.
		The module's:term:`fully qualified name`.
		It is ``'__main__'`` for an executed module.

		- :attr:`__file__`
Expand All		@@ -377,8 +377,8 @@ ABC hierarchy::
		as an indicator that the module is a package.

		- :attr:`__package__`
		The fully qualified name of the package the module is in (or the
		empty string for a top-level module).
		The:term:`fully qualified name` of the package the module is in
		(or theempty string for a top-level module).
		If the module is a package then this is the same as :attr:`__name__`.

		- :attr:`__loader__`
Expand DownExpand Up		@@ -1181,7 +1181,7 @@ find and load modules.

		(:attr:`__name__`)

		The module's fully qualified name.
		The module's:term:`fully qualified name`.
		The :term:`finder` should always set this attribute to a non-empty string.

		.. attribute:: loader
Expand DownExpand Up		@@ -1230,8 +1230,8 @@ find and load modules.

		(:attr:`__package__`)

		(Read-only) The fully qualified name of the package the module is in (or the
		empty string for a top-level module).
		(Read-only) The:term:`fully qualified name` of the package the module is in
		(or theempty string for a top-level module).
		If the module is a package then this is the same as :attr:`name`.

		.. attribute:: has_location
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -182,7 +182,7 @@ attributes (see :ref:`import-mod-attrs` for module attributes):
		\| \| co_name \| name with which this code \|
		\| \| \| object was defined \|
		+-----------+-------------------+---------------------------+
		\| \| co_qualname \|fullyqualified name with \|
		\| \| co_qualname \| qualified name with \|
		\| \| \| which this code object \|
		\| \| \| was defined \|
		+-----------+-------------------+---------------------------+
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -286,7 +286,7 @@ otherwise, the context is used to determine what to instantiate.

		The configuring dict is searched for the following keys:

		* ``class`` (mandatory). This is the fully qualified name of the
		* ``class`` (mandatory). This is the:term:`fully qualified name` of the
		handler class.

		* ``level`` (optional). The level of the handler.
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -525,7 +525,7 @@ the function's code, nor any of its function attributes are pickled. Thus the
		defining module must be importable in the unpickling environment, and the module
		must contain the named object, otherwise an exception will be raised. [#]_

		Similarly, classes are pickled by fully qualified name, so the same restrictions in
		Similarly, classes are pickled by:term:`fully qualified name`, so the same restrictions in
		the unpickling environment apply. Note that none of the class's code or data is
		pickled, so in the following example the class attribute ``attr`` is not
		restored in the unpickling environment::
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -5496,6 +5496,15 @@ types, where they are relevant. Some of these are not reported by the
		.. versionadded:: 3.3


		.. attribute:: class.__fully_qualified_name__
vstinner marked this conversation as resolved. Show resolvedHide resolved

		The :term:`fully qualified name` of the class instance:
		``f"{class.__module__}.{class.__qualname__}"``, or ``class.__qualname__`` if
		``class.__module__`` is not a string or is equal to ``"builtins"``.

		.. versionadded:: 3.13


		.. attribute:: definition.__type_params__

		The :ref:`type parameters <type-params>` of generic classes, functions,
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -234,8 +234,8 @@ Command-line options
		test name using :meth:`fnmatch.fnmatchcase`; otherwise simple case-sensitive
		substring matching is used.

		Patterns are matched against the fully qualified test method name as
		imported by the test loader.
		Patterns are matched against the:term:`fully qualified test method name
		<fully qualified name>` asimported by the test loader.

		For example, ``-k foo`` matches ``foo_tests.SomeTest.test_something``,
		``bar_tests.SomeTest.test_foo``, but not ``bar_tests.FooTest.test_something``.
Expand Down