diff --git a/doc/api/next_api_changes/2019-03-29-AL.rst b/doc/api/next_api_changes/2019-03-29-AL.rst new file mode 100644 index 000000000000..675218e2d93a --- /dev/null +++ b/doc/api/next_api_changes/2019-03-29-AL.rst @@ -0,0 +1,7 @@ +Deprecations +```````````` + +The ``matplotlib.testing.disable_internet`` module is deprecated. Use (for +example) pytest-remotedata_ instead. + +.. _pytest-remotedata: https://pypi.org/project/pytest-remotedata/ diff --git a/doc/api/testing_api.rst b/doc/api/testing_api.rst index a1c800ee04c2..7731d4510b27 100644 --- a/doc/api/testing_api.rst +++ b/doc/api/testing_api.rst @@ -30,15 +30,6 @@ :show-inheritance: -:mod:`matplotlib.testing.disable_internet` -========================================== - -.. automodule:: matplotlib.testing.disable_internet - :members: - :undoc-members: - :show-inheritance: - - :mod:`matplotlib.testing.exceptions` ==================================== diff --git a/lib/matplotlib/testing/disable_internet.py b/lib/matplotlib/testing/disable_internet.py index 4a72317b21c6..7ad46cd90f97 100644 --- a/lib/matplotlib/testing/disable_internet.py +++ b/lib/matplotlib/testing/disable_internet.py @@ -4,6 +4,10 @@ import contextlib import socket +from matplotlib import cbook +cbook.warn_deprecated("3.2", name=__name__, obj_type="module", + alternative="pytest-remotedata") + # save original socket method for restoration # These are global so that re-calling the turn_off_internet function doesn't # overwrite them again