Error on empty offsets in get_path_collection_extents

oscargus · oscargus · commit 4c1eda78d3e1 · 2022-06-09T20:01:30.000+02: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
@@ -1065,6 +1065,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.6", 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)
