feat: to rst:358

Author: ken71301

library/unittest.mock-examples.po

@@ -8,7 +8,7 @@ msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2023-09-09 00:03+0000\n"
-"PO-Revision-Date: 2024-01-14 01:14+0800\n"
+"PO-Revision-Date: 2024-01-14 18:14+0800\n"
 "Last-Translator: Liang-Bo Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -256,18 +256,20 @@ msgstr ""
 
 #: ../../library/unittest.mock-examples.rst:233
 msgid "Raising exceptions with mocks"
-msgstr ""
+msgstr "透過 mock 引發例外"
 
 #: ../../library/unittest.mock-examples.rst:235
 msgid ""
 "A useful attribute is :attr:`~Mock.side_effect`. If you set this to an "
 "exception class or instance then the exception will be raised when the mock "
 "is called."
 msgstr ""
+"一個有用的屬性是 :attr:`~Mock.side_effect`。如果將其設定為例外類別或實例，則"
+"當 mock 被呼叫時將引發例外。"
 
 #: ../../library/unittest.mock-examples.rst:247
 msgid "Side effect functions and iterables"
-msgstr ""
+msgstr "Side effect 函式以及可疊代物件"
 
 #: ../../library/unittest.mock-examples.rst:249
 msgid ""
@@ -277,6 +279,10 @@ msgid ""
 "set ``side_effect`` to an iterable every call to the mock returns the next "
 "value from the iterable:"
 msgstr ""
+"``side_effect`` 也可以設定為函式或可疊代物件。``side_effect`` 作為可疊代物件"
+"的使用案例是：當你的 mock 將會被多次呼叫，且你希望每次呼叫回傳不同的值。當你"
+"將``side_effect`` 設定為可疊代物件時，對 mock 的每次呼叫都會傳回可疊代物件中"
+"的下一個值："
 
 #: ../../library/unittest.mock-examples.rst:264
 msgid ""
@@ -285,10 +291,13 @@ msgid ""
 "function. The function will be called with the same arguments as the mock. "
 "Whatever the function returns is what the call returns:"
 msgstr ""
+"對於更進階的使用案例，例如根據 mock 被呼叫的內容動態變更回傳值，"
+"``side_effect`` 可以是一個函式。該函式會使用與 mock 相同的引數被呼叫。函式回"
+"傳的內容就會是呼叫回傳的內容："
 
 #: ../../library/unittest.mock-examples.rst:281
 msgid "Mocking asynchronous iterators"
-msgstr ""
+msgstr "Mock 非同步可疊代物件"
 
 #: ../../library/unittest.mock-examples.rst:283
 msgid ""
@@ -297,10 +306,13 @@ msgid ""
 "attribute of ``__aiter__`` can be used to set the return values to be used "
 "for iteration."
 msgstr ""
+"從 Python 3.8 開始，``AsyncMock`` 和 ``MagicMock`` 支援透過 ``__aiter__`` 來 "
+"mock :ref:`async-iterators`。``__aiter__`` 的 :attr:`~Mock.return_value` 屬性"
+"可用來設定用於疊代的回傳值。"
 
 #: ../../library/unittest.mock-examples.rst:298
 msgid "Mocking asynchronous context manager"
-msgstr ""
+msgstr "Mock 非同步情境管理器"
 
 #: ../../library/unittest.mock-examples.rst:300
 msgid ""
@@ -309,10 +321,13 @@ msgid ""
 "default, ``__aenter__`` and ``__aexit__`` are ``AsyncMock`` instances that "
 "return an async function."
 msgstr ""
+"從 Python 3.8 開始，``AsyncMock`` 和 ``MagicMock`` 支援透過 ``__aenter__`` "
+"和 ``__aexit__`` 來 mock :ref:`async-context-managers`。預設情況下，"
+"``__aenter__`` 和 ``__aexit__`` 是回傳非同步函式的 ``AsyncMock`` 實例。"
 
 #: ../../library/unittest.mock-examples.rst:322
 msgid "Creating a Mock from an Existing Object"
-msgstr ""
+msgstr "從現有物件建立 mock"
 
 #: ../../library/unittest.mock-examples.rst:324
 msgid ""
@@ -323,6 +338,11 @@ msgid ""
 "you refactor the first class, so that it no longer has ``some_method`` - "
 "then your tests will continue to pass even though your code is now broken!"
 msgstr ""
+"過度使用 mock 的一個問題是，它將你的測試與 mock 的實現結合在一起，而不是與真"
+"實的程式碼結合。假設你有一個實作 ``some_method`` 的類別，在另一個類別的測試"
+"中，你提供了一個 mock 的物件，其*也*提供了 ``some_method``。如果之後你重構第"
+"一個類別，使其不再具有 ``some_method`` - 那麼即使你的程式碼已經損壞，你的測試"
+"也將繼續通過！"
 
 #: ../../library/unittest.mock-examples.rst:331
 msgid ""
@@ -333,26 +353,35 @@ msgid ""
 "specification, then tests that use that class will start failing immediately "
 "without you having to instantiate the class in those tests."
 msgstr ""
+":class:`Mock` 允許你使用 *spec* 關鍵字引數提供一個物件作為 mock 的規格。 對 "
+"mock 存取規格物件上不存在的方法或屬性將立即引發一個屬性錯誤。如果你更改規格的"
+"實作，那麼使用該類別的測試將立即失敗，而無需在這些測試中實例化該類別。"
 
 #: ../../library/unittest.mock-examples.rst:344
 msgid ""
 "Using a specification also enables a smarter matching of calls made to the "
 "mock, regardless of whether some parameters were passed as positional or "
 "named arguments::"
 msgstr ""
+"使用規格還可以更聰明地匹配對 mock 的呼叫，無論引數是作為位置引數還是命名引數"
+"傳遞： ::"
 
 #: ../../library/unittest.mock-examples.rst:355
 msgid ""
 "If you want this smarter matching to also work with method calls on the "
 "mock, you can use :ref:`auto-speccing <auto-speccing>`."
 msgstr ""
+"如果你希望這種更聰明的匹配也可以應用於 mock 上的方法呼叫，你可以使用\\ :ref:`"
+"自動規格 <auto-speccing>`。"
 
 #: ../../library/unittest.mock-examples.rst:358
 msgid ""
 "If you want a stronger form of specification that prevents the setting of "
 "arbitrary attributes as well as the getting of them then you can use "
 "*spec_set* instead of *spec*."
 msgstr ""
+"如果你想要一種更強大的規格形式來防止設定任意屬性以及取得它們，那麼你可以使用 "
+"*spec_set* 而不是 *spec*。"
 
 #: ../../library/unittest.mock-examples.rst:364
 msgid "Using side_effect to return per file content"