Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Sep 14, 2023
Merged

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

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
d8e1cac
docs: mock 翻譯
ken71301 Sep 4, 2023
b74be57
docs: mock 翻譯
ken71301 Sep 7, 2023
537fc3b
docs: mock 翻譯
ken71301 Sep 7, 2023
d064ad3
docs: mock 翻譯
ken71301 Sep 7, 2023
48b8e31
docs: mock 翻譯
ken71301 Sep 9, 2023
e1311de
docs: mock 翻譯
ken71301 Sep 11, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 63 additions & 10 deletions library/unittest.mock.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down Expand Up @@ -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 ""
Expand Down Expand Up @@ -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 ""
Expand All @@ -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 ""
Expand All @@ -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 ""
Expand All @@ -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 ""
Expand All @@ -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 ""
Expand All @@ -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 ""
Expand All @@ -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 ""
Expand All @@ -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."
Expand Down