Annotate API-exposed Items from pandas.core.api

[WillAyd]

We currently expose all of the following items from pandas.core.api via the API:

from pandas.core.api import (
    # dtype
    Int8Dtype, Int16Dtype, Int32Dtype, Int64Dtype, UInt8Dtype,
    UInt16Dtype, UInt32Dtype, UInt64Dtype, CategoricalDtype,
    PeriodDtype, IntervalDtype, DatetimeTZDtype,

    # missing
    isna, isnull, notna, notnull,

    # indexes
    Index, CategoricalIndex, Int64Index, UInt64Index, RangeIndex,
    Float64Index, MultiIndex, IntervalIndex, TimedeltaIndex,
    DatetimeIndex, PeriodIndex, IndexSlice,

    # tseries
    NaT, Period, period_range, Timedelta, timedelta_range,
    Timestamp, date_range, bdate_range, Interval, interval_range,
    DateOffset,

    # conversion
    to_numeric, to_datetime, to_timedelta,

    # misc
    np, Grouper, factorize, unique, value_counts, NamedAgg,
    array, Categorical, set_eng_float_format, Series, DataFrame,
    Panel)

A pseudo-prioritized list of annotations I think we need out of this would be the below. Open to suggestions on how to prioritize and obviously community PRs are very welcome!

• DataFrame
• Series
• Index
• MultiIndex
• Categorical
• CategoricalIndex
• Datetimelike indices
• Numeric indices

...

These don't necessarily need to be completed in order. Will continue to expand checklist as we tackle more items so if you see something you'd like to tackle feel free to call it out

[WillAyd]

@vaibhavhrt @gwrome

[vaibhavhrt]

@WillAyd I am not sure what exactly needs to be done. Do we need to annotate every attribute/method of class DataFrame, Index, etc.? Can you provide some example(mypy docs or SO link maybe)

[WillAyd]

Yes that's correct - would want to add annotations to the methods for these objects (and attributes where inference may not work)

[vaibhavhrt]

Alright, I will start with DataFrame, since it's one of the few things in pandas I use in my projects. I will open a new issue for it.

…

On Tue, 11 Jun 2019, 12:23 am William Ayd, ***@***.***> wrote: Yes that's correct - would want to add annotations to the methods for these objects (and attributes where inference may not work) — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#26766?email_source=notifications&email_token=AFMJMLEF6TVCQMNDJMFMZDTPZ2PJDA5CNFSM4HWTSJS2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODXK3MQQ#issuecomment-500545090>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AFMJMLG2ABH4VDJNDYY4JVTPZ2PJDANCNFSM4HWTSJSQ> .

[TomAugspurger]

I'm unpinning this to make room for #31879. Will re-pin tomorrow.