ENH: Deprecate non-keyword arguments for Resampler.interpolate

doc/source/whatsnew/v1.3.0.rst

@@ -682,6 +682,7 @@ Deprecations
 - Deprecated passing arguments as positional (except for ``"codes"``) in :meth:`MultiIndex.codes` (:issue:`41485`)
 - Deprecated passing arguments as positional in :meth:`Index.set_names` and :meth:`MultiIndex.set_names` (except for ``names``) (:issue:`41485`)
 - Deprecated passing arguments (apart from ``cond`` and ``other``) as positional in :meth:`DataFrame.mask` and :meth:`Series.mask` (:issue:`41485`)
+- Deprecated passing arguments as positional in :meth:`Resampler.interpolate` (other than ``"method"``) (:issue:`41485`)
 - Deprecated passing arguments as positional in :meth:`DataFrame.clip` and :meth:`Series.clip` (other than ``"upper"`` and ``"lower"``) (:issue:`41485`)
 - Deprecated special treatment of lists with first element a Categorical in the :class:`DataFrame` constructor; pass as ``pd.DataFrame({col: categorical, ...})`` instead (:issue:`38845`)
 - Deprecated passing arguments as positional (except for ``"method"``) in :meth:`DataFrame.interpolate` and :meth:`Series.interpolate` (:issue:`41485`)

pandas/core/resample.py

@@ -34,6 +34,7 @@
 from pandas.util._decorators import (
     Appender,
     Substitution,
+    deprecate_nonkeyword_arguments,
     doc,
 )
 
@@ -832,6 +833,7 @@ def fillna(self, method, limit=None):
         """
         return self._upsample(method, limit=limit)
 
+    @deprecate_nonkeyword_arguments(version=None, allowed_args=["self", "method"])
     @doc(NDFrame.interpolate, **_shared_docs_kwargs)
     def interpolate(
         self,

pandas/tests/resample/test_deprecated.py

@@ -2,6 +2,7 @@
     datetime,
     timedelta,
 )
+from io import StringIO
 
 import numpy as np
 import pytest
@@ -278,3 +279,36 @@ def test_resample_base_with_timedeltaindex():
 
     tm.assert_index_equal(without_base.index, exp_without_base)
     tm.assert_index_equal(with_base.index, exp_with_base)
+
+
+def test_interpolate_posargs_deprecation():
+
+    data = StringIO(
+        """\
+    Values
+    1992-08-27 07:46:48,1
+    1992-08-27 07:46:59,4"""
+    )
+    s = pd.read_csv(data, squeeze=True)
+    s.index = pd.to_datetime(s.index)
+
+    msg = (
+        r"In a future version of pandas all arguments of DataFrame\.interpolate "
+        r"except for the argument 'method' will be keyword-only"
+    )
+
+    with tm.assert_produces_warning(FutureWarning, match=msg):
+        result = s.resample("3s").interpolate("linear")
+
+    data_exp = StringIO(
+        """\
+    Values
+    1992-08-27 07:46:48,1.0
+    1992-08-27 07:46:51,1.0
+    1992-08-27 07:46:54,1.0
+    1992-08-27 07:46:57,1.0"""
+    )
+
+    expected = pd.read_csv(data_exp, squeeze=True)
+    expected.index = pd.to_datetime(expected.index)
+    tm.assert_frame_equal(result, expected)