8000 Deprecate mpl.py (was Remove mpl.py) by ivanov · Pull Request #1535 · matplotlib/matplotlib · GitHub
[go: up one dir, main page]
Skip to content

Deprecate mpl.py (was Remove mpl.py) #1535

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.

Sign up for GitHub

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

Closed
wants to merge 4 commits into from
Closed

Deprecate mpl.py (was Remove mpl.py) #1535

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
45b340b
deprecate undocumented `matplotlib/mpl.py`
ivanov Nov 26, 2012
882f116
move to the new MatplotlibDeprecationWarning
ivanov Dec 14, 2012
845ac07
added deprecation note to API changes
ivanov Dec 14, 2012
4725953
use mplDeprecation convention
ivanov Dec 18, 2012
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
deprecate undocumented matplotlib/mpl.py 
`matplotlib/mpl.py` is a file which used to get imported via ipython's
`%pyplot` interface as module named `mpl`, yet it isn't clear at all
what it's role is.

Given that in our own code, and in the rest of our python neighborhood,
we often do `import matplotlib as mpl`, it's quite a bit confusing to
have something with the `mpl` name within matplotlib not be the
`matplotlib` module itself.

This module was only used in `pylab` interface, where it was simply
imported in one line via `from matplotlib import mpl` and never used
again. With the exception of mpl.finance, all of the modules in mpl.py
were readily available simply via "import matplotlib as mpl".

pylab's mpl.finance functionality is retained for backwards
compatability.
  • Loading branch information
@ivanov
ivanov committed Dec 5, 2012
commit 45b340b4b3e4a6b70a1bcf018f3d39e8f4abf7e5
4 changes: 4 additions & 0 deletions CHANGELOG
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@

2012-11-26 deprecate matplotlib/mpl.py, which was used only in pylab.py and is
now replaced by the more suitable `import matplotlib as mpl`. - PI

2012-11-13 Add a symmetric log normalization class to colors.py.
Also added some tests for the normalization class.
Till Stensitzki
Expand Down
5 changes: 5 additions & 0 deletions lib/matplotlib/mpl.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
import warnings
warnings.warn(
"matplotlib.mpl is deprecated and will be removed in the next release."
"Please use `import matplotlib as mpl` instead",
DeprecationWarning)
from matplotlib import artist
from matplotlib import axis
from matplotlib import axes
Expand Down
5 changes: 4 additions & 1 deletion lib/matplotlib/pylab.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -219,7 +219,10 @@
from cbook import flatten, is_string_like, exception_to_str, \
silent_list, iterable, dedent

from matplotlib import mpl # pulls in most modules
import matplotlib as mpl
# make mpl.finance module available for backwards compatability, in case folks
# using pylab interface depended on not having to import it
import matplotlib.finance

from matplotlib.dates import date2num, num2date,\
datestr2num, strpdate2num, drange,\
Expand Down
0