Translate mock example to rst:99 #705

ken71301 · 2023-11-12T14:11:33Z

mattwang44 · 2023-11-13T02:19:57Z

Hi @mindihx
would you please review this PR when you're available?

mindihx

抱歉有點晚看到所以比較晚回...

mindihx · 2023-11-19T13:02:58Z

library/unittest.mock-examples.po

@@ -17,49 +17,56 @@ 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"


這一行 poedit 產生的可以拿掉

這我覺得不修改沒關係，畢竟是自動產生的、也不會影響到翻譯內容

mindihx · 2023-11-19T13:11:15Z

library/unittest.mock-examples.po


 #: ../../library/unittest.mock-examples.rst:45
 msgid ""
 "Once our mock has been used (``real.method`` in this example) it has methods "
 "and attributes that allow you to make assertions about how it has been used."
 msgstr ""
+"一旦我們的 mock 已經被使用（例如在這個範例中的 ``real.method``），它就有了方"
+"法和屬性，允許你對其使用方式進行 assertions （斷言）。"


建議可以先翻中文再附註英文，以下同理

Suggested change

"法和屬性，允許你對其使用方式進行 assertions （斷言）。"

"法和屬性，允許你對其使用方式進行斷言 (assertions)。"

mindihx · 2023-11-19T13:15:47Z

library/unittest.mock-examples.po

@@ -68,16 +75,21 @@ msgid ""
 "or :meth:`~Mock.assert_called_once_with` method to check that it was called "
 "with the correct arguments."
 msgstr ""
+"一旦 mock 被呼叫，它的 :attr:`~Mock.called` 屬性將被設定為 ``True``。更重要的"
+"是，我們可以使用 :meth:`~Mock.assert_called_with` 或 :meth:`~Mock."
+"assert_called_once_with` 方法來檢查它是否被使用正確的引數來呼叫。"


這樣可能會簡潔一點?
來檢查它是否以正確的引數呼叫

這邊我的話還是想把被動式翻出來(be called with)

mindihx · 2023-11-19T13:20:51Z

library/unittest.mock-examples.po

@@ -86,18 +98,25 @@ msgid ""
 "method (or some part of the system under test) and then check that it is "
 "used in the correct way."
 msgstr ""
+"在上一個範例中，我們直接對物件上的方法進行 patch，以檢查它是否被正確呼叫。另"
+"一個常見的用法是將一個物件傳遞給一個方法（或測試系統的某一部分），然後檢查它"


這邊用受測系統會不會比較明確一點?

Suggested change

"一個常見的用法是將一個物件傳遞給一個方法（或測試系統的某一部分），然後檢查它"

"一個常見的用法是將一個物件傳遞給一個方法（或受測系統的某一部分），然後檢查它"

mindihx · 2023-11-19T13:24:55Z

library/unittest.mock-examples.po


 #: ../../library/unittest.mock-examples.rst:83
 msgid ""
 "The simple ``ProductionClass`` below has a ``closer`` method. If it is "
 "called with an object then it calls ``close`` on it."
 msgstr ""
+"下面是一個含有 ``closer`` 方法的單純的 ``ProductionClass``。如果它被一個物件"


這邊應該不是被一個物件呼叫，而是傳入一個物件?

主要是 called 能不能翻成傳入吧？雖然感覺是比較順沒錯

我先用傳入吧，用物件呼叫確實怪怪的

mindihx · 2023-11-19T13:35:32Z

library/unittest.mock-examples.po

+"我們不必為我們的 mock 提供 'close' 方法。存取 close 會建立它。因此，如果 "
+"'close' 並未被呼叫過，在測試流程中存取 'close' 就會建立它，但 :meth:`~Mock."
+"assert_called_with` 就會引發一個失敗的例外。"


Suggested change

"我們不必為我們的 mock 提供 'close' 方法。存取 close 會建立它。因此，如果 "

"'close' 並未被呼叫過，在測試流程中存取 'close' 就會建立它，但 :meth:`~Mock."

"assert_called_with` 就會引發一個失敗的例外。"

"我們不必做任何額外的事情來為 mock 提供 'close' 方法，存取 close 就會建立它。因此，如果 "

"'close' 並未被呼叫過，在測試中存取 'close' 會建立它，但 :meth:`~Mock."

"assert_called_with` 就會引發一個失敗的例外。"

mindihx · 2023-11-19T13:38:14Z

library/unittest.mock-examples.po


 #: ../../library/unittest.mock-examples.rst:30
 msgid "Mock Patching Methods"
-msgstr ""
+msgstr "使用 Mock 來 patching methods（方法）"


建議這裡可以翻 patch 然後再以英文加註
e.g. 使用 Mock 來修補 (patching) 方法
但我也不太確定 patch 怎麼翻比較好也或者就統一都不翻，可能可以在哪邊 (e.g. discord) 討論一下?
cc @mattwang44

discussion那邊是暫定不翻
#591

@mattwang44
如果討論決定 patch 暫定不翻要更新到 wiki 嗎~
https://github.com/python/python-docs-zh-tw/wiki/%E8%A1%93%E8%AA%9E%E5%88%97%E8%A1%A8

@ken71301
如果 patch 不翻的話這邊感覺可以寫成 使用 Mock 來 patch 方法~?

可以的，mock & patch 一起加上去好了～

mindihx · 2023-11-19T14:26:47Z

library/unittest.mock-examples.po


 #: ../../library/unittest.mock-examples.rst:50
 msgid ""
 "In most of these examples the :class:`Mock` and :class:`MagicMock` classes "
 "are interchangeable. As the ``MagicMock`` is the more capable class it makes "
 "a sensible one to use by default."
 msgstr ""
+"在大多數的範例中，:class:`Mock` 和 :class:`MagicMock` class（類別）是可以互換"


不過類別算是蠻常見的詞，不一定需要附註

Suggested change

"在大多數的範例中，:class:`Mock` 和 :class:`MagicMock` class（類別）是可以互換"

"在大多數的範例中，:class:`Mock` 和 :class:`MagicMock` 類別 (class) 是可以互換"

我是參考這個~
https://github.com/python/python-docs-zh-tw/wiki/%E8%A1%93%E8%AA%9E%E5%88%97%E8%A1%A8

@mattwang44
確認一下 class 我們需要翻成 class（類別） 嗎
如果只需要翻成 類別 或者 類別 (class) 的話那 wiki 要不要也調整一下
再順便確認一下翻譯的時候是翻成中文再附註英文對嗎，因為 wiki 那頁看起來都是英文再附註中文，README 那邊則是提到

在翻譯名稱不常用或不確定的情形，宜用括號註解或直接保留原文。單頁只要首次出現有註解即可。例如：正規表示式 (regular expression)

我也覺得不一定要附註，就請你們直接更改 wiki 🙏🏽

mindihx · 2023-11-19T14:30:58Z

library/unittest.mock-examples.po


 #: ../../library/unittest.mock-examples.rst:76
 msgid "Mock for Method Calls on an Object"
-msgstr ""
+msgstr "在物件上的方法呼叫時使用 mock"


Suggested change

msgstr "在物件上的方法呼叫時使用 mock"

msgstr "對物件的方法呼叫使用 mock"

mindihx · 2023-11-19T14:36:39Z

library/unittest.mock-examples.po


 #: ../../library/unittest.mock-examples.rst:83
 msgid ""
 "The simple ``ProductionClass`` below has a ``closer`` method. If it is "
 "called with an object then it calls ``close`` on it."
 msgstr ""
+"下面是一個含有 ``closer`` 方法的單純的 ``ProductionClass``。如果它被一個物件"


因為英文裡前文最後提到 closer 方法，所以比較明確後文的 it 是指 closer 方法
但目前中文的翻譯這個 它 會比較像是指 ProductionClass

Suggested change

"下面是一個含有 ``closer`` 方法的單純的 ``ProductionClass``。如果它被一個物件"

"下面是一個單純的 ``ProductionClass``，含有一個 ``closer`` 方法。如果它傳入一個物件"

是指哪個 it ?

歐我了解你意思了沒事 :D

library/unittest.mock-examples.po

Co-authored-by: mindihx <[email protected]>

ken71301 added 2 commits November 12, 2023 21:31

docs: 翻譯至rst:59

81ed61c

docs: 翻譯至rst:99

27ff3e8

mattwang44 requested a review from mindihx November 13, 2023 02:19

mindihx reviewed Nov 19, 2023

View reviewed changes

fix: 根據comment修正

3c581d0

mindihx previously approved these changes Nov 22, 2023

View reviewed changes

library/unittest.mock-examples.po Outdated Show resolved Hide resolved

ken71301 dismissed mindihx’s stale review via 9f81b29 November 22, 2023 15:21

Update library/unittest.mock-examples.po

9f81b29

Co-authored-by: mindihx <[email protected]>

ken71301 requested a review from mindihx November 24, 2023 00:00

mindihx approved these changes Nov 25, 2023

View reviewed changes

mattwang44 merged commit 4dbeab8 into python:3.12 Nov 29, 2023

isabellechiu pushed a commit to isabellechiu/python-docs-zh-tw that referenced this pull request Dec 5, 2023

Translate mock example to rst:99 (python#705)

bdd1469

Co-authored-by: mindihx <[email protected]>

beccalzh pushed a commit to beccalzh/python-docs-zh-tw that referenced this pull request Sep 4, 2024

Translate mock example to rst:99 (python#705)

b883db5

Co-authored-by: mindihx <[email protected]>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Translate mock example to rst:99 #705

Translate mock example to rst:99 #705

ken71301 commented Nov 12, 2023

mattwang44 commented Nov 13, 2023

mindihx left a comment

mindihx Nov 19, 2023

mattwang44 Nov 20, 2023

mindihx Nov 19, 2023

mindihx Nov 19, 2023

ken71301 Nov 21, 2023

mindihx Nov 19, 2023

mindihx Nov 19, 2023

ken71301 Nov 20, 2023

ken71301 Nov 21, 2023

mindihx Nov 19, 2023

mindihx Nov 19, 2023

ken71301 Nov 20, 2023

mindihx Nov 20, 2023

mindihx Nov 20, 2023

mattwang44 Nov 20, 2023

mindihx Nov 19, 2023

ken71301 Nov 20, 2023

mindihx Nov 20, 2023

mattwang44 Nov 20, 2023

mindihx Nov 19, 2023

mindihx Nov 19, 2023

ken71301 Nov 21, 2023

ken71301 Nov 21, 2023

	"法和屬性，允許你對其使用方式進行 assertions （斷言）。"
	"法和屬性，允許你對其使用方式進行斷言 (assertions)。"

	"一個常見的用法是將一個物件傳遞給一個方法（或測試系統的某一部分），然後檢查它"
	"一個常見的用法是將一個物件傳遞給一個方法（或受測系統的某一部分），然後檢查它"

	"在大多數的範例中，:class:`Mock` 和 :class:`MagicMock` class（類別）是可以互換"
	"在大多數的範例中，:class:`Mock` 和 :class:`MagicMock` 類別 (class) 是可以互換"

	msgstr "在物件上的方法呼叫時使用 mock"
	msgstr "對物件的方法呼叫使用 mock"

	"下面是一個含有 ``closer`` 方法的單純的 ``ProductionClass``。如果它被一個物件"
	"下面是一個單純的 ``ProductionClass``，含有一個 ``closer`` 方法。如果它傳入一個物件"

Translate mock example to rst:99 #705

Translate mock example to rst:99 #705

Conversation

ken71301 commented Nov 12, 2023

mattwang44 commented Nov 13, 2023

mindihx left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment