Skip to content

Deprecate MovieWriter.{exec,args}_key, making them private. #16095

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 2 commits into from
Jan 5, 2020

Conversation

anntzer
Copy link
Contributor

@anntzer anntzer commented Jan 4, 2020

PR Summary

Builtin writer subclasses additionally define the _exec_key and
_args_key attributes, which indicate the rcParams entries where the
path to the executable and additional command-line arguments to the
executable are stored. Third-party writers cannot meaningfully set
these as they cannot extend rcParams with new keys.

Hence they are really an internal way of mapping builtin writers to
rcParams and should not be exposed.

Goes on top of #16081.

PR Checklist

  • Has Pytest style unit tests
  • Code is Flake 8 compliant
  • New features are documented, with examples if plot related
  • Documentation is sphinx and numpydoc compliant
  • Added an entry to doc/users/next_whats_new/ if major new feature (follow instructions in README.rst there)
  • Documented in doc/api/api_changes.rst if API changed in a backward-incompatible way

Copy link
Member

@timhoffm timhoffm left a comment

Choose a reason for hiding this comment

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

past CI.

Note: Doc build fails with

/home/circleci/project/lib/matplotlib/animation.py:docstring of matplotlib.animation.FileMovieWriter.cleanup:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FileMovieWriter.args_key
/home/circleci/project/lib/matplotlib/animation.py:docstring of matplotlib.animation.FileMovieWriter.cleanup:1:<autosummary>:1: WARNING: py:obj reference target not found: matplotlib.animation.FileMovieWriter.exec_key

@anntzer
Copy link
Contributor Author

anntzer commented Jan 4, 2020

I just added them to missing_references, as the args/exec_key were already listed there for subclasses, it looks like to be a spurious thing due to autosummary, and they are going away post-deprecation anyways.

@dopplershift
Copy link
Contributor

@anntzer Are you rebasing now that #16081 is in?

Builtin writer subclasses additionally define the _exec_key and
_args_key attributes, which indicate the rcParams entries where the
path to the executable and additional command-line arguments to the
executable are stored.  Third-party writers cannot meaningfully set
these as they cannot extend rcParams with new keys.

Hence they are really an internal way of mapping builtin writers to
rcParams and should not be exposed.
@anntzer
Copy link
Contributor Author

anntzer commented Jan 5, 2020

rebased

@timhoffm timhoffm merged commit 3d3c930 into matplotlib:master Jan 5, 2020
@anntzer anntzer deleted the anim-execargskey branch January 5, 2020 21:44
@QuLogic QuLogic added this to the v3.3.0 milestone Jan 7, 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.

4 participants