"""
Public API classes that store intermediate results useful for type-hinting.
"""

from typing import TYPE_CHECKING

from pandas._libs import NaTType
from pandas._libs.lib import NoDefault
from pandas._libs.missing import NAType

from pandas.core.col import Expression
from pandas.core.groupby import (
    DataFrameGroupBy,
    SeriesGroupBy,
)
from pandas.core.indexes.frozen import FrozenList
from pandas.core.resample import (
    DatetimeIndexResamplerGroupBy,
    PeriodIndexResamplerGroupBy,
    Resampler,
    TimedeltaIndexResamplerGroupBy,
    TimeGrouper,
)
from pandas.core.window import (
    Expanding,
    ExpandingGroupBy,
    ExponentialMovingWindow,
    ExponentialMovingWindowGroupBy,
    Rolling,
    RollingGroupBy,
    Window,
)

# TODO: Can't import Styler without importing jinja2
# from pandas.io.formats.style import Styler
from pandas.io.json._json import JsonReader
from pandas.io.sas.sasreader import SASReader
from pandas.io.stata import StataReader

__all__ = [
    "DataFrameGroupBy",
    "DatetimeIndexResamplerGroupBy",
    "Expanding",
    "ExpandingGroupBy",
    "ExponentialMovingWindow",
    "ExponentialMovingWindowGroupBy",
    "Expression",
    "FrozenList",
    "JsonReader",
    "NAType",
    "NaTType",
    "NoDefault",
    "PeriodIndexResamplerGroupBy",
    "Resampler",
    "Rolling",
    "RollingGroupBy",
    "SASReader",
    "SeriesGroupBy",
    "StataReader",
    "TimeGrouper",
    "TimedeltaIndexResamplerGroupBy",
    "Window",
]


if TYPE_CHECKING:
    # GH#49578 this module exists for type-hinting, so annotating with a
    # deprecated spelling has to keep working until it is removed. Binding these
    # unconditionally would instead put them back in the public namespace.
    DatetimeIndexResamplerGroupby = DatetimeIndexResamplerGroupBy
    ExpandingGroupby = ExpandingGroupBy
    ExponentialMovingWindowGroupby = ExponentialMovingWindowGroupBy
    PeriodIndexResamplerGroupby = PeriodIndexResamplerGroupBy
    RollingGroupby = RollingGroupBy
    TimedeltaIndexResamplerGroupby = TimedeltaIndexResamplerGroupBy
else:
    # would otherwise land in the public namespace; see test_api_typing
    del TYPE_CHECKING

    def __getattr__(name: str) -> object:
        deprecated = {
            "DatetimeIndexResamplerGroupby": DatetimeIndexResamplerGroupBy,
            "ExpandingGroupby": ExpandingGroupBy,
            "ExponentialMovingWindowGroupby": ExponentialMovingWindowGroupBy,
            "PeriodIndexResamplerGroupby": PeriodIndexResamplerGroupBy,
            "RollingGroupby": RollingGroupBy,
            "TimedeltaIndexResamplerGroupby": TimedeltaIndexResamplerGroupBy,
        }
        if name in deprecated:
            # imported here rather than at module level, which would expose
            # them as pandas.api.typing attributes
            import warnings

            from pandas.errors import Pandas4Warning

            new = deprecated[name]
            warnings.warn(
                f"pandas.api.typing.{name} is deprecated and will be removed in "
                f"a future version. Use pandas.api.typing.{new.__name__} instead.",
                Pandas4Warning,
                stacklevel=2,
            )
            return new
        raise AttributeError(f"module 'pandas.api.typing' has no attribute '{name}'")