Translate mock from rst:212 to rst:369 (#647)

ken71301 · web-flow · commit 61d570a8a994 · 2023-09-14T11:16:48.000+08:00
* docs: mock 翻譯

translate from 212 to 248

* docs: mock 翻譯

translate from 254 to 369

* docs: mock 翻譯

remove comment

* docs: mock 翻譯

修正用詞

* docs: mock 翻譯

根據review修正

* docs: mock 翻譯

根據review修正
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-09 23:07+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,20 +272,30 @@ 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 ""
@@ -283,29 +305,38 @@ 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 ""
 "Alternatively *side_effect* can be an exception class or instance. In this "
 "case the exception will be raised when the mock is called."
 msgstr ""
+"*side_effect* 也可以是一個例外的類別或實例。在這種情況下，當呼叫 mock 時，該"
+"例外將被引發。"
 
 #: ../../library/unittest.mock.rst:257
 msgid ""
 "If *side_effect* is an iterable then each call to the mock will return the "
 "next value from the iterable."
 msgstr ""
+"如果 *side_effect* 是一個可疊代物件，那麼對 mock 的每次呼叫將回傳可疊代物件中"
+"的下一個值。"
 
 #: ../../library/unittest.mock.rst:260
 msgid "A *side_effect* can be cleared by setting it to ``None``."
-msgstr ""
+msgstr "*side_effect* 可以通過將其設置為 ``None`` 來清除。"
 
 #: ../../library/unittest.mock.rst:262
 msgid ""
 "*return_value*: The value returned when the mock is called. By default this "
 "is a new Mock (created on first access). See the :attr:`return_value` "
 "attribute."
 msgstr ""
+"*return_value*：當呼叫 mock 時回傳的值。預設情況下，這是一個新的 Mock（在首次"
+"存取時建立）。參見 :attr:`return_value` 屬性。"
 
 #: ../../library/unittest.mock.rst:266
 msgid ""
@@ -314,6 +345,9 @@ msgid ""
 "`AttributeError`. Passing ``unsafe=True`` will allow access to these "
 "attributes."
 msgstr ""
+"*unsafe*：預設情況下，存取任何以 *assert*、*assret*、*asert*、*aseert* 或 "
+"*assrt* 開頭的屬性將引發 :exc:`AttributeError`。如果傳遞 ``unsafe=True``\\ ，"
+"將會允許存取這些屬性。"
 
 #: ../../library/unittest.mock.rst:273
 msgid ""
@@ -324,49 +358,59 @@ msgid ""
 "to access an attribute that doesn't exist will raise an :exc:"
 "`AttributeError`)."
 msgstr ""
+"*wraps*：被 mock 物件包裝的項目。如果 *wraps* 不是 ``None``，那麼呼叫 Mock 將"
+"通過被包裝的物件（回傳真實結果）。存取 mock 的屬性將會回傳一個 Mock 物件，該"
+"物件包裝了被包裝物件的對應屬性（因此嘗試存取不存在的屬性將引發 :exc:"
+"`AttributeError`\\ ）。"
 
 #: ../../library/unittest.mock.rst:280
 msgid ""
 "If the mock has an explicit *return_value* set then calls are not passed to "
 "the wrapped object and the *return_value* is returned instead."
 msgstr ""
+"如果 mock 已經明確設定了 *return_value*，那麼呼叫並不會被傳遞到被包裝的物件，"
+"而是回傳已設定好的 *return_value*。"
 
 #: ../../library/unittest.mock.rst:283
 msgid ""
 "*name*: If the mock has a name then it will be used in the repr of the mock. "
 "This can be useful for debugging. The name is propagated to child mocks."
 msgstr ""
+"*name*：如果 mock 有一個名稱，那麼它會被用於 mock 的 repr。這對於除錯很有用。"
+"此名稱將被傳播到子 mocks。"
 
 #: ../../library/unittest.mock.rst:287
 msgid ""
 "Mocks can also be called with arbitrary keyword arguments. These will be "
 "used to set attributes on the mock after it is created. See the :meth:"
 "`configure_mock` method for details."
 msgstr ""
+"Mocks 還可以使用任意的關鍵字引數進行呼叫。這些關鍵字引數將在建立 mock 之後用"
+"於設定 mock 的屬性。欲知更多，請參見 :meth:`configure_mock` 方法。"
 
 #: ../../library/unittest.mock.rst:293
 msgid "Assert that the mock was called at least once."
-msgstr ""
+msgstr "確認 mock 至少被呼叫一次。"
 
 #: ../../library/unittest.mock.rst:304
 msgid "Assert that the mock was called exactly once."
-msgstr ""
+msgstr "確認 mock 只被呼叫一次。"
 
 #: ../../library/unittest.mock.rst:322
 msgid ""
 "This method is a convenient way of asserting that the last call has been "
 "made in a particular way:"
-msgstr ""
+msgstr "這個方法是一個便利的方式，用來斷言最後一次呼叫是以特定方式進行的："
 
 #: ../../library/unittest.mock.rst:332
 msgid ""
 "Assert that the mock was called exactly once and that call was with the "
 "specified arguments."
-msgstr ""
+msgstr "確認 mock 只被呼叫一次，且該次呼叫使用了指定的引數。"
 
 #: ../../library/unittest.mock.rst:347
 msgid "assert the mock has been called with the specified arguments."
-msgstr ""
+msgstr "斷言 mock 已經被使用指定的引數呼叫。"
 
 #: ../../library/unittest.mock.rst:349
 msgid ""
@@ -375,24 +419,33 @@ msgid ""
 "the call is the most recent one, and in the case of :meth:"
 "`assert_called_once_with` it must also be the only call."
 msgstr ""
+"這個斷言在 mock 曾經被呼叫過時通過，不同於 :meth:`assert_called_with` 和 :"
+"meth:`assert_called_once_with`，他們針對的是最近的一次的呼叫，而且對於 :meth:"
+"`assert_called_once_with`，最近一次的呼叫還必須也是唯一一次的呼叫。"
 
 #: ../../library/unittest.mock.rst:362
 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` 串列中的"
+"呼叫。"
 
 #: ../../library/unittest.mock.rst:365
 msgid ""
 "If *any_order* is false then the calls must be sequential. There can be "
 "extra calls before or after the specified calls."
 msgstr ""
+"如果 *any_order* 為 false，那麼這些呼叫必須按照順序。在指定的呼叫之前或之後可"
+"以有額外的呼叫。"
 
 #: ../../library/unittest.mock.rst:369
 msgid ""
 "If *any_order* is true then the calls can be in any order, but they must all "
 "appear in :attr:`mock_calls`."
 msgstr ""
+"如果 *any_order* 為 true，那麼這些呼叫可以以任何順序出現，但它們必須全部出現"
+"在 :attr:`mock_calls` 中。"
 
 #: ../../library/unittest.mock.rst:384
 msgid "Assert the mock was never called."
