sync with cpython aebf072a

Author: github-actions[bot]

howto/descriptor.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-27 00:14+0000\n"
+"POT-Creation-Date: 2025-09-01 00:19+0000\n"
 "PO-Revision-Date: 2018-05-23 14:36+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -75,9 +75,8 @@ msgstr ""
 msgid ""
 "The last section has pure Python equivalents for built-in descriptors that "
 "are written in C.  Read this if you're curious about how functions turn into "
-"bound methods or about the implementation of common tools "
-"like :func:`classmethod`, :func:`staticmethod`, :func:`property`, "
-"and :term:`__slots__`."
+"bound methods or about the implementation of common tools like :func:"
+"`classmethod`, :func:`staticmethod`, :func:`property`, and :term:`__slots__`."
 msgstr ""
 
 #: ../../howto/descriptor.rst:36
@@ -231,9 +230,8 @@ msgid ""
 "A popular use for descriptors is managing access to instance data.  The "
 "descriptor is assigned to a public attribute in the class dictionary while "
 "the actual data is stored as a private attribute in the instance "
-"dictionary.  The descriptor's :meth:`~object.__get__` "
-"and :meth:`~object.__set__` methods are triggered when the public attribute "
-"is accessed."
+"dictionary.  The descriptor's :meth:`~object.__get__` and :meth:`~object."
+"__set__` methods are triggered when the public attribute is accessed."
 msgstr ""
 
 #: ../../howto/descriptor.rst:139
@@ -371,10 +369,9 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:256
 msgid ""
-"An interactive session shows that the :class:`!Person` class has "
-"called :meth:`~object.__set_name__` so that the field names would be "
-"recorded.  Here we call :func:`vars` to look up the descriptor without "
-"triggering it:"
+"An interactive session shows that the :class:`!Person` class has called :"
+"meth:`~object.__set_name__` so that the field names would be recorded.  Here "
+"we call :func:`vars` to look up the descriptor without triggering it:"
 msgstr ""
 
 #: ../../howto/descriptor.rst:260
@@ -431,9 +428,8 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:297
 msgid ""
-"A :term:`descriptor` is what we call any object that "
-"defines :meth:`~object.__get__`, :meth:`~object.__set__`, "
-"or :meth:`~object.__delete__`."
+"A :term:`descriptor` is what we call any object that defines :meth:`~object."
+"__get__`, :meth:`~object.__set__`, or :meth:`~object.__delete__`."
 msgstr ""
 
 #: ../../howto/descriptor.rst:300
@@ -473,9 +469,9 @@ msgstr ""
 #: ../../howto/descriptor.rst:319
 msgid ""
 "Descriptors are used throughout the language.  It is how functions turn into "
-"bound methods.  Common tools "
-"like :func:`classmethod`, :func:`staticmethod`, :func:`property`, "
-"and :func:`functools.cached_property` are all implemented as descriptors."
+"bound methods.  Common tools like :func:`classmethod`, :func:"
+"`staticmethod`, :func:`property`, and :func:`functools.cached_property` are "
+"all implemented as descriptors."
 msgstr ""
 
 #: ../../howto/descriptor.rst:326
@@ -565,9 +561,9 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:374
 msgid ""
-":class:`!Number` verifies that a value is either an :class:`int` "
-"or :class:`float`.  Optionally, it verifies that a value is between a given "
-"minimum or maximum."
+":class:`!Number` verifies that a value is either an :class:`int` or :class:"
+"`float`.  Optionally, it verifies that a value is between a given minimum or "
+"maximum."
 msgstr ""
 
 #: ../../howto/descriptor.rst:378
@@ -618,7 +614,7 @@ msgid ""
 "\n"
 "    def validate(self, value):\n"
 "        if not isinstance(value, str):\n"
-"            raise TypeError(f'Expected {value!r} to be an str')\n"
+"            raise TypeError(f'Expected {value!r} to be a str')\n"
 "        if self.minsize is not None and len(value) < self.minsize:\n"
 "            raise ValueError(\n"
 "                f'Expected {value!r} to be no smaller than {self.minsize!"
@@ -720,10 +716,9 @@ msgstr ""
 #: ../../howto/descriptor.rst:503
 msgid ""
 "In general, a descriptor is an attribute value that has one of the methods "
-"in the descriptor protocol.  Those methods "
-"are :meth:`~object.__get__`, :meth:`~object.__set__`, "
-"and :meth:`~object.__delete__`.  If any of those methods are defined for an "
-"attribute, it is said to be a :term:`descriptor`."
+"in the descriptor protocol.  Those methods are :meth:`~object.__get__`, :"
+"meth:`~object.__set__`, and :meth:`~object.__delete__`.  If any of those "
+"methods are defined for an attribute, it is said to be a :term:`descriptor`."
 msgstr ""
 
 #: ../../howto/descriptor.rst:508
@@ -741,10 +736,10 @@ msgstr ""
 #: ../../howto/descriptor.rst:517
 msgid ""
 "Descriptors are a powerful, general purpose protocol.  They are the "
-"mechanism behind properties, methods, static methods, class methods, "
-"and :func:`super`.  They are used throughout Python itself.  Descriptors "
-"simplify the underlying C code and offer a flexible set of new tools for "
-"everyday Python programs."
+"mechanism behind properties, methods, static methods, class methods, and :"
+"func:`super`.  They are used throughout Python itself.  Descriptors simplify "
+"the underlying C code and offer a flexible set of new tools for everyday "
+"Python programs."
 msgstr ""
 
 #: ../../howto/descriptor.rst:525
@@ -773,9 +768,9 @@ msgstr ""
 #: ../../howto/descriptor.rst:537
 msgid ""
 "If an object defines :meth:`~object.__set__` or :meth:`~object.__delete__`, "
-"it is considered a data descriptor.  Descriptors that only "
-"define :meth:`~object.__get__` are called non-data descriptors (they are "
-"often used for methods but other uses are possible)."
+"it is considered a data descriptor.  Descriptors that only define :meth:"
+"`~object.__get__` are called non-data descriptors (they are often used for "
+"methods but other uses are possible)."
 msgstr ""
 
 #: ../../howto/descriptor.rst:542
@@ -790,10 +785,9 @@ msgstr ""
 #: ../../howto/descriptor.rst:548
 msgid ""
 "To make a read-only data descriptor, define both :meth:`~object.__get__` "
-"and :meth:`~object.__set__` with the :meth:`~object.__set__` raising "
-"an :exc:`AttributeError` when called.  Defining the :meth:`~object.__set__` "
-"method with an exception raising placeholder is enough to make it a data "
-"descriptor."
+"and :meth:`~object.__set__` with the :meth:`~object.__set__` raising an :exc:"
+"`AttributeError` when called.  Defining the :meth:`~object.__set__` method "
+"with an exception raising placeholder is enough to make it a data descriptor."
 msgstr ""
 
 #: ../../howto/descriptor.rst:555
@@ -802,8 +796,8 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:557
 msgid ""
-"A descriptor can be called directly with ``desc.__get__(obj)`` or "
-"``desc.__get__(None, cls)``."
+"A descriptor can be called directly with ``desc.__get__(obj)`` or ``desc."
+"__get__(None, cls)``."
 msgstr ""
 
 #: ../../howto/descriptor.rst:560
@@ -840,8 +834,8 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:580
 msgid ""
-"If a descriptor is found for ``a.x``, then it is invoked with: "
-"``desc.__get__(a, type(a))``."
+"If a descriptor is found for ``a.x``, then it is invoked with: ``desc."
+"__get__(a, type(a))``."
 msgstr ""
 
 #: ../../howto/descriptor.rst:583
@@ -881,19 +875,18 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:722
 msgid ""
-"Note, there is no :meth:`~object.__getattr__` hook in "
-"the :meth:`~object.__getattribute__` code.  That is why "
-"calling :meth:`~object.__getattribute__` directly or with "
-"``super().__getattribute__`` will bypass :meth:`~object.__getattr__` "
-"entirely."
+"Note, there is no :meth:`~object.__getattr__` hook in the :meth:`~object."
+"__getattribute__` code.  That is why calling :meth:`~object."
+"__getattribute__` directly or with ``super().__getattribute__`` will bypass :"
+"meth:`~object.__getattr__` entirely."
 msgstr ""
 
 #: ../../howto/descriptor.rst:726
 msgid ""
 "Instead, it is the dot operator and the :func:`getattr` function that are "
-"responsible for invoking :meth:`~object.__getattr__` "
-"whenever :meth:`~object.__getattribute__` raises an :exc:`AttributeError`.  "
-"Their logic is encapsulated in a helper function:"
+"responsible for invoking :meth:`~object.__getattr__` whenever :meth:`~object."
+"__getattribute__` raises an :exc:`AttributeError`.  Their logic is "
+"encapsulated in a helper function:"
 msgstr ""
 
 #: ../../howto/descriptor.rst:731
@@ -922,10 +915,10 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:778
 msgid ""
-"The logic for a dotted lookup such as ``A.x`` is in :meth:`!"
-"type.__getattribute__`.  The steps are similar to those for :meth:`!"
-"object.__getattribute__` but the instance dictionary lookup is replaced by a "
-"search through the class's :term:`method resolution order`."
+"The logic for a dotted lookup such as ``A.x`` is in :meth:`!type."
+"__getattribute__`.  The steps are similar to those for :meth:`!object."
+"__getattribute__` but the instance dictionary lookup is replaced by a search "
+"through the class's :term:`method resolution order`."
 msgstr ""
 
 #: ../../howto/descriptor.rst:783
@@ -934,8 +927,8 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:785
 msgid ""
-"The full C implementation can be found in :c:func:`!type_getattro` "
-"and :c:func:`!_PyType_Lookup` in :source:`Objects/typeobject.c`."
+"The full C implementation can be found in :c:func:`!type_getattro` and :c:"
+"func:`!_PyType_Lookup` in :source:`Objects/typeobject.c`."
 msgstr ""
 
 #: ../../howto/descriptor.rst:790
@@ -944,23 +937,22 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:792
 msgid ""
-"The logic for super's dotted lookup is in "
-"the :meth:`~object.__getattribute__` method for object returned "
-"by :func:`super`."
+"The logic for super's dotted lookup is in the :meth:`~object."
+"__getattribute__` method for object returned by :func:`super`."
 msgstr ""
 
 #: ../../howto/descriptor.rst:795
 msgid ""
-"A dotted lookup such as ``super(A, obj).m`` searches "
-"``obj.__class__.__mro__`` for the base class ``B`` immediately following "
-"``A`` and then returns ``B.__dict__['m'].__get__(obj, A)``.  If not a "
-"descriptor, ``m`` is returned unchanged."
+"A dotted lookup such as ``super(A, obj).m`` searches ``obj.__class__."
+"__mro__`` for the base class ``B`` immediately following ``A`` and then "
+"returns ``B.__dict__['m'].__get__(obj, A)``.  If not a descriptor, ``m`` is "
+"returned unchanged."
 msgstr ""
 
 #: ../../howto/descriptor.rst:800
 msgid ""
-"The full C implementation can be found in :c:func:`!super_getattro` "
-"in :source:`Objects/typeobject.c`.  A pure Python equivalent can be found in "
+"The full C implementation can be found in :c:func:`!super_getattro` in :"
+"source:`Objects/typeobject.c`.  A pure Python equivalent can be found in "
 "`Guido's Tutorial <https://www.python.org/download/releases/2.2.3/descrintro/"
 "#cooperation>`_."
 msgstr ""
@@ -971,9 +963,9 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:809
 msgid ""
-"The mechanism for descriptors is embedded in "
-"the :meth:`~object.__getattribute__` methods "
-"for :class:`object`, :class:`type`, and :func:`super`."
+"The mechanism for descriptors is embedded in the :meth:`~object."
+"__getattribute__` methods for :class:`object`, :class:`type`, and :func:"
+"`super`."
 msgstr ""
 
 #: ../../howto/descriptor.rst:812
@@ -986,8 +978,8 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:816
 msgid ""
-"Classes inherit this machinery from :class:`object`, :class:`type`, "
-"or :func:`super`."
+"Classes inherit this machinery from :class:`object`, :class:`type`, or :func:"
+"`super`."
 msgstr ""
 
 #: ../../howto/descriptor.rst:819
@@ -1046,8 +1038,8 @@ msgstr "ORM 範例"
 #: ../../howto/descriptor.rst:853
 msgid ""
 "The following code is a simplified skeleton showing how data descriptors "
-"could be used to implement an `object relational mapping <https://"
-"en.wikipedia.org/wiki/Object%E2%80%93relational_mapping>`_."
+"could be used to implement an `object relational mapping <https://en."
+"wikipedia.org/wiki/Object%E2%80%93relational_mapping>`_."
 msgstr ""
 
 #: ../../howto/descriptor.rst:857
@@ -1091,9 +1083,9 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:876
 msgid ""
-"We can use the :class:`!Field` class to define `models <https://"
-"en.wikipedia.org/wiki/Database_model>`_ that describe the schema for each "
-"table in a database:"
+"We can use the :class:`!Field` class to define `models <https://en.wikipedia."
+"org/wiki/Database_model>`_ that describe the schema for each table in a "
+"database:"
 msgstr ""
 
 #: ../../howto/descriptor.rst:880
@@ -1350,10 +1342,10 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:1189
 msgid ""
-"To support automatic creation of methods, functions include "
-"the :meth:`~object.__get__` method for binding methods during attribute "
-"access.  This means that functions are non-data descriptors that return "
-"bound methods during dotted lookup from an instance.  Here's how it works:"
+"To support automatic creation of methods, functions include the :meth:"
+"`~object.__get__` method for binding methods during attribute access.  This "
+"means that functions are non-data descriptors that return bound methods "
+"during dotted lookup from an instance.  Here's how it works:"
 msgstr ""
 
 #: ../../howto/descriptor.rst:1194
@@ -1405,9 +1397,8 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:1233
 msgid ""
-"Accessing the function through the class dictionary does not "
-"invoke :meth:`~object.__get__`.  Instead, it just returns the underlying "
-"function object::"
+"Accessing the function through the class dictionary does not invoke :meth:"
+"`~object.__get__`.  Instead, it just returns the underlying function object::"
 msgstr ""
 
 #: ../../howto/descriptor.rst:1236
@@ -1544,10 +1535,10 @@ msgstr ""
 #: ../../howto/descriptor.rst:1293
 msgid ""
 "Static methods return the underlying function without changes.  Calling "
-"either ``c.f`` or ``C.f`` is the equivalent of a direct lookup into "
-"``object.__getattribute__(c, \"f\")`` or ``object.__getattribute__(C, "
-"\"f\")``. As a result, the function becomes identically accessible from "
-"either an object or a class."
+"either ``c.f`` or ``C.f`` is the equivalent of a direct lookup into ``object."
+"__getattribute__(c, \"f\")`` or ``object.__getattribute__(C, \"f\")``. As a "
+"result, the function becomes identically accessible from either an object or "
+"a class."
 msgstr ""
 
 #: ../../howto/descriptor.rst:1299
@@ -1600,8 +1591,8 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:1328
 msgid ""
-"Using the non-data descriptor protocol, a pure Python version "
-"of :func:`staticmethod` would look like this:"
+"Using the non-data descriptor protocol, a pure Python version of :func:"
+"`staticmethod` would look like this:"
 msgstr ""
 
 #: ../../howto/descriptor.rst:1331
@@ -1626,9 +1617,9 @@ msgstr ""
 msgid ""
 "The :func:`functools.update_wrapper` call adds a ``__wrapped__`` attribute "
 "that refers to the underlying function.  Also it carries forward the "
-"attributes necessary to make the wrapper look like the wrapped "
-"function: :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__`, "
-"and :attr:`~function.__annotations__`."
+"attributes necessary to make the wrapper look like the wrapped function: :"
+"attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function."
+"__doc__`, and :attr:`~function.__annotations__`."
 msgstr ""
 
 #: ../../howto/descriptor.rst:1417
@@ -1707,8 +1698,8 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:1464
 msgid ""
-"Using the non-data descriptor protocol, a pure Python version "
-"of :func:`classmethod` would look like this:"
+"Using the non-data descriptor protocol, a pure Python version of :func:"
+"`classmethod` would look like this:"
 msgstr ""
 
 #: ../../howto/descriptor.rst:1467
@@ -1733,9 +1724,9 @@ msgid ""
 "The :func:`functools.update_wrapper` call in ``ClassMethod`` adds a "
 "``__wrapped__`` attribute that refers to the underlying function.  Also it "
 "carries forward the attributes necessary to make the wrapper look like the "
-"wrapped "
-"function: :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__`, "
-"and :attr:`~function.__annotations__`."
+"wrapped function: :attr:`~function.__name__`, :attr:`~function."
+"__qualname__`, :attr:`~function.__doc__`, and :attr:`~function."
+"__annotations__`."
 msgstr ""
 
 #: ../../howto/descriptor.rst:1538