Skip to content

Numpydocify setp. #18686

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.

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 1 commit into from
Oct 8, 2020
Merged

Numpydocify setp. #18686

merged 1 commit into from
Oct 8, 2020

Conversation

anntzer
Copy link
Contributor

@anntzer anntzer commented Oct 7, 2020

PR Summary

PR Checklist

  • Has pytest style unit tests (and pytest passes).
  • Is Flake 8 compliant (run flake8 on changed files to check).
  • New features are documented, with examples if plot related.
  • Documentation is sphinx and numpydoc compliant (the docs should build without error).
  • Conforms to Matplotlib style conventions (install flake8-docstrings and pydocstyle<4 and run flake8 --docstring-convention=all).
  • New features have an entry in doc/users/next_whats_new/ (follow instructions in README.rst there).
  • API changes documented in doc/api/next_api_changes/ (follow instructions in README.rst there).

Copy link
Contributor

@brunobeltran brunobeltran left a comment

Choose a reason for hiding this comment

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

Thanks for the cleanup!

I will ask for minor change, either explicitly state that file is forwarded to print or else let the user know what None means.

Comment on lines 1615 to 1616
file : file-like or None, default: `sys.stdout`
Where `setp` writes its output, e.g. ::
Copy link
Contributor

Choose a reason for hiding this comment

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

This defaults description only makes sense if you know we're forwarding this to print, otherwise None could also plausibly interpreted to mean "no output".

Suggested change
file : file-like or None, default: `sys.stdout`
Where `setp` writes its output, e.g. ::
file : file-like, optional, default: `sys.stdout`
Where `setp` writes its output if it is asked to list allowed values.
e.g. ::
with open('output.log') as file:
setp(line, file=file)
Passing ``None`` forwards output to `sys.stdout`.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

yup

@brunobeltran brunobeltran merged commit 76ede99 into matplotlib:master Oct 8, 2020
@anntzer anntzer deleted the setp branch October 8, 2020 14:11
@QuLogic QuLogic added this to the v3.4.0 milestone Oct 8, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants