Version 1.5 changes

[Dr-Irv]

Need to update stubs for version 1.5 based on docs in RC:
https://pandas.pydata.org/pandas-docs/version/1.5.0rc0/whatsnew/v1.5.0.html

[phofl]

How do you want to handle deprecations of arguments? Remove them from the stubs immediately?

[bashtage]

I think once we shift to 1.5 as the target we should fully target 1.5 including all deprecations.

[phofl]

So if argument x is deprecated we would just remove it from the stubs, correct?

[bashtage]

That is what we have been doing.

[Dr-Irv]

List of 1.5 things to handle. As these are addressed, put a check mark and edit this comment to indicate which PR addressed the issue:

Needs new issue

• Deprecated allowing dtype='datetime64' or dtype=np.datetime64 in Series.astype()

Complete

• pd.ArrowDtype ENH: Add more 1.5.0 features #338
• MultiIndex.to_frame() now supports the argument allow_duplicates ENH: Add more 1.5.0 features #338
• read_csv() now supports defaultdict as a dtype parameter ENH: Add more 1.5.0 features #338
• Add milliseconds field support for DateOffset ENH: Add more 1.5.0 features #338
• Added check_like argument to testing.assert_series_equal() ENH: Add more 1.5.0 features #338
• RangeIndex.union() now can return a RangeIndex instead of a Int64Index if the resulting values are equally spaced ENH: Add more 1.5.0 features #338
• times argument in ExponentialMovingWindow now accepts np.timedelta64 ENH: Add more 1.5.0 features #338
• The argument group_keys has been added to the method DataFrame.resample() 1.5 dataframe changes #334
• DataFrame.plot() will now allow the subplots parameter to be a list of iterables specifying column groups 1.5 dataframe changes #334
• Series.reset_index() and DataFrame.reset_index() now support the argument allow_duplicates 1.5 dataframe changes #334
• DataFrame.reset_index() now accepts a names argument 1.5 dataframe changes #334
• Added validate argument to DataFrame.join() 1.5 dataframe changes #334
• DataFrame.compare() now accepts an argument result_names 1.5 dataframe changes #334
• DataFrame.quantile() gained a method argument that can accept table 1.5 dataframe changes #334
• The method ExtensionArray.factorize() accepts use_na_sentinel=False
• add DataFrame.isetitem() 1.5 dataframe changes #334
• DataFrame.rolling() and Series.rolling() now support a step ENH: Add step to rolling #332
• [DataFrame.__dataframe__()] ENH: add from_dataframe and DataFrame #331
• pandas.api.interchange.from_dataframe() ENH: add from_dataframe and DataFrame #331
• Styler.concat() MAINT: Bump pandas to 1.5.0 #317
• Styler.to_string() MAINT: Bump pandas to 1.5.0 #317
• Styler.relabel_index() MAINT: Bump pandas to 1.5.0 #317
• Styler.highlight_null() now accepts color and deprecates null_color MAINT: Bump pandas to 1.5.0 #317
• pd.from_dummies ENH: Add from_dummies #330
• DataFrame.to_orc() MAINT: Bump pandas to 1.5.0 #317
• read_xml now supports dtype, converters, and parse_dates Already in
• read_xml now supports large XML using iterparse Already in
• Added numeric_only argument to DataFrame.corr(), DataFrame.corrwith(), DataFrame.cov(), DataFrame.idxmin(), DataFrame.idxmax(), DataFrameGroupBy.idxmin(), DataFrameGroupBy.idxmax(), GroupBy.var(), GroupBy.std(), GroupBy.sem(), and DataFrameGroupBy.quantile() MAINT: Bump pandas to 1.5.0 #317
• Added numeric_only argument to Resampler.sum(), Resampler.prod(), Resampler.min(), Resampler.max(), Resampler.first(), and Resampler.last() MAINT: Bump pandas to 1.5.0 #317
• DataError, SpecificationError, SettingWithCopyError, SettingWithCopyWarning, NumExprClobberingError, UndefinedVariableError, IndexingError, PyperclipException, PyperclipWindowsException, CSSWarning, PossibleDataLossError, ClosedFileError, IncompatibilityWarning, AttributeConflictWarning, DatabaseError, PossiblePrecisionLoss, ValueLabelTypeMismatch, InvalidColumnName, and CategoricalConversionWarning are now exposed in pandas.errors MAINT: Bump pandas to 1.5.0 #317
• Added copy keyword to Series.set_axis() and DataFrame.set_axis() MAINT: Bump pandas to 1.5.0 #317
• BigQuery I/O methods read_gbq() and DataFrame.to_gbq() default to auth_local_webserver = True. Google has deprecated the auth_local_webserver = False “out of band” (copy-paste) flow. MAINT: Bump pandas to 1.5.0 #317
• When read_sas() previously returned None, it now returns an empty DataFrame Not in pandas-stubs
• ExcelWriter public attributes:
  • book MAINT: Bump pandas to 1.5.0 #317
  • check_extension MAINT: Bump pandas to 1.5.0 #317
  • close MAINT: Bump pandas to 1.5.0 #317
  • date_format MAINT: Bump pandas to 1.5.0 #317
  • datetime_format MAINT: Bump pandas to 1.5.0 #317
  • engine MAINT: Bump pandas to 1.5.0 #317
  • if_sheet_exists MAINT: Bump pandas to 1.5.0 #317
  • sheets MAINT: Bump pandas to 1.5.0 #317
  • supported_extensions MAINT: Bump pandas to 1.5.0 #317
• ExcelWriter deprecated attributes: MAINT: Bump pandas to 1.5.0 #317
  • cur_sheet
  • handles
  • path
  • save
  • write_cells
• add numeric_only to following methods:
  • DataFrame.corr() MAINT: Bump pandas to 1.5.0 #317
  • DataFrame.corrwith() MAINT: Bump pandas to 1.5.0 #317
  • DataFrame.cov() MAINT: Bump pandas to 1.5.0 #317
  • DataFrame.idxmin() MAINT: Bump pandas to 1.5.0 #317
  • DataFrame.idxmax() MAINT: Bump pandas to 1.5.0 #317
  • DataFrameGroupBy.cummin() MAINT: Bump pandas to 1.5.0 #317
  • DataFrameGroupBy.cummax() MAINT: Bump pandas to 1.5.0 #317
  • DataFrameGroupBy.idxmin() MAINT: Bump pandas to 1.5.0 #317
  • DataFrameGroupBy.idxmax() MAINT: Bump pandas to 1.5.0 #317
  • GroupBy.var() MAINT: Bump pandas to 1.5.0 #317
  • GroupBy.std() MAINT: Bump pandas to 1.5.0 #317
  • GroupBy.sem() MAINT: Bump pandas to 1.5.0 #317
  • DataFrameGroupBy.quantile() MAINT: Bump pandas to 1.5.0 #317
  • Resampler.mean() MAINT: Bump pandas to 1.5.0 #317
  • Resampler.median()MAINT: Bump pandas to 1.5.0 #317
  • Resampler.sem()MAINT: Bump pandas to 1.5.0 #317
  • Resampler.std()MAINT: Bump pandas to 1.5.0 #317
  • Resampler.var()MAINT: Bump pandas to 1.5.0 #317
  • DataFrame.rolling() operations MAINT: Bump pandas to 1.5.0 #317
  • DataFrame.expanding() operations MAINT: Bump pandas to 1.5.0 #317
  • DataFrame.ewm() operations MAINT: Bump pandas to 1.5.0 #317
• Deprecated the keyword line_terminator in DataFrame.to_csv() and Series.to_csv() MAINT: Bump pandas to 1.5.0 #317
• Deprecated DataFrame.iteritems(), Series.iteritems(), HDFStore.iteritems() MAINT: Bump pandas to 1.5.0 #317
• Deprecated Series.is_monotonic() and Index.is_monotonic() MAINT: Bump pandas to 1.5.0 #317
• Deprecated the array_wrap method of DataFrame and Series MAINT: Bump pandas to 1.5.0 #317
• Deprecated the warn parameter in infer_freq() MAINT: Bump pandas to 1.5.0 #317
• Deprecated allowing non-keyword arguments in ExtensionArray.argsort() MAINT: Bump pandas to 1.5.0 #317
• Deprecated Timedelta.freq and Timedelta.is_populated Not in pandas-stubs
• Deprecated Timedelta.delta Not in pandas-stubs
• Deprecated passing arguments as positional in DataFrame.any() and Series.any() MAINT: Bump pandas to 1.5.0 #317
• Deprecated passing positional arguments to DataFrame.pivot() and pivot() except data MAINT: Bump pandas to 1.5.0 #317
• Deprecated the methods DataFrame.mad(), Series.mad(), and the corresponding groupby methods MAINT: Bump pandas to 1.5.0 #317
• Deprecated positional arguments to Index.join() except for other MAINT: Bump pandas to 1.5.0 #317
• Deprecated positional arguments to StringMethods.rsplit() and StringMethods.split() except for pat MAINT: Bump pandas to 1.5.0 #317
• Deprecated the display.column_space global configuration option MAINT: Bump pandas to 1.5.0 #317
• Deprecated the argument na_sentinel in factorize(), Index.factorize(), and ExtensionArray.factorize() MAINT: Bump pandas to 1.5.0 #317
• Deprecated argument errors for Series.mask(), Series.where(), DataFrame.mask(), and DataFrame.where() MAINT: Bump pandas to 1.5.0 #317
• Deprecated arguments *args and **kwargs in Rolling, Expanding, and ExponentialMovingWindow ops. ENH: Improve Roling, Expanding and EWM #297 (Previous)
• Deprecated the inplace keyword in Categorical.set_ordered(), Categorical.as_ordered(), and Categorical.as_unordered() MAINT: Bump pandas to 1.5.0 #317
• Deprecated setting a categorical’s categories with cat.categories = ['a', 'b', 'c'] MAINT: Bump pandas to 1.5.0 #317
• Deprecated unused arguments encoding and verbose in Series.to_excel() and DataFrame.to_excel() MAINT: Bump pandas to 1.5.0 #317
• Deprecated the inplace keyword in DataFrame.set_axis() and Series.set_axis() MAINT: Bump pandas to 1.5.0 #317
• Deprecated the sort_columns argument in DataFrame.plot() and Series.plot() MAINT: Bump pandas to 1.5.0 #317
• Deprecated positional arguments for all but the first argument of DataFrame.to_stata() and read_stata() MAINT: Bump pandas to 1.5.0 #317
• Deprecated the mangle_dupe_cols argument in read_csv(), read_fwf(), read_table() and read_excel(). MAINT: Bump pandas to 1.5.0 #317

[bashtage]

Deprecated allowing dtype='datetime64' or dtype=np.datetime64 in Series.astype()

Is it possible to actually do this? I don't see how it could be done give the type is S1 | _str | type[Scalar] so "datetime64" would match "str", which is needed for many NumPy types (e.g., "i4", "f8").

[Dr-Irv]

Deprecated allowing dtype='datetime64' or dtype=np.datetime64 in Series.astype()

Is it possible to actually do this? I don't see how it could be done give the type is S1 | _str | type[Scalar] so "datetime64" would match "str", which is needed for many NumPy types (e.g., "i4", "f8").

I think the type for astype() is too wide. Right now, you could do pd.Series([1,2,3]).astype("foobar"), and that would be accepted from a typing standpoint. We should work on narrowing it to the set of valid strings (might be quite large), and then we could get this deprecation done.

I'm fine to hold off on this one. The list I created was just copied from the whatsnew note.

[Dr-Irv]

We've checked off all the issues except astype(), so created #372 for that, so closing this.

Thanks to @bashtage for all his work on this!