Deprecate empty offsets in get_path_collection_extents

oscargus · oscargus · commit f7526ba4ceb4 · 2023-03-12T17:48:11.000+01:00
diff --git a/doc/api/next_api_changes/deprecations/23200-OG.rst b/doc/api/next_api_changes/deprecations/23200-OG.rst
@@ -0,0 +1,6 @@
+Calling ``paths.get_path_collection_extents`` with empty *offsets*
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Calling  `~.get_path_collection_extents` with an empty *offsets* parameter
+has an ambiguous interpretation and is therefore deprecated. When the
+deprecation period expires, this will produce an error.
diff --git a/lib/matplotlib/path.py b/lib/matplotlib/path.py
@@ -1068,6 +1068,11 @@ def get_path_collection_extents(
     from .transforms import Bbox
     if len(paths) == 0:
         raise ValueError("No paths provided")
+    if len(offsets) == 0:
+        _api.warn_deprecated(
+            "3.8", message="Calling get_path_collection_extents() with an"
+            " empty offsets list is deprecated since %(since)s. Support will"
+            " be removed %(removal)s.")
     extents, minpos = _path.get_path_collection_extents(
         master_transform, paths, np.atleast_3d(transforms),
         offsets, offset_transform)
