SNOW-2202094: Remove references to pandas versions in docstrings (#3545)

Author: sfc-gh-helmeleegy

src/snowflake/snowpark/modin/plugin/docstrings/base.py

@@ -2879,24 +2879,12 @@ def sample():
         random_state : int, array-like, BitGenerator, np.random.RandomState, np.random.Generator, optional
             If int, array-like, or BitGenerator, seed for random number generator.
             If np.random.RandomState or np.random.Generator, use as given.
-
-            .. versionchanged:: 1.1.0
-
-                array-like and BitGenerator object now passed to np.random.RandomState()
-                as seed
-
-            .. versionchanged:: 1.4.0
-
-                np.random.Generator objects now accepted
-
         axis : {0 or ‘index’, 1 or ‘columns’, None}, default None
             Axis to sample. Accepts axis number or name. Default is stat axis
             for given data type. For `Series` this parameter is unused and defaults to `None`.
         ignore_index : bool, default False
             If True, the resulting index will be labeled 0, 1, …, n - 1.
 
-            .. versionadded:: 1.3.0
-
         Returns
         -------
         Series or DataFrame

src/snowflake/snowpark/modin/plugin/docstrings/dataframe.py

@@ -234,10 +234,7 @@ def dropna():
             * 0, or 'index' : Drop rows which contain missing values.
             * 1, or 'columns' : Drop columns which contain missing value.
 
-            .. versionchanged:: 1.0.0
-
-               Pass tuple or list to drop on multiple axes.
-               Only a single axis is allowed.
+            Only a single axis is allowed.
 
         how : {'any', 'all'}, default 'any'
             Determine if row or column is removed from DataFrame, when we have
@@ -1181,9 +1178,6 @@ def bfill():
             - None: No fill restriction.
             - ‘inside’: Only fill NaNs surrounded by valid values (interpolate).
             - ‘outside’: Only fill NaNs outside valid values (extrapolate).
-
-        New in version 2.2.0.
-
         downcast : dict, default is None
             A dict of item->dtype of what to downcast if possible, or the string ‘infer’ which will try to downcast to an appropriate equal type (e.g. float64 to int64 if possible).
 
@@ -1517,9 +1511,6 @@ def ffill():
             - None: No fill restriction.
             - ‘inside’: Only fill NaNs surrounded by valid values (interpolate).
             - ‘outside’: Only fill NaNs outside valid values (extrapolate).
-
-        New in version 2.2.0.
-
         downcast : dict, default is None
             A dict of item->dtype of what to downcast if possible, or the string ‘infer’ which will try to downcast to an appropriate equal type (e.g. float64 to int64 if possible).
 
@@ -1694,9 +1685,6 @@ def from_dict():
             Of the form {field : array-like} or {field : dict}.
         orient : {‘columns’, ‘index’, ‘tight’}, default ‘columns’
             The “orientation” of the data. If the keys of the passed dict should be the columns of the resulting DataFrame, pass ‘columns’ (default). Otherwise if the keys should be rows, pass ‘index’. If ‘tight’, assume a dict with keys [‘index’, ‘columns’, ‘data’, ‘index_names’, ‘column_names’].
-
-            Added in version 1.4.0: ‘tight’ as an allowed value for the orient argument
-
         dtype : dtype, default None
             Data type to force after DataFrame construction, otherwise infer.
         columns : list, default None
@@ -5031,8 +5019,6 @@ def map():
         """
         Apply a function to a Dataframe elementwise.
 
-        Added in version 2.1.0: DataFrame.applymap was deprecated and renamed to DataFrame.map.
-
         This method applies a function that accepts and returns a scalar to every element of a DataFrame.
 
         Parameters

src/snowflake/snowpark/modin/plugin/docstrings/general.py

@@ -1904,8 +1904,6 @@ def date_range():
         Name of the resulting DatetimeIndex.
     inclusive : {"both", "neither", "left", "right"}, default "both"
         Include boundaries; Whether to set each bound as closed or open.
-
-        .. versionadded:: 1.4.0
     **kwargs
         For compatibility. Has no effect on the result.
 
@@ -2067,8 +2065,6 @@ def bdate_range():
         are passed.
     inclusive : {"both", "neither", "left", "right"}, default "both"
         Include boundaries; Whether to set each bound as closed or open.
-
-        .. versionadded:: 1.4.0
     **kwargs
         For compatibility. Has no effect on the result.
 

src/snowflake/snowpark/modin/plugin/docstrings/groupby.py

@@ -565,9 +565,8 @@ def idxmax():
 
             Snowpark pandas does not support axis=1, since it is deprecated in pandas.
 
-            .. deprecated:: 2.1.0
-                For axis=1, operate on the underlying object instead. Otherwise,
-                the axis keyword is not necessary.
+            Deprecated: For axis=1, operate on the underlying object instead. Otherwise,
+            the axis keyword is not necessary.
 
         skipna : bool, default True
             Exclude NA/null values. If an entire row/column is NA, the result
@@ -658,9 +657,8 @@ def idxmin():
 
             Snowpark pandas does not support axis=1, since it is deprecated in pandas.
 
-            .. deprecated:: 2.1.0
-                For axis=1, operate on the underlying object instead. Otherwise,
-                the axis keyword is not necessary.
+            Deprecated: For axis=1, operate on the underlying object instead. Otherwise,
+            the axis keyword is not necessary.
 
         skipna : bool, default True
             Exclude NA/null values. If an entire row/column is NA, the result
@@ -936,14 +934,13 @@ def pct_change():
         fill_method : {"bfill", "ffill", "pad"}, default "ffill"
             How to handle NAs before computing percent changes.
 
-            .. deprecated:: 2.1.0
-                All options of fill_method are deprecated except fill_method=None.
+            Deprecated: All options of fill_method are deprecated except fill_method=None.
 
         limit : int, optional
             The number of consecutive NAs to fill before stopping.
             Snowpark pandas does not yet support this parameter.
 
-            .. deprecated:: 2.1.0
+            Deprecated.
 
         freq : DateOffset, timedelta, or str, optional
             Increment to use from time series API (e.g. ‘ME’ or BDay()).
@@ -1462,9 +1459,8 @@ def rank():
 
             Snowpark pandas does not currently support axis=1, since it is deprecated in pandas.
 
-            .. deprecated:: 2.1.0
-                For axis=1, operate on the underlying object instead. Otherwise,
-                the axis keyword is not necessary.
+            Deprecated:  For axis=1, operate on the underlying object instead. Otherwise,
+            the axis keyword is not necessary.
 
 
         Returns

src/snowflake/snowpark/modin/plugin/docstrings/index.py

@@ -976,8 +976,7 @@ def is_boolean():
         """
         Check if the Index only consists of booleans.
 
-        .. deprecated:: 2.0.0
-            Use `pandas.api.types.is_bool_dtype` instead.
+        Deprecated: Use `pandas.api.types.is_bool_dtype` instead.
 
         Returns
         -------
@@ -1012,8 +1011,7 @@ def is_floating():
         """
         Check if the Index is a floating type.
 
-        .. deprecated:: 2.0.0
-            Use `pandas.api.types.is_float_dtype` instead
+        Deprecated: Use `pandas.api.types.is_float_dtype` instead.
 
         The Index may consist of only floats, NaNs, or a mix of floats,
         integers, or NaNs.
@@ -1056,8 +1054,7 @@ def is_integer():
         """
         Check if the Index only consists of integers.
 
-        .. deprecated:: 2.0.0
-            Use `pandas.api.types.is_integer_dtype` instead.
+        Deprecated: Use `pandas.api.types.is_integer_dtype` instead.
 
         Returns
         -------
@@ -1092,8 +1089,7 @@ def is_interval():
         """
         Check if the Index holds Interval objects.
 
-        .. deprecated:: 2.0.0
-            Use `isinstance(index.dtype, pd.IntervalDtype)` instead.
+        Deprecated: Use `isinstance(index.dtype, pd.IntervalDtype)` instead.
 
         Returns
         -------
@@ -1115,8 +1111,7 @@ def is_numeric():
         """
         Check if the Index only consists of numeric data.
 
-        .. deprecated:: 2.0.0
-            Use `pandas.api.types.is_numeric_dtype` instead.
+        Deprecated: Use `pandas.api.types.is_numeric_dtype` instead.
 
         Returns
         -------
@@ -1159,8 +1154,7 @@ def is_object():
         """
         Check if the Index is of the object dtype.
 
-        .. deprecated:: 2.0.0
-           Use `pandas.api.types.is_object_dtype` instead.
+        Deprecated: Use `pandas.api.types.is_object_dtype` instead.
 
         Returns
         -------

src/snowflake/snowpark/modin/plugin/docstrings/io.py

@@ -542,7 +542,7 @@ def read_excel():
         If you want to pass in a path object, pandas accepts any os.PathLike.
         By file-like object, we refer to objects with a read() method, such as a file handle (e.g. via builtin open function) or StringIO.
 
-        Deprecated since version 2.1.0: Passing byte strings is deprecated. To read from a byte string, wrap it in a BytesIO object.
+        Deprecated: Passing byte strings is deprecated. To read from a byte string, wrap it in a BytesIO object.
 
     sheet_name : str, int, list, or None, default 0
         Strings are used for sheet names. Integers are used in zero-indexed sheet positions (chart sheets do not count as a sheet position). Lists of strings/integers are used to request multiple sheets. Specify None to get all worksheets.
@@ -618,20 +618,14 @@ def read_excel():
     date_parser : function, optional
         Function to use for converting a sequence of string columns to an array of datetime instances. The default uses dateutil.parser.parser to do the conversion. Pandas will try to call date_parser in three different ways, advancing to the next if an exception occurs: 1) Pass one or more arrays (as defined by parse_dates) as arguments; 2) concatenate (row-wise) the string values from the columns defined by parse_dates into a single array and pass that; and 3) call date_parser once for each row using one or more strings (corresponding to the columns defined by parse_dates) as arguments.
 
-        Deprecated since version 2.0.0: Use date_format instead, or read in as object and then apply to_datetime() as-needed.
+        Deprecated: Use date_format instead, or read in as object and then apply to_datetime() as-needed.
 
     date_format : str or dict of column -> format, default None
         If used in conjunction with parse_dates, will parse dates according to this format. For anything more complex, please read in as object and then apply to_datetime() as-needed.
-
-        Added in version 2.0.0.
-
     thousands : str, default None
         Thousands separator for parsing string columns to numeric. Note that this parameter is only necessary for columns stored as TEXT in Excel, any numeric columns will automatically be parsed, regardless of display format.
     decimal : str, default ‘.’
         Character to recognize as decimal point for parsing string columns to numeric. Note that this parameter is only necessary for columns stored as TEXT in Excel, any numeric columns will automatically be parsed, regardless of display format.(e.g. use ‘,’ for European data).
-
-        Added in version 1.4.0.
-
     comment : str, default None
         Comments out remainder of line. Pass a character or characters to this argument to indicate comments in the input file. Any data between the comment string and the end of the current line is ignored.
     skipfooter : int, default 0
@@ -642,9 +636,6 @@ def read_excel():
         Back-end data type applied to the resultant DataFrame (still experimental). Behaviour is as follows:
         - "numpy_nullable": returns nullable-dtype-backed DataFrame (default).
         - "pyarrow": returns pyarrow-backed nullable ArrowDtype DataFrame.
-
-        Added in version 2.0.
-
     engine_kwargs : dict, optional
         Arbitrary keyword arguments passed to excel engine.
 

src/snowflake/snowpark/modin/plugin/docstrings/series.py

@@ -813,13 +813,10 @@ def bfill():
             - None: No fill restriction.
             - ‘inside’: Only fill NaNs surrounded by valid values (interpolate).
             - ‘outside’: Only fill NaNs outside valid values (extrapolate).
-
-        New in version 2.2.0.
-
         downcast : dict, default is None
             A dict of item->dtype of what to downcast if possible, or the string ‘infer’ which will try to downcast to an appropriate equal type (e.g. float64 to int64 if possible).
 
-        Deprecated since version 2.2.0.
+        Deprecated parameter.
 
         Returns
         -------
@@ -1422,8 +1419,6 @@ def case_when():
             must not change the input Series
             (though pandas doesn`t check it).
 
-            .. versionadded:: 2.2.0
-
         Returns
         -------
         Series
@@ -1464,13 +1459,10 @@ def ffill():
             - None: No fill restriction.
             - ‘inside’: Only fill NaNs surrounded by valid values (interpolate).
             - ‘outside’: Only fill NaNs outside valid values (extrapolate).
-
-        New in version 2.2.0.
-
         downcast : dict, default is None
             A dict of item->dtype of what to downcast if possible, or the string ‘infer’ which will try to downcast to an appropriate equal type (e.g. float64 to int64 if possible).
 
-        Deprecated since version 2.2.0.
+        Deprecated parameter.
 
         Returns
         -------
@@ -1525,8 +1517,7 @@ def fillna():
             * ffill: propagate last valid observation forward to next valid.
             * backfill / bfill: use next valid observation to fill gap.
 
-            .. deprecated:: 2.1.0
-                Use ffill or bfill instead.
+            Deprecated: Use ffill or bfill instead.
 
         axis : {axes_single_arg}
             Axis along which to fill missing values. For `Series`
@@ -1547,7 +1538,7 @@ def fillna():
             or the string 'infer' which will try to downcast to an appropriate
             equal type (e.g. float64 to int64 if possible).
 
-            .. deprecated:: 2.2.0
+            Deprecated parameter.
 
         Returns
         -------

src/snowflake/snowpark/modin/plugin/docstrings/timedelta_index.py

@@ -38,8 +38,7 @@ def __new__():
         unit : {'D', 'h', 'm', 's', 'ms', 'us', 'ns'}, optional
             The unit of ``data``.
 
-            .. deprecated:: 2.2.0
-             Use ``pd.to_timedelta`` instead.
+            Deprecated: Use ``pd.to_timedelta`` instead.
 
         freq : str or pandas offset object, optional
             One of pandas date offset strings or corresponding objects. The string
@@ -70,8 +69,7 @@ def __init__() -> None:
         unit : {'D', 'h', 'm', 's', 'ms', 'us', 'ns'}, optional
             The unit of ``data``.
 
-            .. deprecated:: 2.2.0
-             Use ``pd.to_timedelta`` instead.
+            Deprecated: Use ``pd.to_timedelta`` instead.
 
         freq : str or pandas offset object, optional
             One of pandas date offset strings or corresponding objects. The string