docs: mock 翻譯

ken71301 · ken71301 · commit e392522a16d4 · 2023-10-10T21:59:59.000+08:00
from rst:652 to 817
diff --git a/library/unittest.mock.po b/library/unittest.mock.po
@@ -8,7 +8,7 @@ msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2023-07-22 00:04+0000\n"
-"PO-Revision-Date: 2023-09-27 00:27+0800\n"
+"PO-Revision-Date: 2023-10-10 21:59+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -17,7 +17,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
-"X-Generator: Poedit 3.3.2\n"
+"X-Generator: Poedit 3.4\n"
 
 #: ../../library/unittest.mock.rst:3
 msgid ":mod:`unittest.mock` --- mock object library"
@@ -670,46 +670,61 @@ 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:674
 msgid ""
 "Members of :attr:`call_args_list` are :data:`call` objects. These can be "
 "unpacked as tuples to get at the individual arguments. See :ref:`calls as "
 "tuples <calls-as-tuples>`."
 msgstr ""
+":attr:`call_args_list` 的成員都是 :data:`call` 物件。這些物件可以被拆包為元"
+"組，以取得各個引數。參見 :ref:`calls as tuples <calls-as-tuples>`。"
 
 #: ../../library/unittest.mock.rst:681
 msgid ""
 "As well as tracking calls to themselves, mocks also track calls to methods "
 "and attributes, and *their* methods and attributes:"
 msgstr ""
+"除了追蹤對自身的呼叫之外，mock 還會追蹤對方法和屬性的呼降，以及*它們（這些方"
+"法和屬性）*的方法和屬性："
 
 #: ../../library/unittest.mock.rst:692
 msgid ""
 "Members of :attr:`method_calls` are :data:`call` objects. These can be "
 "unpacked as tuples to get at the individual arguments. See :ref:`calls as "
 "tuples <calls-as-tuples>`."
 msgstr ""
+":attr:`method_calls` 的成員都是 :data:`call` 物件。這些物件可以拆包為元組，以"
+"取得各個引數。參見 :ref:`calls as tuples <calls-as-tuples>`。"
 
 #: ../../library/unittest.mock.rst:699
 msgid ""
 ":attr:`mock_calls` records *all* calls to the mock object, its methods, "
 "magic methods *and* return value mocks."
 msgstr ""
+":attr:`mock_calls` 記錄了 *所有* 對 mock 物件的呼叫，包含其方法、魔術方法以及"
+"回傳值 mock。"
 
 #: ../../library/unittest.mock.rst:717
 msgid ""
 "Members of :attr:`mock_calls` are :data:`call` objects. These can be "
 "unpacked as tuples to get at the individual arguments. See :ref:`calls as "
 "tuples <calls-as-tuples>`."
 msgstr ""
+":attr:`method_calls` 的成員都是 :data:`call` 物件。這些物件可以拆包為元組，以"
+"取得各個引數。參見 :ref:`calls as tuples <calls-as-tuples>`。"
 
 #: ../../library/unittest.mock.rst:723
 msgid ""
 "The way :attr:`mock_calls` are recorded means that where nested calls are "
 "made, the parameters of ancestor calls are not recorded and so will always "
 "compare equal:"
 msgstr ""
+":attr:`mock_calls` 記錄的方式意味著在進行嵌套呼叫時，上代 (ancestor) 呼叫的參"
+"數不會被記錄，因此在比較時它們將始終相等："
 
 #: ../../library/unittest.mock.rst:737
 msgid ""
@@ -718,31 +733,42 @@ msgid ""
 "instead. This allows mock objects to pass :func:`isinstance` tests for the "
 "object they are replacing / masquerading as:"
 msgstr ""
+"通常，物件的 :attr:`__class__` 屬性會回傳它的型別。但對於擁有 :attr:`spec` "
+"的 mock 物件，``__class__`` 會回傳 spec 的類別。這允許 mock 物件通過對它們所"
+"替代或偽裝的物件進行的 :func:`isinstance` 測試："
 
 #: ../../library/unittest.mock.rst:746
 msgid ""
 ":attr:`__class__` is assignable to, this allows a mock to pass an :func:"
 "`isinstance` check without forcing you to use a spec:"
 msgstr ""
+":attr:`__class__` 可以被指定，這允許 mock 通過 :func:`isinstance` 檢查，而不"
+"需要強制使用 spec："
 
 #: ../../library/unittest.mock.rst:756
 msgid ""
 "A non-callable version of :class:`Mock`. The constructor parameters have the "
 "same meaning of :class:`Mock`, with the exception of *return_value* and "
 "*side_effect* which have no meaning on a non-callable mock."
 msgstr ""
+":class:`Mock` 的一個不可呼叫版本。建構函式參數的意義與 :class:`Mock` 相同，其"
+"例外為 *return_value* 和 *side_effect* 在不可呼叫的 mock 上無意義。"
 
 #: ../../library/unittest.mock.rst:760
 msgid ""
 "Mock objects that use a class or an instance as a :attr:`spec` or :attr:"
 "`spec_set` are able to pass :func:`isinstance` tests:"
 msgstr ""
+"使用類別或實例作為 :attr:`spec` 或 :attr:`spec_set` 的 mock 物件能夠通過 :"
+"func:`isinstance` 測試："
 
 #: ../../library/unittest.mock.rst:770
 msgid ""
 "The :class:`Mock` classes have support for mocking magic methods. See :ref:"
 "`magic methods <magic-methods>` for the full details."
 msgstr ""
+":class:`Mock` 類別支援 mock 魔術方法。細節請參考\\ :ref:`魔術方法 <magic-"
+"methods>`。"
 
 #: ../../library/unittest.mock.rst:773
 msgid ""
@@ -751,13 +777,18 @@ msgid ""
 "are passed to the constructor of the mock being created. The keyword "
 "arguments are for configuring attributes of the mock:"
 msgstr ""
+"Mock類別和 :func:`patch` 裝飾器於組態時接受任意的關鍵字引數。對於 :func:"
+"`patch` 裝飾器，這些關鍵字會傳遞給正在建立 mock 的建構函式。這些關鍵字引數用"
+"於配置 mock 的屬性："
 
 #: ../../library/unittest.mock.rst:784
 msgid ""
 "The return value and side effect of child mocks can be set in the same way, "
 "using dotted notation. As you can't use dotted names directly in a call you "
 "have to create a dictionary and unpack it using ``**``:"
 msgstr ""
+"Child mock 的回傳值和 side effect 可以使用使用點記法進行設置。由於你無法直接"
+"在呼叫中使用帶有點 (.) 的名稱，因此你必須建立一個字典並使用 ``**`` 解包："
 
 #: ../../library/unittest.mock.rst:799
 msgid ""
@@ -766,6 +797,11 @@ msgid ""
 "mock.  Therefore, it can match the actual call's arguments regardless of "
 "whether they were passed positionally or by name::"
 msgstr ""
+"在匹配對 mock 的呼叫時，使用 *spec*（或 *spec_set*）建立的可呼叫 mock 將會內"
+"省規格物件的簽名 (signature)。因此，它可以匹配實際呼叫的引數，無論它們是按位"
+"置傳遞還是按名稱傳遞：\n"
+"\n"
+"::"
 
 #: ../../library/unittest.mock.rst:812
 msgid ""
@@ -774,10 +810,16 @@ msgid ""
 "assert_any_call`.  When :ref:`auto-speccing`, it will also apply to method "
 "calls on the mock object."
 msgstr ""
+"這適用於 :meth:`~Mock.assert_called_with`、:meth:`~Mock."
+"assert_called_once_with`、:meth:`~Mock.assert_has_calls` 和 :meth:`~Mock."
+"assert_any_call`。在使用 :ref:`auto-speccing` ，它還適用於 mock 物件的方法呼"
+"叫。"
 
 #: ../../library/unittest.mock.rst:817
 msgid "Added signature introspection on specced and autospecced mock objects."
 msgstr ""
+"對於已經設置了規格（spec）和自動規格（autospec）的 mock 物件，新增簽名內省功"
+"能。"
 
 #: ../../library/unittest.mock.rst:823
 msgid ""
