Merge pull request matplotlib#19517 from anntzer/unurl

Deprecate toplevel is_url, URL_REGEX helpers.

Author: QuLogic

doc/api/next_api_changes/deprecations/19517-AL.rst

@@ -0,0 +1,4 @@
+``is_url`` and ``URL_REGEX``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... are deprecated.  (They were previously defined in the toplevel
+:mod:`matplotlib` module.)

lib/matplotlib/__init__.py

@@ -665,9 +665,11 @@ def rc_params(fail_on_error=False):
     return rc_params_from_file(matplotlib_fname(), fail_on_error)
 
 
+# Deprecated in Matplotlib 3.5.
 URL_REGEX = re.compile(r'^http://|^https://|^ftp://|^file:')
 
 
+@_api.deprecated("3.5")
 def is_url(filename):
     """Return whether *filename* is an http, https, ftp, or file URL path."""
     return URL_REGEX.match(filename) is not None
@@ -686,7 +688,8 @@ def _get_ssl_context():
 
 @contextlib.contextmanager
 def _open_file_or_url(fname):
-    if not isinstance(fname, Path) and is_url(fname):
+    if (isinstance(fname, str)
+            and fname.startswith(('http://', 'https://', 'ftp://', 'file:'))):
         import urllib.request
         ssl_ctx = _get_ssl_context()
         if ssl_ctx is None: