Added pandas.errors.InvalidIndexError

Author: horta

doc/source/whatsnew/v1.1.0.rst

@@ -382,7 +382,7 @@ Other API changes
 - ``loc`` lookups with an object-dtype :class:`Index` and an integer key will now raise ``KeyError`` instead of ``TypeError`` when key is missing (:issue:`31905`)
 - Using a :func:`pandas.api.indexers.BaseIndexer` with ``count``, ``min``, ``max``, ``median``, ``skew``,  ``cov``, ``corr`` will now return correct results for any monotonic :func:`pandas.api.indexers.BaseIndexer` descendant (:issue:`32865`)
 - Added a :func:`pandas.api.indexers.FixedForwardWindowIndexer` class to support forward-looking windows during ``rolling`` operations.
--
+- Added :class:`pandas.errors.InvalidIndexError` (:issue:`34570`).
 
 Backwards incompatible API changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

pandas/core/generic.py

@@ -47,7 +47,7 @@
 from pandas.compat import set_function_name
 from pandas.compat._optional import import_optional_dependency
 from pandas.compat.numpy import function as nv
-from pandas.errors import AbstractMethodError
+from pandas.errors import AbstractMethodError, InvalidIndexError
 from pandas.util._decorators import (
     Appender,
     Substitution,
@@ -92,7 +92,6 @@
 from pandas.core.construction import create_series_with_explicit_dtype
 from pandas.core.indexes.api import (
     Index,
-    InvalidIndexError,
     MultiIndex,
     RangeIndex,
     ensure_index,

pandas/core/groupby/grouper.py

@@ -26,8 +26,8 @@
 from pandas.core.groupby import ops
 from pandas.core.groupby.categorical import recode_for_groupby, recode_from_groupby
 from pandas.core.indexes.api import CategoricalIndex, Index, MultiIndex
-from pandas.core.indexes.base import InvalidIndexError
 from pandas.core.series import Series
+from pandas.errors import InvalidIndexError
 
 from pandas.io.formats.printing import pprint_thing
 

pandas/core/index.py

@@ -7,7 +7,6 @@
     Index,
     Int64Index,
     IntervalIndex,
-    InvalidIndexError,
     MultiIndex,
     NaT,
     NumericIndex,
@@ -21,6 +20,7 @@
     get_objs_combined_axis,
 )
 from pandas.core.indexes.multi import _sparsify  # noqa:F401
+from pandas.errors import InvalidIndexError
 
 # GH#30193
 warnings.warn(
@@ -29,3 +29,5 @@
     FutureWarning,
     stacklevel=2,
 )
+
+__all__ = ["InvalidIndexError"]

pandas/core/indexes/api.py

@@ -6,7 +6,6 @@
 import pandas.core.common as com
 from pandas.core.indexes.base import (
     Index,
-    InvalidIndexError,
     _new_Index,
     ensure_index,
     ensure_index_from_sequences,
@@ -24,6 +23,7 @@
 from pandas.core.indexes.period import PeriodIndex
 from pandas.core.indexes.range import RangeIndex
 from pandas.core.indexes.timedeltas import TimedeltaIndex
+from pandas.errors import InvalidIndexError
 
 _sort_msg = textwrap.dedent(
     """\

pandas/core/indexes/base.py

@@ -17,6 +17,7 @@
 from pandas.compat import set_function_name
 from pandas.compat.numpy import function as nv
 from pandas.util._decorators import Appender, Substitution, cache_readonly, doc
+from pandas.errors import InvalidIndexError
 
 from pandas.core.dtypes import concat as _concat
 from pandas.core.dtypes.cast import (
@@ -153,10 +154,6 @@ def index_arithmetic_method(self, other):
     return set_function_name(index_arithmetic_method, name, cls)
 
 
-class InvalidIndexError(Exception):
-    pass
-
-
 _o_dtype = np.dtype(object)
 _Identity = object
 

pandas/core/indexes/datetimes.py

@@ -24,10 +24,11 @@
 
 from pandas.core.arrays.datetimes import DatetimeArray, tz_to_dtype
 import pandas.core.common as com
-from pandas.core.indexes.base import Index, InvalidIndexError, maybe_extract_name
+from pandas.core.indexes.base import Index, maybe_extract_name
 from pandas.core.indexes.datetimelike import DatetimeTimedeltaMixin
 from pandas.core.indexes.extension import inherit_names
 from pandas.core.tools.times import to_time
+from pandas.errors import InvalidIndexError
 
 
 def _new_DatetimeIndex(cls, d):

pandas/core/indexes/interval.py

@@ -44,7 +44,6 @@
 import pandas.core.indexes.base as ibase
 from pandas.core.indexes.base import (
     Index,
-    InvalidIndexError,
     _index_shared_docs,
     default_pprint,
     ensure_index,
@@ -55,6 +54,7 @@
 from pandas.core.indexes.multi import MultiIndex
 from pandas.core.indexes.timedeltas import TimedeltaIndex, timedelta_range
 from pandas.core.ops import get_op_result_name
+from pandas.errors import InvalidIndexError
 
 from pandas.tseries.offsets import DateOffset
 

pandas/core/indexes/multi.py

@@ -20,7 +20,7 @@
 from pandas._libs.hashtable import duplicated_int64
 from pandas._typing import AnyArrayLike, Scalar
 from pandas.compat.numpy import function as nv
-from pandas.errors import PerformanceWarning, UnsortedIndexError
+from pandas.errors import PerformanceWarning, UnsortedIndexError, InvalidIndexError
 from pandas.util._decorators import Appender, cache_readonly, doc
 
 from pandas.core.dtypes.cast import coerce_indexer_dtype
@@ -47,7 +47,6 @@
 import pandas.core.indexes.base as ibase
 from pandas.core.indexes.base import (
     Index,
-    InvalidIndexError,
     _index_shared_docs,
     ensure_index,
 )

pandas/core/indexes/period.py

@@ -32,7 +32,6 @@
 import pandas.core.common as com
 import pandas.core.indexes.base as ibase
 from pandas.core.indexes.base import (
-    InvalidIndexError,
     _index_shared_docs,
     ensure_index,
     maybe_extract_name,
@@ -42,6 +41,7 @@
 from pandas.core.indexes.extension import inherit_names
 from pandas.core.indexes.numeric import Int64Index
 from pandas.core.ops import get_op_result_name
+from pandas.errors import InvalidIndexError
 
 from pandas.tseries.offsets import DateOffset, Tick
 

pandas/core/indexes/timedeltas.py

@@ -18,12 +18,13 @@
 from pandas.core.arrays import datetimelike as dtl
 from pandas.core.arrays.timedeltas import TimedeltaArray
 import pandas.core.common as com
-from pandas.core.indexes.base import Index, InvalidIndexError, maybe_extract_name
+from pandas.core.indexes.base import Index, maybe_extract_name
 from pandas.core.indexes.datetimelike import (
     DatetimeIndexOpsMixin,
     DatetimeTimedeltaMixin,
 )
 from pandas.core.indexes.extension import inherit_names
+from pandas.errors import InvalidIndexError
 
 
 @inherit_names(

pandas/core/indexing.py

@@ -4,7 +4,7 @@
 
 from pandas._libs.indexing import _NDFrameIndexerBase
 from pandas._libs.lib import item_from_zerodim
-from pandas.errors import AbstractMethodError
+from pandas.errors import AbstractMethodError, InvalidIndexError
 from pandas.util._decorators import doc
 
 from pandas.core.dtypes.common import (
@@ -29,7 +29,7 @@
     is_list_like_indexer,
     length_of_indexer,
 )
-from pandas.core.indexes.api import Index, InvalidIndexError
+from pandas.core.indexes.api import Index
 
 if TYPE_CHECKING:
     from pandas import DataFrame  # noqa:F401

pandas/core/series.py

@@ -82,7 +82,6 @@
 from pandas.core.indexes.api import (
     Float64Index,
     Index,
-    InvalidIndexError,
     MultiIndex,
     ensure_index,
 )
@@ -95,6 +94,7 @@
 from pandas.core.sorting import ensure_key_mapped
 from pandas.core.strings import StringMethods
 from pandas.core.tools.datetimes import to_datetime
+from pandas.errors import InvalidIndexError
 
 import pandas.io.formats.format as fmt
 import pandas.plotting

pandas/errors/__init__.py

@@ -200,3 +200,9 @@ class NumbaUtilError(Exception):
     """
     Error raised for unsupported Numba engine routines.
     """
+
+
+class InvalidIndexError(Exception):
+    """
+    Exception raised when attemping to use an invalid index key.
+    """

pandas/tests/indexes/common.py

@@ -25,8 +25,8 @@
     isna,
 )
 import pandas._testing as tm
-from pandas.core.indexes.base import InvalidIndexError
 from pandas.core.indexes.datetimelike import DatetimeIndexOpsMixin
+from pandas.errors import InvalidIndexError
 
 
 class Base:

pandas/tests/indexes/datetimes/test_indexing.py

@@ -6,7 +6,7 @@
 import pandas as pd
 from pandas import DatetimeIndex, Index, Timestamp, date_range, notna
 import pandas._testing as tm
-from pandas.core.indexes.base import InvalidIndexError
+from pandas.errors import InvalidIndexError
 
 from pandas.tseries.offsets import BDay, CDay
 

pandas/tests/indexes/interval/test_indexing.py

@@ -12,7 +12,7 @@
     timedelta_range,
 )
 import pandas._testing as tm
-from pandas.core.indexes.base import InvalidIndexError
+from pandas.errors import InvalidIndexError
 
 
 class TestGetLoc:

pandas/tests/indexes/interval/test_interval.py

@@ -19,7 +19,7 @@
 )
 import pandas._testing as tm
 import pandas.core.common as com
-from pandas.core.indexes.base import InvalidIndexError
+from pandas.errors import InvalidIndexError
 
 
 @pytest.fixture(scope="class", params=[None, "foo"])

pandas/tests/indexes/multi/test_indexing.py

@@ -6,7 +6,7 @@
 import pandas as pd
 from pandas import Categorical, Index, MultiIndex, date_range
 import pandas._testing as tm
-from pandas.core.indexes.base import InvalidIndexError
+from pandas.errors import InvalidIndexError
 
 
 class TestSliceLocs:

pandas/tests/indexes/period/test_indexing.py

@@ -19,7 +19,7 @@
     period_range,
 )
 import pandas._testing as tm
-from pandas.core.indexes.base import InvalidIndexError
+from pandas.errors import InvalidIndexError
 
 
 class TestGetItem:

pandas/tests/resample/test_period_index.py

@@ -11,7 +11,7 @@
 import pandas as pd
 from pandas import DataFrame, Series, Timestamp
 import pandas._testing as tm
-from pandas.core.indexes.base import InvalidIndexError
+from pandas.errors import InvalidIndexError
 from pandas.core.indexes.datetimes import date_range
 from pandas.core.indexes.period import Period, PeriodIndex, period_range
 from pandas.core.resample import _get_period_range_edges