DEPR: pd.Grouper key -> on

[jreback]

xref #15326 (comment)

• when pd.Grouper was introduced, we used key to indicate the column which to group on
• .resample added the same idea as on
• we use on in pd.merge (existing for a long time)
• .groupby uses by (though to be fair this can take lots of things and is not strictly a string column name).

So the proposal is to deprecate pd.Grouper(key=...) in favor of on=.

[jreback]

@chrisaycock gives +1
@jorisvandenbossche -0
@jreback +1

[chrisaycock]

pd.merge_asof() has both on and by parameters.

[jreback]

any thoughts about whether we should do this (at some point)?

@TomAugspurger @jorisvandenbossche

[TomAugspurger]

No strong opinion.

[jbrockmendel]

Any clarity on this?