feat: to rst:675

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-26 19:03+0800\n"
+"PO-Revision-Date: 2024-02-26 21:40+0800\n"
 "Last-Translator: Liang-Bo Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -627,7 +627,7 @@ msgstr ""
 
 #: ../../library/unittest.mock-examples.rst:601
 msgid "Partial mocking"
-msgstr ""
+msgstr "部分 mocking"
 
 #: ../../library/unittest.mock-examples.rst:603
 msgid ""
@@ -637,13 +637,19 @@ msgid ""
 "in C, and so I couldn't just monkey-patch out the static :meth:`datetime."
 "date.today` method."
 msgstr ""
+"在某些測試中，我們會想 mock 對 :meth:`datetime.date.today` 的呼叫以回傳一個已"
+"知日期，但我不想阻止測試中的程式碼建立新的日期物件。不幸的是 :class:"
+"`datetime.date` 是用 C 語言寫的，所以們我不能 monkey patch 靜態的 :meth:"
+"`datetime.date.today` 方法。"
 
 #: ../../library/unittest.mock-examples.rst:608
 msgid ""
 "I found a simple way of doing this that involved effectively wrapping the "
 "date class with a mock, but passing through calls to the constructor to the "
 "real class (and returning real instances)."
 msgstr ""
+"我們找到了一種簡單的方法來做到這一點，其用 mock 有效地包裝日期類別，但將對建"
+"構函式的呼叫傳遞給真實的類別（並返回真實的實例）。"
 
 #: ../../library/unittest.mock-examples.rst:612
 msgid ""
@@ -653,12 +659,18 @@ msgid ""
 "date. When the mock date class is called a real date will be constructed and "
 "returned by ``side_effect``. ::"
 msgstr ""
+"這裡使用 :func:`patch 裝飾器 <patch>` 來 mock 被測模組中的 ``date`` 類別。然"
+"後，mock 日期類別上的 :attr:`~Mock.side_effect` 屬性會被設定為回傳真實日期的 "
+"lambda 函式。當 mock 日期類別被呼叫時，將透過 ``side_effect`` 建構並回傳真實"
+"日期。： ::"
 
 #: ../../library/unittest.mock-examples.rst:626
 msgid ""
 "Note that we don't patch :class:`datetime.date` globally, we patch ``date`` "
 "in the module that *uses* it. See :ref:`where to patch <where-to-patch>`."
 msgstr ""
+"注意，我們沒有全域 patch :class:`datetime.date`，而是在\\ *使用*\\ 它的模組"
+"中 patch ``date``。請參閱 :ref:`該 patch 何處 <where-to-patch>`。"
 
 #: ../../library/unittest.mock-examples.rst:629
 msgid ""
@@ -667,29 +679,40 @@ msgid ""
 "find yourself having to calculate an expected result using exactly the same "
 "algorithm as the code under test, which is a classic testing anti-pattern."
 msgstr ""
+"當 ``date.today()`` 被呼叫時，一個已知日期會被回傳，但對 ``date(...)`` 建構函"
+"式的呼叫仍然會回傳正常日期。如果不這樣使用，你可能會發現自己必須使用與被測程"
+"式碼完全相同的演算法來計算預期結果，這是一個典型的測試的反面模式 (anti-"
+"pattern)。"
 
 #: ../../library/unittest.mock-examples.rst:634
 msgid ""
 "Calls to the date constructor are recorded in the ``mock_date`` attributes "
 "(``call_count`` and friends) which may also be useful for your tests."
 msgstr ""
+"對日期建構函式的呼叫被記錄在 ``mock_date`` 屬性（\\ ``call_count`` 和它的朋友"
+"們）中，這對你的測試也可能有用處。"
 
 #: ../../library/unittest.mock-examples.rst:637
 msgid ""
 "An alternative way of dealing with mocking dates, or other builtin classes, "
 "is discussed in `this blog entry <https://williambert.online/2011/07/how-to-"
 "unit-testing-in-django-with-mocking-and-patching/>`_."
 msgstr ""
+"處理 mock 日期或其他內建類別的另一種方法在 `這個 blog <https://williambert."
+"online/2011/07/how-to-unit-testing-in-django-with-mocking-and-patching/>`_ 中"
+"討論。"
 
 #: ../../library/unittest.mock-examples.rst:643
 msgid "Mocking a Generator Method"
-msgstr ""
+msgstr "Mock 產生器方法"
 
 #: ../../library/unittest.mock-examples.rst:645
 msgid ""
 "A Python generator is a function or method that uses the :keyword:`yield` "
 "statement to return a series of values when iterated over [#]_."
 msgstr ""
+"Python 產生器是一個函式或方法，它使用 :keyword:`yield` 陳述式在疊代 [#]_ 時回"
+"傳一系列的值。"
 
 #: ../../library/unittest.mock-examples.rst:648
 msgid ""
@@ -698,22 +721,27 @@ msgid ""
 "iteration is :meth:`~container.__iter__`, so we can mock this using a :class:"
 "`MagicMock`."
 msgstr ""
+"產生器方法 / 函式會被呼叫以回傳產生器物件。之後此產生器會進行疊代。疊代的協定"
+"方法是 :meth:`~container.__iter__`，所以我們可以使用 :class:`MagicMock` 來 "
+"mock 它。"
 
 #: ../../library/unittest.mock-examples.rst:653
 msgid ""
 "Here's an example class with an \"iter\" method implemented as a generator:"
-msgstr ""
+msgstr "下面是一個範例類別，其包含實作產生器的一個 \"iter\" 方法："
 
 #: ../../library/unittest.mock-examples.rst:665
 msgid "How would we mock this class, and in particular its \"iter\" method?"
-msgstr ""
+msgstr "我們該如何 mock 這個類別，特別是它的 \"iter\" 方法呢？"
 
 #: ../../library/unittest.mock-examples.rst:667
 msgid ""
 "To configure the values returned from the iteration (implicit in the call "
 "to :class:`list`), we need to configure the object returned by the call to "
 "``foo.iter()``."
 msgstr ""
+"要配置從疊代回傳的值（隱含在對 :class:`list` 的呼叫中），我們需要配置呼叫 "
+"``foo.iter()`` 所回傳的物件。"
 
 #: ../../library/unittest.mock-examples.rst:675
 msgid ""
@@ -723,6 +751,10 @@ msgid ""
 "they are is: `Generator Tricks for Systems Programmers <http://www.dabeaz."
 "com/generators/>`_."
 msgstr ""
+"還有關於產生器運算式及產生器的更多 `進階用法 <http://www.dabeaz.com/"
+"coroutines/index.html>`_ ，但我們在這裡不考慮它們。一個關於產生器及其強大功能"
+"的優良說明是：`Generator Tricks for Systems Programmers <http://www.dabeaz."
+"com/generators/>`_。"
 
 #: ../../library/unittest.mock-examples.rst:683
 msgid "Applying the same patch to every test method"