revert some __init__ changes

Author: MarcoGorelli

.pre-commit-config.yaml

@@ -146,11 +146,13 @@ repos:
 
             # Check for deprecated messages without sphinx directive
             |(DEPRECATED|DEPRECATE|Deprecated)(:|,|\.)
-
-            # Check for e.g. ``stacklevel=5`` instead of
-            # ``stacklevel=find_stack_level(inspect.currentframe())``
-            |stacklevel=\d+
         types_or: [python, cython, rst]
+    -   id: stacklevel
+        name: Use find_stack_level instead of setting stacklevel manually
+        language: pygrep
+        entry: 'stacklevel=\d+'
+        types_or: [python, cython, rst]
+        exclude: pandas/__init__\.py
     -   id: cython-casting
         name: Check Cython casting is `<type>obj`, not `<type> obj`
         language: pygrep

pandas/__init__.py

@@ -1,7 +1,5 @@
 from __future__ import annotations
 
-import inspect
-
 __docformat__ = "restructuredtext"
 
 # Let users know if they're missing any of our hard dependencies
@@ -24,11 +22,7 @@
 from pandas.compat import is_numpy_dev as _is_numpy_dev  # pyright: ignore # noqa:F401
 
 try:
-    from pandas._libs import (
-        hashtable as _hashtable,
-        lib as _lib,
-        tslib as _tslib,
-    )
+    from pandas._libs import hashtable as _hashtable, lib as _lib, tslib as _tslib
 except ImportError as _err:  # pragma: no cover
     _module = _err.name
     raise ImportError(
@@ -40,137 +34,148 @@
     del _tslib, _lib, _hashtable
 
 from pandas._config import (
-    describe_option,
     get_option,
+    set_option,
+    reset_option,
+    describe_option,
     option_context,
     options,
-    reset_option,
-    set_option,
 )
 
-from pandas.util._print_versions import show_versions
-from pandas.util._tester import test
-
-from pandas import (
-    api,
-    arrays,
-    errors,
-    io,
-    plotting,
-    tseries,
-)
-from pandas import testing  # noqa:PDF015
+# let init-time option registration happen
+import pandas.core.config_init  # pyright: ignore # noqa:F401
 
-# use the closest tagged version if possible
-from pandas._version import get_versions
-from pandas.core.api import (  # dtype; missing; indexes; tseries; conversion; misc
-    NA,
-    BooleanDtype,
-    Categorical,
-    CategoricalDtype,
-    CategoricalIndex,
-    DataFrame,
-    DateOffset,
-    DatetimeIndex,
-    DatetimeTZDtype,
-    Flags,
-    Float32Dtype,
-    Float64Dtype,
-    Grouper,
-    Index,
-    IndexSlice,
+from pandas.core.api import (
+    # dtype
     Int8Dtype,
     Int16Dtype,
     Int32Dtype,
     Int64Dtype,
-    Interval,
-    IntervalDtype,
-    IntervalIndex,
-    MultiIndex,
-    NamedAgg,
-    NaT,
-    Period,
-    PeriodDtype,
-    PeriodIndex,
-    RangeIndex,
-    Series,
-    StringDtype,
-    Timedelta,
-    TimedeltaIndex,
-    Timestamp,
     UInt8Dtype,
     UInt16Dtype,
     UInt32Dtype,
     UInt64Dtype,
-    array,
-    bdate_range,
-    date_range,
-    factorize,
-    interval_range,
+    Float32Dtype,
+    Float64Dtype,
+    CategoricalDtype,
+    PeriodDtype,
+    IntervalDtype,
+    DatetimeTZDtype,
+    StringDtype,
+    BooleanDtype,
+    # missing
+    NA,
     isna,
     isnull,
     notna,
     notnull,
+    # indexes
+    Index,
+    CategoricalIndex,
+    RangeIndex,
+    MultiIndex,
+    IntervalIndex,
+    TimedeltaIndex,
+    DatetimeIndex,
+    PeriodIndex,
+    IndexSlice,
+    # tseries
+    NaT,
+    Period,
     period_range,
-    set_eng_float_format,
+    Timedelta,
     timedelta_range,
-    to_datetime,
+    Timestamp,
+    date_range,
+    bdate_range,
+    Interval,
+    interval_range,
+    DateOffset,
+    # conversion
     to_numeric,
+    to_datetime,
     to_timedelta,
+    # misc
+    Flags,
+    Grouper,
+    factorize,
     unique,
     value_counts,
+    NamedAgg,
+    array,
+    Categorical,
+    set_eng_float_format,
+    Series,
+    DataFrame,
 )
+
 from pandas.core.arrays.sparse import SparseDtype
+
+from pandas.tseries.api import infer_freq
+from pandas.tseries import offsets
+
 from pandas.core.computation.api import eval
 
-# let init-time option registration happen
-import pandas.core.config_init  # pyright: ignore # noqa:F401
 from pandas.core.reshape.api import (
     concat,
-    crosstab,
-    cut,
-    from_dummies,
-    get_dummies,
     lreshape,
     melt,
+    wide_to_long,
     merge,
     merge_asof,
     merge_ordered,
+    crosstab,
     pivot,
     pivot_table,
+    get_dummies,
+    from_dummies,
+    cut,
     qcut,
-    wide_to_long,
 )
 
-from pandas.io.api import (  # excel; parsers; pickle; pytables; sql; misc
+from pandas import api, arrays, errors, io, plotting, tseries
+from pandas import testing  # noqa:PDF015
+from pandas.util._print_versions import show_versions
+
+from pandas.io.api import (
+    # excel
     ExcelFile,
     ExcelWriter,
+    read_excel,
+    # parsers
+    read_csv,
+    read_fwf,
+    read_table,
+    # pickle
+    read_pickle,
+    to_pickle,
+    # pytables
     HDFStore,
+    read_hdf,
+    # sql
+    read_sql,
+    read_sql_query,
+    read_sql_table,
+    # misc
     read_clipboard,
-    read_csv,
-    read_excel,
+    read_parquet,
+    read_orc,
     read_feather,
-    read_fwf,
     read_gbq,
-    read_hdf,
     read_html,
+    read_xml,
     read_json,
-    read_orc,
-    read_parquet,
-    read_pickle,
+    read_stata,
     read_sas,
     read_spss,
-    read_sql,
-    read_sql_query,
-    read_sql_table,
-    read_stata,
-    read_table,
-    read_xml,
-    to_pickle,
 )
+
 from pandas.io.json import _json_normalize as json_normalize
-from pandas.tseries import offsets
-from pandas.tseries.api import infer_freq
+
+from pandas.util._tester import test
+
+# use the closest tagged version if possible
+from pandas._version import get_versions
 
 v = get_versions()
 __version__ = v.get("closest-tag", v["version"])
@@ -190,21 +195,16 @@ def __dir__() -> list[str]:
 
 def __getattr__(name):
     import warnings
-    from pandas.util._exceptions import find_stack_level
 
     if name in __deprecated_num_index_names:
         warnings.warn(
             f"pandas.{name} is deprecated "
             "and will be removed from pandas in a future version. "
             "Use pandas.Index with the appropriate dtype instead.",
             FutureWarning,
-            stacklevel=find_stack_level(inspect.currentframe()),
-        )
-        from pandas.core.api import (
-            Float64Index,
-            Int64Index,
-            UInt64Index,
+            stacklevel=2,
         )
+        from pandas.core.api import Float64Index, Int64Index, UInt64Index
 
         return {
             "Float64Index": Float64Index,
@@ -217,7 +217,7 @@ def __getattr__(name):
             "and will be removed from pandas in a future version. "
             "Import from datetime module instead.",
             FutureWarning,
-            stacklevel=find_stack_level(inspect.currentframe()),
+            stacklevel=2,
         )
 
         from datetime import datetime as dt
@@ -231,7 +231,7 @@ def __getattr__(name):
             "and will be removed from pandas in a future version. "
             "Import numpy directly instead.",
             FutureWarning,
-            stacklevel=find_stack_level(inspect.currentframe()),
+            stacklevel=2,
         )
         import numpy as np
 
@@ -242,7 +242,7 @@ def __getattr__(name):
             f"The {name} class is removed from pandas. Accessing it from "
             "the top-level namespace will also be removed in the next version.",
             FutureWarning,
-            stacklevel=find_stack_level(inspect.currentframe()),
+            stacklevel=2,
         )
 
         return type(name, (), {})
@@ -254,7 +254,7 @@ def __getattr__(name):
             "and will be removed from pandas in a future version. "
             "Use pandas.arrays.SparseArray instead.",
             FutureWarning,
-            stacklevel=find_stack_level(inspect.currentframe()),
+            stacklevel=2,
         )
         from pandas.core.arrays.sparse import SparseArray as _SparseArray