[po] auto sync

github-actions[bot] · github-actions[bot] · commit 97b7acd89a28 · 2022-04-25T02:29:58.000Z
diff --git a/howto/clinic.po b/howto/clinic.po
@@ -10,8 +10,8 @@
 # telnetning <telnetning@gmail.com>, 2020
 # Alpha Du <alphanow@gmail.com>, 2020
 # ppcfish <ppcfish@gmail.com>, 2020
-# Freesand Leo <yuqinju@163.com>, 2022
 # Dai Xu <daixu61@hotmail.com>, 2022
+# Freesand Leo <yuqinju@163.com>, 2022
 # 
 #, fuzzy
 msgid ""
@@ -20,7 +20,7 @@ msgstr ""
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2021-01-01 16:06+0000\n"
 "PO-Revision-Date: 2020-05-30 11:54+0000\n"
-"Last-Translator: Dai Xu <daixu61@hotmail.com>, 2022\n"
+"Last-Translator: Freesand Leo <yuqinju@163.com>, 2022\n"
 "Language-Team: Chinese (China) (https://www.transifex.com/python-doc/teams/5390/zh_CN/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -695,41 +695,41 @@ msgstr ""
 msgid ""
 "The default value you provide for a parameter can't be any arbitrary "
 "expression.  Currently the following are explicitly supported:"
-msgstr ""
+msgstr "提供给参数的默认值不能是表达式。目前明确支持以下形式："
 
 #: ../../howto/clinic.rst:564
 msgid "Numeric constants (integer and float)"
-msgstr ""
+msgstr "数值型常数（整数和浮点数）。"
 
 #: ../../howto/clinic.rst:565
 msgid "String constants"
 msgstr "字符串常量"
 
 #: ../../howto/clinic.rst:566
 msgid "``True``, ``False``, and ``None``"
-msgstr ""
+msgstr "``True`` 、 ``False`` 和 ``None`` 。"
 
 #: ../../howto/clinic.rst:567
 msgid ""
 "Simple symbolic constants like ``sys.maxsize``, which must start with the "
 "name of the module"
-msgstr ""
+msgstr "以模块名开头的简单符号常量，如 ``sys.maxsize``。"
 
 #: ../../howto/clinic.rst:570
 msgid ""
 "In case you're curious, this is implemented in  ``from_builtin()`` in "
 "``Lib/inspect.py``."
-msgstr ""
+msgstr "如果你感到好奇，这是在  ``from_builtin()`` ( ``Lib/inspect.py``) 中实现的。"
 
 #: ../../howto/clinic.rst:573
 msgid ""
 "(In the future, this may need to get even more elaborate, to allow full "
 "expressions like ``CONSTANT - 1``.)"
-msgstr ""
+msgstr "（未来可能需要加以细化，以便可以采用 ``CONSTANT - 1`` 之类的完整表达式。）"
 
 #: ../../howto/clinic.rst:578
 msgid "Renaming the C functions and variables generated by Argument Clinic"
-msgstr ""
+msgstr "对 Argument Clinic 生成的 C 函数和变量进行重命名"
 
 #: ../../howto/clinic.rst:580
 msgid ""
@@ -742,18 +742,21 @@ msgid ""
 "function, then add ``\"_impl\"`` to the end and use that for the name of the"
 " impl function."
 msgstr ""
+"Argument Clinic 会自动为其生成的函数命名。如果生成的名称与现有的 C 函数冲突，这偶尔可能会造成问题，有一个简单的解决方案：覆盖 C "
+"函数的名称。只要在函数声明中加入关键字 ``\"as\"`` ，然后再加上要使用的函数名。Argument Clinic "
+"将以该函数名为基础作为（生成的）函数名，然后在后面加上 ``\"_impl\"``，并用作导入函数的名称。"
 
 #: ../../howto/clinic.rst:588
 msgid ""
 "For example, if we wanted to rename the C function names generated for "
 "``pickle.Pickler.dump``, it'd look like this::"
-msgstr ""
+msgstr "例如，若对 ``pickle.Pickler.dump`` 生成的 C 函数进行重命名，应如下所示："
 
 #: ../../howto/clinic.rst:596
 msgid ""
 "The base function would now be named ``pickler_dumper()``, and the impl "
 "function would now be named ``pickler_dumper_impl()``."
-msgstr ""
+msgstr "原函数会被命名为 ``pickler_dumper()``，而实现函数现在被命名为``pickler_dumper_impl()``。"
 
 #: ../../howto/clinic.rst:600
 msgid ""
@@ -762,20 +765,23 @@ msgid ""
 "Clinic allows you to give a parameter different names in Python and in C, "
 "using the same ``\"as\"`` syntax::"
 msgstr ""
+"同样的问题依然会出现：想给某个参数取个 Python 用名，但在 C 语言中可能用不了。Argument Clinic 允许在 Python 和 C "
+"中为同一个参数取不同的名字，语法依然是利用 ``\"as\"`` ："
 
 #: ../../howto/clinic.rst:614
 msgid ""
 "Here, the name used in Python (in the signature and the ``keywords`` array) "
 "would be ``file``, but the C variable would be named ``file_obj``."
 msgstr ""
+"这里 Python（签名和 ``keywords`` 数组中）中用的名称是 ``file``，而 C 语言中的变量命名为 ``file_obj``。"
 
 #: ../../howto/clinic.rst:617
 msgid "You can use this to rename the ``self`` parameter too!"
-msgstr ""
+msgstr "``self`` 参数也可以进行重命名。"
 
 #: ../../howto/clinic.rst:621
 msgid "Converting functions using PyArg_UnpackTuple"
-msgstr ""
+msgstr "利用 PyArg_UnpackTuple 对函数进行转换"
 
 #: ../../howto/clinic.rst:623
 msgid ""
@@ -785,16 +791,18 @@ msgid ""
 "type as appropriate.  All arguments should be marked positional-only (add a "
 "``/`` on a line by itself after the last argument)."
 msgstr ""
+"若要将函数转换为采用 :c:func:`PyArg_UnpackTuple` 解析其参数，只需写出所有参数，并将每个参数定义为 "
+"``object``。可以指定 ``type`` 参数，以便能转换为合适的类型。所有参数都应标记为只认位置（在最后一个参数后面加上 ``/``）。"
 
 #: ../../howto/clinic.rst:629
 msgid ""
 "Currently the generated code will use :c:func:`PyArg_ParseTuple`, but this "
 "will change soon."
-msgstr ""
+msgstr "目前，所生成的代码将会用到 :c:func:`PyArg_ParseTuple` ，但很快会做出改动。"
 
 #: ../../howto/clinic.rst:633
 msgid "Optional Groups"
-msgstr ""
+msgstr "可选参数组"
 
 #: ../../howto/clinic.rst:635
 msgid ""
@@ -806,6 +814,9 @@ msgid ""
 "optional arguments back before :c:func:`PyArg_ParseTupleAndKeywords` was "
 "created."
 msgstr ""
+"有些过时的函数用到了一种让人头疼的函数解析方式：计算位置参数的数量，据此用 ``switch`` 语句进行各个不同的 "
+":c:func:`PyArg_ParseTuple` 调用。（这些函数不能接受只认关键字的参数。）在没有 "
+":c:func:`PyArg_ParseTupleAndKeywords` 之前，这种方式曾被用于模拟可选参数。"
 
 #: ../../howto/clinic.rst:642
 msgid ""
@@ -820,6 +831,11 @@ msgid ""
 " ``y``; if you call the function passing in ``x``, you must also pass in "
 "``y``—and if you don't pass in ``x`` you may not pass in ``y`` either.)"
 msgstr ""
+"虽然这种函数通常可以转换为采用  :c:func:`PyArg_ParseTupleAndKeywords` "
+"、可选参数和默认值的方式，但并不是全都可以做到。这些过时函数中， :c:func:`PyArg_ParseTupleAndKeywords` "
+"并不能直接支持某些功能。最明显的例子是内置函数 ``range()``，它的必需参数的 *左* 边存在一个可选参数！另一个例子是 "
+"``curses.window.addch()``，它的两个参数是一组，必须同时指定。（参数名为 ``x`` 和 ``y``；如果调用函数时传入了 "
+"``x``，则必须同时传入``y``；如果未传入 ``x`` ，则也不能传入 ``y``）。"
 
 #: ../../howto/clinic.rst:654
 msgid ""
@@ -831,6 +847,9 @@ msgid ""
 "required arguments.  They can *only* be used with positional-only "
 "parameters."
 msgstr ""
+"不管怎么说，Argument Clinic 的目标就是在不改变语义的情况下支持所有现有 CPython 内置参数的解析。因此，Argument "
+"Clinic 采用所谓的 *可选组* 方案来支持这种解析方式。可选组是必须一起传入的参数组。他们可以在必需参数的左边或右边，*只能* "
+"用于只认位置的参数。"
 
 #: ../../howto/clinic.rst:662
 msgid ""
@@ -842,6 +861,9 @@ msgid ""
 "doesn't understand the concept.  Please avoid using optional groups wherever"
 " possible."
 msgstr ""
+"可选组 *仅* 适用于多次调用 :c:func:`PyArg_ParseTuple` 的函数！采用 *任何* 其他方式解析参数的函数，应该 *几乎不* "
+"采用可选组转换为 Argument Clinic 解析。目前，采用可选组的函数在 Python 中无法获得准确的签名，因为 Python "
+"不能理解这个概念。请尽可能避免使用可选组。"
 
 #: ../../howto/clinic.rst:671
 msgid ""
@@ -851,6 +873,8 @@ msgid ""
 "optional groups to make the first two parameters and the last parameter "
 "optional::"
 msgstr ""
+"若要定义可选组，可在要分组的参数前面加上 ``[``，在这些参数后加上``]`` ，要在同一行上。举个例子，下面是 "
+"``curses.window.addch`` 采用可选组的用法，前两个参数和最后一个参数可选："
 
 #: ../../howto/clinic.rst:700
 msgid "Notes:"
@@ -868,22 +892,26 @@ msgid ""
 "was unused, and set to non-zero if this group was used. (By used or unused, "
 "I mean whether or not the parameters received arguments in this invocation.)"
 msgstr ""
+"每一个可选组，都会额外传入一个代表分组的参数。 参数为 int 型，名为 ``group_{direction}_{number}``，其中 "
+"``{direction}`` 取决于此参数组位于必需参数 ``right`` 还是 ``left``，而 ``{number}`` 是一个递增数字（从"
+" 1 开始），表示此参数组与必需参数之间的距离。 在调用函数时，若未用到此参数组则此参数将设为零，若用到了参数组则该参数为非零。 "
+"所谓的用到或未用到，是指在本次调用中形参是否收到了实参。"
 
 #: ../../howto/clinic.rst:713
 msgid ""
 "If there are no required arguments, the optional groups will behave as if "
 "they're to the right of the required arguments."
-msgstr ""
+msgstr "如果不存在必需参数，可选组的行为等同于出现在必需参数的右侧。"
 
 #: ../../howto/clinic.rst:716
 msgid ""
 "In the case of ambiguity, the argument parsing code favors parameters on the"
 " left (before the required parameters)."
-msgstr ""
+msgstr "在模棱两可的情况下，参数解析代码更倾向于参数左侧（在必需参数之前）。"
 
 #: ../../howto/clinic.rst:719
 msgid "Optional groups can only contain positional-only parameters."
-msgstr ""
+msgstr "可选组只能包含只认位置的参数。"
 
 #: ../../howto/clinic.rst:721
 msgid ""
diff --git a/library/unittest.mock.po b/library/unittest.mock.po
@@ -584,7 +584,7 @@ msgstr ":attr:`side_effect` 可以在构造器中设置。 下面是在 mock 被
 
 #: ../../library/unittest.mock.rst:597
 msgid "Setting :attr:`side_effect` to ``None`` clears it:"
-msgstr ""
+msgstr "将 :attr:`side_effect` 设为 ``None`` 可以清除它:"
 
 #: ../../library/unittest.mock.rst:611
 msgid ""
@@ -595,6 +595,9 @@ msgid ""
 "second member, which can also be accessed through the ``kwargs`` property, "
 "is any keyword arguments (or an empty dictionary)."
 msgstr ""
+"这可以是 ``None`` (如果 mock 没有被调用)，或是 mock 最近一次被调用时附带的参数。 这将采用元组的形式：第一个成员也可以通过 "
+"``args`` 特征属性来访问，它是 mock 被调用时所附带的任何位置参数 (或为空元组)，而第二个成员也可以通过 ``kwargs`` "
+"特征属性来访问，它则是任何关键字参数 (或为空字典)。"
 
 #: ../../library/unittest.mock.rst:644
 msgid ""
@@ -603,10 +606,13 @@ msgid ""
 "are tuples, so they can be unpacked to get at the individual arguments and "
 "make more complex assertions. See :ref:`calls as tuples <calls-as-tuples>`."
 msgstr ""
+":attr:`call_args`，以及列表 :attr:`call_args_list`, :attr:`method_calls` 和 "
+":attr:`mock_calls` 的成员都是 :data:`call` 对象。 "
+"这些对象属性元组，因此它们可被解包以获得单独的参数并创建更复杂的断言。 参见 :ref:`作为元组的 call <calls-as-tuples>`。"
 
 #: ../../library/unittest.mock.rst:650
 msgid "Added ``args`` and ``kwargs`` properties."
-msgstr ""
+msgstr "增加了 ``args`` 和 ``kwargs`` 特征属性。properties."
 
 #: ../../library/unittest.mock.rst:656
 msgid ""
@@ -616,6 +622,8 @@ msgid ""
 "used for conveniently constructing lists of calls to compare with "
 ":attr:`call_args_list`."
 msgstr ""
+"这是一个已排序的对 mock 对象的所有调用的列表（因此该列表的长度就是它已被调用的次数）。 在执行任何调用之前它将是一个空列表。 "
+":data:`call` 对象可以被用来方便地构造调用列表以与 :attr:`call_args_list` 相比较。"
 
 #: ../../library/unittest.mock.rst:672
 msgid ""
