docs: mock 翻譯

ken71301 · ken71301 · commit 25c3c28aa6e3 · 2023-09-27T00:27:45.000+08:00
from rst:498 to 646
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-26 00:39+0800\n"
+"PO-Revision-Date: 2023-09-27 00:27+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -554,31 +554,33 @@ msgstr "對於不可呼叫的 mock，將使用可呼叫的變體，而不是任
 
 #: ../../library/unittest.mock.rst:498
 msgid "A boolean representing whether or not the mock object has been called:"
-msgstr ""
+msgstr "一個 boolean（布林），表述 mock 物件是否已經被呼叫："
 
 #: ../../library/unittest.mock.rst:509
 msgid "An integer telling you how many times the mock object has been called:"
-msgstr ""
+msgstr "一個整數，告訴你 mock 物件被呼叫的次數："
 
 #: ../../library/unittest.mock.rst:521
 msgid "Set this to configure the value returned by calling the mock:"
-msgstr ""
+msgstr "設定此值以配置呼叫 mock 時回傳的值："
 
 #: ../../library/unittest.mock.rst:528
 msgid ""
 "The default return value is a mock object and you can configure it in the "
 "normal way:"
-msgstr ""
+msgstr "預設的回傳值是一個 mock 物件，你也可以按照正常的方式配置它："
 
 #: ../../library/unittest.mock.rst:537
 msgid ":attr:`return_value` can also be set in the constructor:"
-msgstr ""
+msgstr ":attr:`return_value` 也可以在建構函式中設定："
 
 #: ../../library/unittest.mock.rst:548
 msgid ""
 "This can either be a function to be called when the mock is called, an "
 "iterable or an exception (class or instance) to be raised."
 msgstr ""
+"這可以是一個在呼叫 mock 時要呼叫的函式、一個可疊代物件，或者要引發的例外（類"
+"別或實例）。"
 
 #: ../../library/unittest.mock.rst:551
 msgid ""
@@ -588,6 +590,10 @@ msgid ""
 "returns :data:`DEFAULT` then the mock will return its normal value (from "
 "the :attr:`return_value`)."
 msgstr ""
+"如果你傳遞一個函式，它將被呼叫，其引數與 mock 相同，且除非該函式回傳 :data:"
+"`DEFAULT` 單例 (singleton)，否則對 mock 的呼叫將回傳函式回傳的任何值。如果函"
+"式回傳 :data:`DEFAULT`，那麼 mock 將回傳其正常的回傳值（從 :attr:"
+"`return_value` 得到）。"
 
 #: ../../library/unittest.mock.rst:557
 msgid ""
@@ -596,30 +602,35 @@ msgid ""
 "to be raised, or a value to be returned from the call to the mock (:data:"
 "`DEFAULT` handling is identical to the function case)."
 msgstr ""
+"如果你傳遞一個可疊代物件，它將被用於檢索一個疊代器，該疊代器必須在每次呼叫時"
+"產出 (yield) 一個值。這個值可以是要引發的例外實例，或者是對 mock 呼叫時要回傳"
+"的值（處理 :data:`DEFAULT` 的方式與函式的狀況相同）。"
 
 #: ../../library/unittest.mock.rst:562
 msgid ""
 "An example of a mock that raises an exception (to test exception handling of "
 "an API):"
-msgstr ""
+msgstr "以下是一個引發例外的 mock 的範例（用於測試 API 的例外處理）："
 
 #: ../../library/unittest.mock.rst:572
 msgid "Using :attr:`side_effect` to return a sequence of values:"
-msgstr ""
+msgstr "使用 :attr:`side_effect` 回傳一連串值的範例："
 
 #: ../../library/unittest.mock.rst:579
 msgid "Using a callable:"
-msgstr ""
+msgstr "使用可被呼叫物件的範例："
 
 #: ../../library/unittest.mock.rst:589
 msgid ""
 ":attr:`side_effect` can be set in the constructor. Here's an example that "
 "adds one to the value the mock is called with and returns it:"
 msgstr ""
+":attr:`side_effect` 可以在建構函式中設定。以下是一個範例，它將 mock 被呼叫時"
+"給的值加一並回傳："
 
 #: ../../library/unittest.mock.rst:599
 msgid "Setting :attr:`side_effect` to ``None`` clears it:"
-msgstr ""
+msgstr "將 :attr:`side_effect` 設定為 ``None`` 可以清除它："
 
 #: ../../library/unittest.mock.rst:613
 msgid ""
@@ -630,6 +641,10 @@ msgid ""
 "second member, which can also be accessed through the ``kwargs`` property, "
 "is any keyword arguments (or an empty dictionary)."
 msgstr ""
+"這會是 ``None``（如果 mock 尚未被呼叫），或是 mock 上次被呼叫時使用的引數。這"
+"將以元組的形式呈現：第一個構件 (member)，其可以通過 ``args`` 屬性訪問，是 "
+"mock 被呼叫時傳遞的所有有序引數（或一個空元組）。第二個構件，其可以通過 "
+"``kwargs`` 屬性訪問，是所有關鍵字引數（或一個空字典）。"
 
 #: ../../library/unittest.mock.rst:646
 msgid ""
@@ -638,6 +653,10 @@ 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:`calls as tuples <calls-as-"
+"tuples>`。"
 
 #: ../../library/unittest.mock.rst:652
 msgid "Added ``args`` and ``kwargs`` properties."
