forked from python/python-docs-zh-tw
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Translate mock from rst:212 to rst:369 (python#647)
* 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修正
- Loading branch information
Showing
1 changed file
with
63 additions
and
10 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -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 <[email protected]>\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." | ||
|
|
||