BUG: Index.get_loc always raise InvalidIndexError on listlike (pandas-dev#45181)

Author: jbrockmendel

pandas/core/frame.py

@@ -3464,7 +3464,8 @@ def __getitem__(self, key):
         key = lib.item_from_zerodim(key)
         key = com.apply_if_callable(key, self)
 
-        if is_hashable(key):
+        if is_hashable(key) and not is_iterator(key):
+            # is_iterator to exclude generator e.g. test_getitem_listlike
             # shortcut if the key is in columns
             if self.columns.is_unique and key in self.columns:
                 if isinstance(self.columns, MultiIndex):

pandas/core/indexes/base.py

@@ -3600,6 +3600,12 @@ def get_loc(self, key, method=None, tolerance=None):
                 return self._engine.get_loc(casted_key)
             except KeyError as err:
                 raise KeyError(key) from err
+            except TypeError:
+                # If we have a listlike key, _check_indexing_error will raise
+                #  InvalidIndexError. Otherwise we fall through and re-raise
+                #  the TypeError.
+                self._check_indexing_error(key)
+                raise
 
         # GH#42269
         warnings.warn(

pandas/core/indexes/multi.py

@@ -2815,7 +2815,7 @@ def get_loc(self, key, method=None):
                 "currently supported for MultiIndex"
             )
 
-        hash(key)
+        self._check_indexing_error(key)
 
         def _maybe_to_slice(loc):
             """convert integer indexer to boolean mask or slice if possible"""

pandas/core/series.py

@@ -966,7 +966,9 @@ def __getitem__(self, key):
 
                 return result
 
-            except (KeyError, TypeError):
+            except (KeyError, TypeError, InvalidIndexError):
+                # InvalidIndexError for e.g. generator
+                #  see test_series_getitem_corner_generator
                 if isinstance(key, tuple) and isinstance(self.index, MultiIndex):
                     # We still have the corner case where a tuple is a key
                     # in the first level of our MultiIndex

pandas/tests/frame/indexing/test_indexing.py

@@ -8,6 +8,7 @@
 import pytest
 
 from pandas._libs import iNaT
+from pandas.errors import InvalidIndexError
 import pandas.util._test_decorators as td
 
 from pandas.core.dtypes.common import is_integer
@@ -1171,7 +1172,7 @@ def test_type_error_multiindex(self):
         dg = DataFrame(
             [[1, 1, 2, 2], [3, 3, 4, 4]], columns=mi, index=Index([0, 1], name="i")
         )
-        with pytest.raises(TypeError, match="unhashable type"):
+        with pytest.raises(InvalidIndexError, match="slice"):
             dg[:, 0]
 
         index = Index(range(2), name="i")

pandas/tests/indexes/multi/test_indexing.py

@@ -652,7 +652,7 @@ def test_get_loc_missing_nan(self):
             idx.get_loc(3)
         with pytest.raises(KeyError, match=r"^nan$"):
             idx.get_loc(np.nan)
-        with pytest.raises(TypeError, match="unhashable type: 'list'"):
+        with pytest.raises(InvalidIndexError, match=r"\[nan\]"):
             # listlike/non-hashable raises TypeError
             idx.get_loc([np.nan])
 
@@ -699,8 +699,8 @@ def test_get_loc_past_lexsort_depth(self):
     def test_multiindex_get_loc_list_raises(self):
         # GH#35878
         idx = MultiIndex.from_tuples([("a", 1), ("b", 2)])
-        msg = "unhashable type"
-        with pytest.raises(TypeError, match=msg):
+        msg = r"\[\]"
+        with pytest.raises(InvalidIndexError, match=msg):
             idx.get_loc([])
 
     def test_get_loc_nested_tuple_raises_keyerror(self):

pandas/tests/indexes/numeric/test_indexing.py

@@ -1,6 +1,8 @@
 import numpy as np
 import pytest
 
+from pandas.errors import InvalidIndexError
+
 from pandas import (
     Index,
     RangeIndex,
@@ -41,10 +43,12 @@ def test_get_loc_raises_bad_label(self, method):
         index = Index([0, 1, 2])
         if method:
             msg = "not supported between"
+            err = TypeError
         else:
-            msg = "invalid key"
+            msg = r"\[1, 2\]"
+            err = InvalidIndexError
 
-        with pytest.raises(TypeError, match=msg):
+        with pytest.raises(err, match=msg):
             index.get_loc([1, 2], method=method)
 
     @pytest.mark.parametrize(
@@ -141,7 +145,7 @@ def test_get_loc_missing_nan(self):
             idx.get_loc(3)
         with pytest.raises(KeyError, match="^nan$"):
             idx.get_loc(np.nan)
-        with pytest.raises(TypeError, match=r"'\[nan\]' is an invalid key"):
+        with pytest.raises(InvalidIndexError, match=r"\[nan\]"):
             # listlike/non-hashable raises TypeError
             idx.get_loc([np.nan])
 

pandas/tests/indexes/test_any_index.py

@@ -3,8 +3,11 @@
 """
 import re
 
+import numpy as np
 import pytest
 
+from pandas.errors import InvalidIndexError
+
 import pandas._testing as tm
 
 
@@ -125,6 +128,16 @@ def test_pickle_preserves_name(self, index):
 
 
 class TestIndexing:
+    def test_get_loc_listlike_raises_invalid_index_error(self, index):
+        # and never TypeError
+        key = np.array([0, 1], dtype=np.intp)
+
+        with pytest.raises(InvalidIndexError, match=r"\[0 1\]"):
+            index.get_loc(key)
+
+        with pytest.raises(InvalidIndexError, match=r"\[False  True\]"):
+            index.get_loc(key.astype(bool))
+
     def test_getitem_ellipsis(self, index):
         # GH#21282
         result = index[...]

pandas/tests/indexes/test_base.py

@@ -8,6 +8,7 @@
 import pytest
 
 from pandas.compat import IS64
+from pandas.errors import InvalidIndexError
 from pandas.util._test_decorators import async_mark
 
 import pandas as pd
@@ -398,11 +399,15 @@ def test_asof_numeric_vs_bool_raises(self):
         left = Index([1, 2, 3])
         right = Index([True, False])
 
-        msg = "'<' not supported between instances"
+        msg = "Cannot compare dtypes int64 and object"
         with pytest.raises(TypeError, match=msg):
+            left.asof(right[0])
+        # TODO: should right.asof(left[0]) also raise?
+
+        with pytest.raises(InvalidIndexError, match=re.escape(str(right))):
             left.asof(right)
 
-        with pytest.raises(TypeError, match=msg):
+        with pytest.raises(InvalidIndexError, match=re.escape(str(left))):
             right.asof(left)
 
     @pytest.mark.parametrize("index", ["string"], indirect=True)

pandas/tests/indexes/test_indexing.py

@@ -206,7 +206,14 @@ def test_get_loc_generator(self, index):
         exc = KeyError
         if isinstance(
             index,
-            (DatetimeIndex, TimedeltaIndex, PeriodIndex, RangeIndex, IntervalIndex),
+            (
+                DatetimeIndex,
+                TimedeltaIndex,
+                PeriodIndex,
+                RangeIndex,
+                IntervalIndex,
+                MultiIndex,
+            ),
         ):
             # TODO: make these more consistent?
             exc = InvalidIndexError