docs: mock 翻譯

ken71301 · ken71301 · commit d8e1cac8f5c4 · 2023-09-07T23:29:25.000+08:00
translate from 212 to 248
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-08-29 15:33+0800\n"
+"PO-Revision-Date: 2023-09-05 00:58+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -198,9 +198,9 @@ msgid ""
 msgstr ""
 "為了確保測試中的 mock 物件與它們要替換的物件具有相同的 api，你可以使用\\ :"
 "ref:`自動規格 <auto-speccing>`\\ 。自動規格（auto-speccing）可以通過 patch "
-"的  *autospec* 引數或 :func:`create_autospec` 函式來完成。自動規格建立的 "
-"mock 物件與它們要替換的物件具有相同的屬性和方法，並且任何函式和方法（包括建構"
-"函式）都具有與真實物件相同的呼叫簽名（call signature）。"
+"的 *autospec* 引數或 :func:`create_autospec` 函式來完成。自動規格建立的 mock "
+"物件與它們要替換的物件具有相同的屬性和方法，並且任何函式和方法（包括建構函"
+"式）都具有與真實物件相同的呼叫簽名（call signature）。"
 
 #: ../../library/unittest.mock.rst:178
 msgid ""
@@ -229,6 +229,10 @@ msgid ""
 "attribute will always return the same mock. Mocks record how you use them, "
 "allowing you to make assertions about what your code has done to them."
 msgstr ""
+":class:`Mock` 是一個彈性的的 mock 物件，旨在代替程式碼中 stubs 和 test "
+"doubles （測試替身）的使用。Mock 是可呼叫的，並在你存取它們時將屬性創建為新"
+"的 mock [#]_。存取相同的屬性將永遠返回相同的 mock。Mock 記錄了你如何使用它"
+"們，允許你判定你的程式碼對 mock 的行為。"
 
 #: ../../library/unittest.mock.rst:218
 msgid ""
@@ -237,6 +241,9 @@ msgid ""
 "when you are mocking out objects that aren't callable: :class:"
 "`NonCallableMock` and :class:`NonCallableMagicMock`"
 msgstr ""
+":class:`MagicMock` 是 :class:`Mock` 的子類別，其中所有魔術方法均已預先建立並"
+"可供使用。也有不可呼叫的變體，在你 mock 無法呼叫的物件時很有用：\\ :class:"
+"`NonCallableMock` 和 :class:`NonCallableMagicMock`"
 
 #: ../../library/unittest.mock.rst:223
 msgid ""
@@ -245,12 +252,17 @@ msgid ""
 "will create a :class:`MagicMock` for you. You can specify an alternative "
 "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` 的替代類別。"
 
 #: ../../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 物件的行為："
 
 #: ../../library/unittest.mock.rst:234
 msgid ""
@@ -260,21 +272,32 @@ msgid ""
 "(excluding unsupported magic attributes and methods). Accessing any "
 "attribute not in this list will raise an :exc:`AttributeError`."
 msgstr ""
+"*spec*：這可以是字串的 list（串列），也可以是充當 mock 物件規格的現有物件（類"
+"別或實例）。如果傳入一個物件，則通過對該物件呼叫 dir 來形成字串的串列（不包括"
+"不支援的魔術屬性和方法）。存取不在此串列中的任何屬性都會引發 :exc:"
+"`AttributeError`\\ 。"
 
 #: ../../library/unittest.mock.rst:240
 msgid ""
 "If *spec* is an object (rather than a list of strings) then :attr:`~instance."
 "__class__` returns the class of the spec object. This allows mocks to pass :"
 "func:`isinstance` tests."
 msgstr ""
+"如果 *spec* 是一個物件（而不是一個字串的串列），那麼 :attr:`~instance."
+"__class__` 會回傳 spec 物件的類別。這允許 mocks 通過 :func:`isinstance` 測"
+"試。"
 
 #: ../../library/unittest.mock.rst:244
 msgid ""
 "*spec_set*: A stricter variant of *spec*. If used, attempting to *set* or "
 "get an attribute on the mock that isn't on the object passed as *spec_set* "
 "will raise an :exc:`AttributeError`."
 msgstr ""
+"*spec_set*：*spec* 的一個更嚴格的變體。如果使用 *spec_set*，在 mock 上嘗試 "
+"*set* 或取得不在傳遞給 *spec_set* 的物件上的屬性將會引發 :exc:"
+"`AttributeError`。"
 
+# 待討論
 #: ../../library/unittest.mock.rst:248
 msgid ""
 "*side_effect*: A function to be called whenever the Mock is called. See the :"
@@ -283,6 +306,9 @@ msgid ""
 "arguments as the mock, and unless it returns :data:`DEFAULT`, the return "
 "value of this function is used as the return value."
 msgstr ""
+"*side_effect*：每當呼叫 Mock 時要呼叫的函式。參見 :attr:`~Mock.side_effect` "
+"屬性。用於引發例外或動態變更回傳值。該函式使用與 mock 相同的引數呼叫，且除非"
+"它回傳 :data:`DEFAULT`，否則此函式的返回值將用作返回值。"
 
 #: ../../library/unittest.mock.rst:254
 msgid ""
