Rudimentary deprecation notice for extra.numpy.basic_indices()

hypothesis-python/src/hypothesis/extra/numpy.py

@@ -19,6 +19,7 @@
 import numpy as np
 
 from hypothesis import strategies as st
+from hypothesis._settings import note_deprecation
 from hypothesis.errors import InvalidArgument
 from hypothesis.extra._array_helpers import (
     NDIM_MAX,
@@ -822,8 +823,22 @@ def basic_indices(
 
     if max_dims is None:
         max_dims = min(max(len(shape), min_dims) + 2, NDIM_MAX)
+        deprecation_start = f"max_dims=None, which was defaulted to max_dims={max_dims},"
+    else:
+        deprecation_start = f"max_dims={max_dims}"
     check_type(int, max_dims, "max_dims")
     check_valid_dims(max_dims, "max_dims")
+    if max_dims > len(shape) and not allow_newaxis:
+        note_deprecation(
+            f"{deprecation_start} and allow_newaxis=False, so we cannot generate "
+            f"indices that would produce arrays with dimensions greater than "
+            f"len(shape)={len(shape)} i.e. the dimensions of the indexed array. "
+            f"In the next release, max_dims would default to the the dimensions "
+            f"of shape={shape!r} when allow_newaxis=False, and passing max_dims "
+            f"greater than len(shape) will raise an error.",
+            since="RELEASEDAY",
+            has_codemod=False,
+        )
 
     order_check("dims", 0, min_dims, max_dims)