python
diff --git a/‎.stat.json
Lines changed: 1 addition & 1 deletion b/‎.stat.json
Lines changed: 1 addition & 1 deletion
diff --git a/‎howto/descriptor.po
Lines changed: 117 additions & 5 deletions b/‎howto/descriptor.po
Lines changed: 117 additions & 5 deletions
@@ -1 +1 @@
-{"translation": "81.21%", "updated_at": "2025-02-14T15:46:03Z"}
+{"translation": "81.31%", "updated_at": "2025-02-14T18:47:45Z"}
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-07 14:52+0000\n"
+"POT-Creation-Date: 2025-02-14 14:53+0000\n"
 "PO-Revision-Date: 2024-05-11 00:32+0000\n"
 "Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n"
 "Language-Team: Chinese (China) (https://app.transifex.com/python-doc/teams/5390/zh_CN/)\n"
@@ -994,6 +994,9 @@ msgid ""
 "method with an exception raising placeholder is enough to make it a data "
 "descriptor."
 msgstr ""
+"为了使一个数据描述器只读，应同时定义 :meth:`~object.__get__` 和 :meth:`~object.__set__` 并在调用 "
+":meth:`~object.__set__` 时引发 :exc:`AttributeError`。 用引发异常的占位符定义 "
+":meth:`~object.__set__` 方法就足以使其成为一个数据描述器。"
 
 #: ../../howto/descriptor.rst:552
 msgid "Overview of descriptor invocation"
@@ -1038,6 +1041,8 @@ msgid ""
 "descriptors, then class variables, and lastly :meth:`~object.__getattr__` if"
 " it is provided."
 msgstr ""
+"实例查找会扫描命名空间链并给予数据描述器最高的优先级，然后是实例变量，然后是非数据描述器，最后是 "
+":meth:`~object.__getattr__`，如果有提供的话。"
 
 #: ../../howto/descriptor.rst:577
 msgid ""
@@ -1111,6 +1116,9 @@ msgid ""
 "``super().__getattribute__`` will bypass :meth:`~object.__getattr__` "
 "entirely."
 msgstr ""
+"注意，在 :meth:`~object.__getattribute__` 代码中没有 :meth:`~object.__getattr__` 钩子。 "
+"这就是为什么直接调用 :meth:`~object.__getattribute__` 或用 ``super().__getattribute__`` "
+"会彻底绕过 :meth:`~object.__getattr__`。"
 
 #: ../../howto/descriptor.rst:723
 msgid ""
@@ -1119,6 +1127,8 @@ msgid ""
 ":meth:`~object.__getattribute__` raises an :exc:`AttributeError`.  Their "
 "logic is encapsulated in a helper function:"
 msgstr ""
+"相反，一旦 :meth:`~object.__getattribute__` 引发 :exc:`AttributeError` 则将由点运算符和 "
+":func:`getattr` 函数来负责唤起 :meth:`~object.__getattr__`。 它们的逻辑封装在一个辅助函数中："
 
 #: ../../howto/descriptor.rst:728
 msgid ""
@@ -1267,6 +1277,9 @@ msgid ""
 "called with two arguments.  The *owner* is the class where the descriptor is"
 " used, and the *name* is the class variable the descriptor was assigned to."
 msgstr ""
+"有时描述器需要知道它被赋值到哪个变量名。 当一个新类被创建时，:class:`type` 元类将扫描新类的字典。 "
+"如果其中有任何条目是描述器并且它们定义了 :meth:`~object.__set_name__`，则该方法被调用时将附带两个参数。 *owner* "
+"是使用该描述器的类，而 *name* 是该描述器被赋值到的变量。"
 
 #: ../../howto/descriptor.rst:839
 msgid ""
@@ -1282,6 +1295,8 @@ msgid ""
 "place at the time of class creation.  If descriptors are added to the class "
 "afterwards, :meth:`~object.__set_name__` will need to be called manually."
 msgstr ""
+"由于更新逻辑是在 :meth:`!type.__new__` 中，因此通知仅在类创建时发出。 之后如果将描述器添加到类中，则需要手动调用 "
+":meth:`~object.__set_name__`。"
 
 #: ../../howto/descriptor.rst:848
 msgid "ORM example"
@@ -1337,6 +1352,8 @@ msgid ""
 "<https://en.wikipedia.org/wiki/Database_model>`_ that describe the schema "
 "for each table in a database:"
 msgstr ""
+"我们可以使用 :class:`!Field` 类来定义描述了数据库中每张表的结构的 `模型 "
+"<https://en.wikipedia.org/wiki/Database_model>`_:"
 
 #: ../../howto/descriptor.rst:877
 msgid ""
@@ -1628,6 +1645,8 @@ msgid ""
 "  This means that functions are non-data descriptors that return bound "
 "methods during dotted lookup from an instance.  Here's how it works:"
 msgstr ""
+"为支持方法的自动创建，函数会包括 :meth:`~object.__get__` 方法以便在属性访问期间绑定方法。 "
+"这意味着函数就是在通过实例进行点号查找期间返回所绑定方法的非数据描述器。 其运作方式是这样的："
 
 #: ../../howto/descriptor.rst:1190
 msgid ""
@@ -1681,7 +1700,7 @@ msgid ""
 "Accessing the function through the class dictionary does not invoke "
 ":meth:`~object.__get__`.  Instead, it just returns the underlying function "
 "object::"
-msgstr ""
+msgstr "通过类字典访问函数不会唤起 :meth:`~object.__get__`。 相反，它只是返回下层的函数对象::"
 
 #: ../../howto/descriptor.rst:1220
 msgid ""
@@ -1695,7 +1714,7 @@ msgstr ""
 msgid ""
 "Dotted access from a class calls :meth:`~object.__get__` which just returns "
 "the underlying function unchanged::"
-msgstr ""
+msgstr "通过类进行点号访问调用 :meth:`~object.__get__`，它将只原样返回下层的函数::"
 
 #: ../../howto/descriptor.rst:1226
 msgid ""
@@ -1710,7 +1729,7 @@ msgid ""
 "The interesting behavior occurs during dotted access from an instance.  The "
 "dotted lookup calls :meth:`~object.__get__` which returns a bound method "
 "object::"
-msgstr ""
+msgstr "有趣的行为发生在通过实例进行点号访问期间。 点号查找调用 :meth:`~object.__get__`，它将返回绑定的方法对象::"
 
 #: ../../howto/descriptor.rst:1232
 msgid ""
@@ -1765,6 +1784,9 @@ msgid ""
 "descriptor transforms an ``obj.f(*args)`` call into ``f(obj, *args)``.  "
 "Calling ``cls.f(*args)`` becomes ``f(*args)``."
 msgstr ""
+"总结一下，函数具有 :meth:`~object.__get__` 方法以便在其作为属性被访问时可被转换为方法。 非数据描述器会将 "
+"``obj.f(*args)`` 调用转化为 ``f(obj, *args)``。 调用 ``cls.f(*args)`` 将变成 "
+"``f(*args)``。"
 
 #: ../../howto/descriptor.rst:1260
 msgid "This chart summarizes the binding and its two most useful variants:"
@@ -2289,12 +2311,47 @@ msgid ""
 "        'Emulate member_repr() in Objects/descrobject.c'\n"
 "        return f'<Member {self.name!r} of {self.clsname!r}>'"
 msgstr ""
+"null = object()\n"
+"\n"
+"class Member:\n"
+"\n"
+"    def __init__(self, name, clsname, offset):\n"
+"        'Emulate PyMemberDef in Include/structmember.h'\n"
+"        # 另请参阅 Objects/descrobject.c 中的 descr_new()\n"
+"        self.name = name\n"
+"        self.clsname = clsname\n"
+"        self.offset = offset\n"
+"\n"
+"    def __get__(self, obj, objtype=None):\n"
+"        'Emulate member_get() in Objects/descrobject.c'\n"
+"        # 另请参阅 Python/structmember.c 中的 PyMember_GetOne()\n"
+"        if obj is None:\n"
+"            return self\n"
+"        value = obj._slotvalues[self.offset]\n"
+"        if value is null:\n"
+"            raise AttributeError(self.name)\n"
+"        return value\n"
+"\n"
+"    def __set__(self, obj, value):\n"
+"        'Emulate member_set() in Objects/descrobject.c'\n"
+"        obj._slotvalues[self.offset] = value\n"
+"\n"
+"    def __delete__(self, obj):\n"
+"        'Emulate member_delete() in Objects/descrobject.c'\n"
+"        value = obj._slotvalues[self.offset]\n"
+"        if value is null:\n"
+"            raise AttributeError(self.name)\n"
+"        obj._slotvalues[self.offset] = null\n"
+"\n"
+"    def __repr__(self):\n"
+"        'Emulate member_repr() in Objects/descrobject.c'\n"
+"        return f'<Member {self.name!r} of {self.clsname!r}>'"
 
 #: ../../howto/descriptor.rst:1685
 msgid ""
 "The :meth:`!type.__new__` method takes care of adding member objects to "
 "class variables:"
-msgstr ""
+msgstr ":meth:`!type.__new__` 方法负责将成员对象添加到类变量："
 
 #: ../../howto/descriptor.rst:1688
 msgid ""
@@ -2309,6 +2366,16 @@ msgid ""
 "            mapping[name] = Member(name, clsname, offset)\n"
 "        return type.__new__(mcls, clsname, bases, mapping, **kwargs)"
 msgstr ""
+"class Type(type):\n"
+"    'Simulate how the type metaclass adds member objects for slots'\n"
+"\n"
+"    def __new__(mcls, clsname, bases, mapping, **kwargs):\n"
+"        'Emulate type_new() in Objects/typeobject.c'\n"
+"        # type_new() 将调用 PyTypeReady()，后者将调用 add_methods()\n"
+"        slot_names = mapping.get('slot_names', [])\n"
+"        for offset, name in enumerate(slot_names):\n"
+"            mapping[name] = Member(name, clsname, offset)\n"
+"        return type.__new__(mcls, clsname, bases, mapping, **kwargs)"
 
 #: ../../howto/descriptor.rst:1701
 msgid ""
@@ -2348,12 +2415,41 @@ msgid ""
 "            )\n"
 "        super().__delattr__(name)"
 msgstr ""
+"class Object:\n"
+"    'Simulate how object.__new__() allocates memory for __slots__'\n"
+"\n"
+"    def __new__(cls, *args, **kwargs):\n"
+"        'Emulate object_new() in Objects/typeobject.c'\n"
+"        inst = super().__new__(cls)\n"
+"        if hasattr(cls, 'slot_names'):\n"
+"            empty_slots = [null] * len(cls.slot_names)\n"
+"            object.__setattr__(inst, '_slotvalues', empty_slots)\n"
+"        return inst\n"
+"\n"
+"    def __setattr__(self, name, value):\n"
+"        'Emulate _PyObject_GenericSetAttrWithDict() Objects/object.c'\n"
+"        cls = type(self)\n"
+"        if hasattr(cls, 'slot_names') and name not in cls.slot_names:\n"
+"            raise AttributeError(\n"
+"                f'{cls.__name__!r} object has no attribute {name!r}'\n"
+"            )\n"
+"        super().__setattr__(name, value)\n"
+"\n"
+"    def __delattr__(self, name):\n"
+"        'Emulate _PyObject_GenericSetAttrWithDict() Objects/object.c'\n"
+"        cls = type(self)\n"
+"        if hasattr(cls, 'slot_names') and name not in cls.slot_names:\n"
+"            raise AttributeError(\n"
+"                f'{cls.__name__!r} object has no attribute {name!r}'\n"
+"            )\n"
+"        super().__delattr__(name)"
 
 #: ../../howto/descriptor.rst:1736
 msgid ""
 "To use the simulation in a real class, just inherit from :class:`!Object` "
 "and set the :term:`metaclass` to :class:`Type`:"
 msgstr ""
+"要在真实的类中使用此模拟，只需从 :class:`!Object` 继承并将 :term:`metaclass` 设为 :class:`Type`:"
 
 #: ../../howto/descriptor.rst:1739
 msgid ""
@@ -2366,6 +2462,14 @@ msgid ""
 "        self.x = x\n"
 "        self.y = y"
 msgstr ""
+"class H(Object, metaclass=Type):\n"
+"    'Instance variables stored in slots'\n"
+"\n"
+"    slot_names = ['x', 'y']\n"
+"\n"
+"    def __init__(self, x, y):\n"
+"        self.x = x\n"
+"        self.y = y"
 
 #: ../../howto/descriptor.rst:1750
 msgid ""
@@ -2383,6 +2487,14 @@ msgid ""
 " 'x': <Member 'x' of 'H'>,\n"
 " 'y': <Member 'y' of 'H'>}"
 msgstr ""
+">>> from pprint import pp\n"
+">>> pp(dict(vars(H)))\n"
+"{'__module__': '__main__',\n"
+" '__doc__': 'Instance variables stored in slots',\n"
+" 'slot_names': ['x', 'y'],\n"
+" '__init__': <function H.__init__ at 0x7fb5d302f9d0>,\n"
+" 'x': <Member 'x' of 'H'>,\n"
+" 'y': <Member 'y' of 'H'>}"
 
 #: ../../howto/descriptor.rst:1771
 msgid ""
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{"translation": "81.21%", "updated_at": "2025-02-14T15:46:03Z"}`
	`1`	`+{"translation": "81.31%", "updated_at": "2025-02-14T18:47:45Z"}`