Skip to content

Added reference for return_value in unittest.mock documentation - #119207

Merged
encukou merged 2 commits into
python:mainfrom
Tialo:patch-1
May 20, 2024
Merged

Added reference for return_value in unittest.mock documentation#119207
encukou merged 2 commits into
python:mainfrom
Tialo:patch-1

Conversation

@Tialo

@TialoTialo commented May 20, 2024•
edited by github-actions Bot
Loading

Copy link
Copy Markdown
Contributor

Added reference for return_value in documentation

📚 Documentation preview 📚: https://cpython-previews--119207.org.readthedocs.build/

@ghost

ghost commented May 20, 2024•
edited by ghost
Loading

Copy link
Copy Markdown

All commit authors signed the Contributor License Agreement.
CLA signed

@bedevere-appbedevere-appBot added docs Documentation in the Doc dir skip news awaiting review labels May 20, 2024
blaisep
blaisep approved these changes May 20, 2024
View reviewed changes

@blaisepblaisep left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Small change to improve consistency, Nice.

Comment threadDoc/library/unittest.mock.rst Outdated
(if any) are reset as well.

.. note:: *return_value*, and :attr:`side_effect` are keyword-only
.. note:: :attr:`return_value`, and :attr:`side_effect` are keyword-only

@blaisepblaisepMay 20, 2024

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice! Attention to detail, increases consistency.

@blaisepblaisepMay 20, 2024

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@encukou , LMK if I need to look for anything else.

@encukouencukouMay 20, 2024

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Both of these refer to the function arguments, so they should be marked up as such (*return_value* and *side_effect*).

But, a bit above in:

 In case you want to reset *return_value* or :attr:`side_effect`

these refer to attributes of the Mock objects, and should use :attr: (return_value should be changed to use :attr:).

@Tialo

Tialo commented May 20, 2024

Copy link
Copy Markdown
ContributorAuthor

Also added :attr: for return_value above

@encukou
encukou merged commit 6b80a5b into python:mainMay 20, 2024
@encukou

encukou commented May 20, 2024

Copy link
Copy Markdown
Member

Thank you!

@encukouencukou added needs backport to 3.12 only security fixes needs backport to 3.13 bugs and security fixes labels May 20, 2024
@miss-islington-app

miss-islington-appBot commented May 20, 2024

Copy link
Copy Markdown

Thanks @Tialo for the PR, and @encukou for merging it 🌮🎉.. I'm working now to backport this PR to: 3.12.
🐍🍒⛏🤖

@miss-islington-app

miss-islington-appBot commented May 20, 2024

Copy link
Copy Markdown

Thanks @Tialo for the PR, and @encukou for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request May 20, 2024
@Tialo@miss-islington
Use correct markup in unittest.mock.reset_mock documentation (pythonG…
c42b810
…H-119207)
(cherry picked from commit 6b80a5b)
Co-authored-by: Tialo <65392801+Tialo@users.noreply.github.com>
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request May 20, 2024
@Tialo@miss-islington
Use correct markup in unittest.mock.reset_mock documentation (pythonG…
968201b
…H-119207)
(cherry picked from commit 6b80a5b)
Co-authored-by: Tialo <65392801+Tialo@users.noreply.github.com>
@bedevere-app

bedevere-appBot commented May 20, 2024

Copy link
Copy Markdown

GH-119249 is a backport of this pull request to the 3.12 branch.

@bedevere-appbedevere-appBot removed the needs backport to 3.12 only security fixes label May 20, 2024
@bedevere-app

bedevere-appBot commented May 20, 2024

Copy link
Copy Markdown

GH-119250 is a backport of this pull request to the 3.13 branch.

@bedevere-appbedevere-appBot removed the needs backport to 3.13 bugs and security fixes label May 20, 2024
encukou pushed a commit that referenced this pull request May 20, 2024
@miss-islington@Tialo
[3.12] Use correct markup in unittest.mock.reset_mock documentation (G…
1738944
…H-119207) (GH-119249)
Use correct markup in unittest.mock.reset_mock documentation (GH-119207)
(cherry picked from commit 6b80a5b)
Co-authored-by: Tialo <65392801+Tialo@users.noreply.github.com>
encukou pushed a commit that referenced this pull request May 20, 2024
@miss-islington@Tialo
[3.13] Use correct markup in unittest.mock.reset_mock documentation (G…
906f6cb
…H-119207) (GH-119250)
Use correct markup in unittest.mock.reset_mock documentation (GH-119207)
(cherry picked from commit 6b80a5b)
Co-authored-by: Tialo <65392801+Tialo@users.noreply.github.com>
@Tialo
Tialo deleted the patch-1 branch May 23, 2024 18:24
@JelleZijlstraJelleZijlstra mentioned this pull request May 28, 2024
Closed
estyxx pushed a commit to estyxx/cpython that referenced this pull request Jul 17, 2024
@Tialo@estyxx
Use correct markup in unittest.mock.reset_mock documentation (pythonG…
a56a546
…H-119207)
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@encukouencukouencukou left review comments
+1 more reviewer
@blaisepblaisepblaisep approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

docsDocumentation in the Doc dirskip issueskip news

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@Tialo@encukou@blaisep