feat: to rst:228

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: 2023-11-21 22:16+0800\n"
+"PO-Revision-Date: 2024-01-14 01:14+0800\n"
 "Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -17,7 +17,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
-"X-Generator: Poedit 3.4\n"
+"X-Generator: Poedit 3.4.1\n"
 
 #: ../../library/unittest.mock-examples.rst:2
 msgid ":mod:`unittest.mock` --- getting started"
@@ -131,7 +131,7 @@ msgstr ""
 
 #: ../../library/unittest.mock-examples.rst:106
 msgid "Mocking Classes"
-msgstr ""
+msgstr "Mock 類別"
 
 #: ../../library/unittest.mock-examples.rst:108
 msgid ""
@@ -140,6 +140,9 @@ msgid ""
 "Instances are created by *calling the class*. This means you access the "
 "\"mock instance\" by looking at the return value of the mocked class."
 msgstr ""
+"一個常見的例子是 mock 被測試的程式碼實例化的類別。 當你 patch 一個類別時，該"
+"類別就會被替換為 mock。 實例是透過*呼叫類別*建立的。 這代表你可以透過查看被 "
+"mock 的類別的回傳值來存取「mock 實例」。"
 
 #: ../../library/unittest.mock-examples.rst:113
 msgid ""
@@ -149,28 +152,36 @@ msgid ""
 "mock, so it is configured by modifying the mock :attr:`~Mock."
 "return_value`. ::"
 msgstr ""
+"在下面的範例中，我們有一個函式 ``some_function``，它實例化 ``Foo`` 並呼叫它的"
+"方法。 對 :func:`patch` 的呼叫將類別 ``Foo`` 替換為一個 mock。``Foo`` 實例是"
+"呼叫 mock 的結果，因此它是透過修改 mock :attr:`~Mock.return_value` 來配置"
+"的。： ::"
 
 #: ../../library/unittest.mock-examples.rst:130
 msgid "Naming your mocks"
-msgstr ""
+msgstr "命名你的 mock"
 
 #: ../../library/unittest.mock-examples.rst:132
 msgid ""
 "It can be useful to give your mocks a name. The name is shown in the repr of "
 "the mock and can be helpful when the mock appears in test failure messages. "
 "The name is also propagated to attributes or methods of the mock:"
 msgstr ""
+"為你的 mock 命名可能會很有用。 這個名稱會顯示在 mock 的 repr 中，且當 mock 出"
+"現在測試的失敗訊息中時，名稱會很有幫助。 該名稱也會傳播到 mock 的屬性或方法："
 
 #: ../../library/unittest.mock-examples.rst:144
 msgid "Tracking all Calls"
-msgstr ""
+msgstr "追蹤所有呼叫"
 
 #: ../../library/unittest.mock-examples.rst:146
 msgid ""
 "Often you want to track more than a single call to a method. The :attr:"
 "`~Mock.mock_calls` attribute records all calls to child attributes of the "
 "mock - and also to their children."
 msgstr ""
+"通常你會想要追蹤對一個方法的多個呼叫。:attr:`~Mock.mock_calls` 屬性記錄對 "
+"mock 的子屬性以及其子屬性的所有呼叫。"
 
 #: ../../library/unittest.mock-examples.rst:158
 msgid ""
@@ -179,58 +190,69 @@ msgid ""
 "well as asserting that the calls you expected have been made, you are also "
 "checking that they were made in the right order and with no additional calls:"
 msgstr ""
+"如果你對 ``mock_calls`` 做出斷言並且有任何不預期的方法被呼叫，則斷言將失敗。 "
+"這很有用，因為除了斷言你期望的呼叫已經進行之外，你還可以檢查它們是否按正確的"
+"順序進行，並且沒有多餘的呼叫："
 
 #: ../../library/unittest.mock-examples.rst:163
 msgid ""
 "You use the :data:`call` object to construct lists for comparing with "
 "``mock_calls``:"
-msgstr ""
+msgstr "你可以使用 :data:`call` 物件來建構串列以與 ``mock_calls`` 進行比較："
 
 #: ../../library/unittest.mock-examples.rst:170
 msgid ""
 "However, parameters to calls that return mocks are not recorded, which means "
 "it is not possible to track nested calls where the parameters used to create "
 "ancestors are important:"
 msgstr ""
+"然而，回傳 mock 的呼叫的參數不會被記錄，這代表著無法追蹤用於建立重要的祖先的"
+"參數的巢狀呼叫："
 
 #: ../../library/unittest.mock-examples.rst:181
 msgid "Setting Return Values and Attributes"
-msgstr ""
+msgstr "設定回傳值和屬性"
 
 #: ../../library/unittest.mock-examples.rst:183
 msgid "Setting the return values on a mock object is trivially easy:"
-msgstr ""
+msgstr "在 mock 物件上設定回傳值非常簡單："
 
 #: ../../library/unittest.mock-examples.rst:190
 msgid "Of course you can do the same for methods on the mock:"
-msgstr ""
+msgstr "當然，你可以對 mock 上的方法執行相同的操作："
 
 #: ../../library/unittest.mock-examples.rst:197
 msgid "The return value can also be set in the constructor:"
-msgstr ""
+msgstr "回傳值也可以在建構函式中設定："
 
 #: ../../library/unittest.mock-examples.rst:203
 msgid "If you need an attribute setting on your mock, just do it:"
-msgstr ""
+msgstr "如果你需要在 mock 上進行屬性設置，只需執行以下操作："
 
 #: ../../library/unittest.mock-examples.rst:210
 msgid ""
 "Sometimes you want to mock up a more complex situation, like for example "
 "``mock.connection.cursor().execute(\"SELECT 1\")``. If we wanted this call "
 "to return a list, then we have to configure the result of the nested call."
 msgstr ""
+"有時你想要 mock 更複雜的情況，例如 ``mock.connection.cursor()."
+"execute(\"SELECT 1\")``。 如果我們希望此呼叫回傳一個串列，那麼我們就必須配置"
+"巢狀呼叫的結果。"
 
 #: ../../library/unittest.mock-examples.rst:214
 msgid ""
 "We can use :data:`call` to construct the set of calls in a \"chained call\" "
 "like this for easy assertion afterwards:"
 msgstr ""
+"如下所示，我們可以使用 :data:`call` 在「鍊接呼叫 (chained call)」中建構呼叫的"
+"集合，以便在之後輕鬆的進行斷言："
 
 #: ../../library/unittest.mock-examples.rst:228
 msgid ""
 "It is the call to ``.call_list()`` that turns our call object into a list of "
 "calls representing the chained calls."
 msgstr ""
+"正是對 ``.call_list()`` 的呼叫將我們的呼叫物件轉換為代表鍊接呼叫的呼叫串列。"
 
 #: ../../library/unittest.mock-examples.rst:233
 msgid "Raising exceptions with mocks"