docs: mock 翻譯

ken71301 · ken71301 · commit 2f97c31eb02c · 2023-09-26T00:41:20.000+08:00
from rst:384 to 492
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-09 23:07+0800\n"
+"PO-Revision-Date: 2023-09-26 00:39+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -253,16 +253,16 @@ msgid ""
 "class of :class:`Mock` using the *new_callable* argument to :func:`patch`."
 msgstr ""
 ":func:`patch` 裝飾器可以輕鬆地用 :class:`Mock` 物件臨時替換特定模組中的類別。"
-"預設情況下，:func:`patch` 會為你建立一個 :class:`MagicMock`。你可以使"
-"用 :func:`patch` 的 *new_callable* 引數指定 :class:`Mock` 的替代類別。"
+"預設情況下，:func:`patch` 會為你建立一個 :class:`MagicMock`。你可以使用 :"
+"func:`patch` 的 *new_callable* 引數指定 :class:`Mock` 的替代類別。"
 
 #: ../../library/unittest.mock.rst:231
 msgid ""
 "Create a new :class:`Mock` object. :class:`Mock` takes several optional "
 "arguments that specify the behaviour of the Mock object:"
 msgstr ""
-"建立一個新的 :class:`Mock` 物件。:class:`Mock` 接受數個可選的引數來指定 "
-"Mock 物件的行為："
+"建立一個新的 :class:`Mock` 物件。:class:`Mock` 接受數個可選的引數來指定 Mock "
+"物件的行為："
 
 #: ../../library/unittest.mock.rst:234
 msgid ""
@@ -428,8 +428,8 @@ msgid ""
 "assert the mock has been called with the specified calls. The :attr:"
 "`mock_calls` list is checked for the calls."
 msgstr ""
-"斷言 mock 已經使用指定的呼叫方式來呼叫。此斷言會檢查 :attr:`mock_calls` 串列中的"
-"呼叫。"
+"斷言 mock 已經使用指定的呼叫方式來呼叫。此斷言會檢查 :attr:`mock_calls` 串列"
+"中的呼叫。"
 
 #: ../../library/unittest.mock.rst:365
 msgid ""
@@ -449,15 +449,15 @@ msgstr ""
 
 #: ../../library/unittest.mock.rst:384
 msgid "Assert the mock was never called."
-msgstr ""
+msgstr "斷言 mock 從未被呼叫。"
 
 #: ../../library/unittest.mock.rst:399
 msgid "The reset_mock method resets all the call attributes on a mock object:"
-msgstr ""
+msgstr "reset_mock 方法重置 mock 物件上的所有呼叫屬性："
 
 #: ../../library/unittest.mock.rst:409
 msgid "Added two keyword-only arguments to the reset_mock function."
-msgstr ""
+msgstr "reset_mock 函式新增了兩個僅限關鍵字引數 (keyword-only arguments)。"
 
 #: ../../library/unittest.mock.rst:412
 msgid ""
@@ -468,73 +468,89 @@ msgid ""
 "`side_effect`, then pass the corresponding parameter as ``True``. Child "
 "mocks and the return value mock (if any) are reset as well."
 msgstr ""
+"這在你想要進行一系列重複使用同一物件的斷言時非常有用。請注意，預設情況下，:"
+"meth:`reset_mock` *不會* 清除回傳值、:attr:`side_effect` 或使用普通賦值設定的"
+"任何子屬性。如果你想要重置 *return_value* 或 :attr:`side_effect`，則將相應的"
+"參數設置為 ``True``。Child mock 和回傳值 mock（如果有的話）也會被重置。"
 
 #: ../../library/unittest.mock.rst:420
 msgid "*return_value*, and :attr:`side_effect` are keyword-only arguments."
-msgstr ""
+msgstr "*return_value* 和 :attr:`side_effect` 是僅限關鍵字引數。"
 
 #: ../../library/unittest.mock.rst:426
 msgid ""
 "Add a spec to a mock. *spec* can either be an object or a list of strings. "
 "Only attributes on the *spec* can be fetched as attributes from the mock."
 msgstr ""
+"向 mock 增加一個規格 (spec)。*spec* 可以是一個物件或一個字串串列 (list of "
+"strings)。只有在 *spec* 上的屬性才能作為 mock 的屬性被取得。"
 
 #: ../../library/unittest.mock.rst:430
 msgid "If *spec_set* is true then only attributes on the spec can be set."
-msgstr ""
+msgstr "如果 *spec_set* 為 true，那麼只能設定在規格中的屬性。"
 
 #: ../../library/unittest.mock.rst:435
 msgid ""
 "Attach a mock as an attribute of this one, replacing its name and parent. "
 "Calls to the attached mock will be recorded in the :attr:`method_calls` and :"
 "attr:`mock_calls` attributes of this one."
 msgstr ""
+"將一個 mock 作為這個 Mock 的屬性附加，取代它的名稱和上代 (parent)。對附加的 "
+"mock 的呼叫將被記錄在這個 Mock 的 :attr:`method_calls` 和 :attr:`mock_calls` "
+"屬性中。"
 
 #: ../../library/unittest.mock.rst:442
 msgid "Set attributes on the mock through keyword arguments."
-msgstr ""
+msgstr "透過關鍵字參數在 mock 上設定屬性。"
 
 #: ../../library/unittest.mock.rst:444
 msgid ""
 "Attributes plus return values and side effects can be set on child mocks "
 "using standard dot notation and unpacking a dictionary in the method call:"
 msgstr ""
+"可以使用標準點記法 (dot notation) 並在使用 method（方法）呼叫時將字典拆開，"
+"為 child mock 設定屬性、回傳值和 side effects："
 
 #: ../../library/unittest.mock.rst:458
 msgid "The same thing can be achieved in the constructor call to mocks:"
-msgstr ""
+msgstr "同樣的事情可以在 mock 的建構函式呼叫中實現："
 
 #: ../../library/unittest.mock.rst:471
 msgid ""
 ":meth:`configure_mock` exists to make it easier to do configuration after "
 "the mock has been created."
 msgstr ""
+":meth:`configure_mock` 的存在是為了在 mock 被建立後更容易進行組態設定。"
 
 #: ../../library/unittest.mock.rst:477
 msgid ""
 ":class:`Mock` objects limit the results of ``dir(some_mock)`` to useful "
 "results. For mocks with a *spec* this includes all the permitted attributes "
 "for the mock."
 msgstr ""
+":class:`Mock` 物件限制了 ``dir(some_mock)`` 僅顯示有用的結果。對於具有 "
+"*spec* 的 mock，這包含所有被允許的 mock 屬性。"
 
 #: ../../library/unittest.mock.rst:481
 msgid ""
 "See :data:`FILTER_DIR` for what this filtering does, and how to switch it "
 "off."
-msgstr ""
+msgstr "請參閱 :data:`FILTER_DIR` 以了解這種過濾行為的作用，以及如何關閉它。"
 
 #: ../../library/unittest.mock.rst:487
 msgid ""
 "Create the child mocks for attributes and return value. By default child "
 "mocks will be the same type as the parent. Subclasses of Mock may want to "
 "override this to customize the way child mocks are made."
 msgstr ""
+"建立為了得到屬性和回傳值的 child mock。預設情況下，child mock 將與其上代是相"
+"同的類型。Mock 的子類別可能會想要置換此行為，以自定義 child mock 的建立方式。"
 
 #: ../../library/unittest.mock.rst:492
 msgid ""
 "For non-callable mocks the callable variant will be used (rather than any "
 "custom subclass)."
-msgstr ""
+msgstr "對於不可呼叫的 mock，將使用可呼叫的變體，而不是任何的自定義子類別。"
 
 #: ../../library/unittest.mock.rst:498
 msgid "A boolean representing whether or not the mock object has been called:"
