Fix docs for indexers.py

Author: ShaharNaveh

ci/code_checks.sh

@@ -166,6 +166,10 @@ if [[ -z "$CHECK" || "$CHECK" == "doctests" ]]; then
     pytest -q --doctest-modules pandas/core/generic.py
     RET=$(($RET + $?)) ; echo $MSG "DONE"
 
+    MSG='Doctests indexers.py' ; echo $MSG
+    pytest -q --doctest-modules pandas/core/indexers.py
+    RET=$(($RET + $?)) ; echo $MSG "DONE"
+
     MSG='Doctests nanops.py' ; echo $MSG
     pytest -q --doctest-modules pandas/core/nanops.py
     RET=$(($RET + $?)) ; echo $MSG "DONE"

pandas/core/indexers.py

@@ -209,16 +209,21 @@ def validate_indices(indices: np.ndarray, n: int) -> None:
 
     Examples
     --------
-    >>> validate_indices([1, 2], 3)
-    # OK
-    >>> validate_indices([1, -2], 3)
-    ValueError
-    >>> validate_indices([1, 2, 3], 3)
-    IndexError
-    >>> validate_indices([-1, -1], 0)
-    # OK
-    >>> validate_indices([0, 1], 0)
-    IndexError
+    >>> validate_indices(np.ndarray([1, 2]), 3) # OK
+
+    >>> validate_indices(np.ndarray([1, -2]), 3)
+    Traceback (most recent call last):
+        ...
+    ValueError: negative dimensions are not allowed
+
+    >>> validate_indices(np.ndarray([1, 2, 3]), 3) # OK
+
+    >>> validate_indices(np.ndarray([-1, -1]), 0)
+    Traceback (most recent call last):
+        ...
+    ValueError: negative dimensions are not allowed
+
+    >>> validate_indices(np.ndarray([0, 1]), 0) # OK
     """
     if len(indices):
         min_idx = indices.min()