Skip to content

Added reference for return_value in unittest.mock documentation#119207

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

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

Conversation

@Tialo
Copy link
Contributor

@Tialo Tialo commented May 20, 2024 •
edited by github-actions bot
Loading

Added reference for return_value in documentation

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

@ghost
Copy link

ghost commented May 20, 2024 •
edited by ghost
Loading

All commit authors signed the Contributor License Agreement.
CLA signed

@bedevere-app bedevere-app bot 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
Copy link
Contributor

@blaisep blaisep left a comment

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.

Doc/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
Copy link
Contributor

@blaisep blaisep May 20, 2024

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.

Copy link
Contributor

@blaisep blaisep May 20, 2024

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.

Copy link
Member

@encukou encukou May 20, 2024

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
Copy link
Contributor Author

Tialo commented May 20, 2024

Also added :attr: for return_value above

@encukou encukou merged commit 6b80a5b into python:main May 20, 2024
@encukou
Copy link
Member

encukou commented May 20, 2024

Thank you!

@encukou encukou 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
Copy link

miss-islington-app bot commented May 20, 2024

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

@miss-islington-app
Copy link

miss-islington-app bot commented May 20, 2024

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
Copy link

bedevere-app bot commented May 20, 2024

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

@bedevere-app bedevere-app bot removed the needs backport to 3.12 only security fixes label May 20, 2024
@bedevere-app
Copy link

bedevere-app bot commented May 20, 2024

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

@bedevere-app bedevere-app bot 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
@JelleZijlstra JelleZijlstra 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 free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@encukou encukou encukou left review comments

+1 more reviewer

@blaisep blaisep blaisep approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

docs Documentation in the Doc dir skip issue skip news

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@Tialo @encukou @blaisep