CLN: deprecate the pandas.tseries.plotting.tsplot function (GH18627)

Author: GGordonGordon

doc/source/whatsnew/v0.23.0.txt

@@ -678,6 +678,8 @@ Deprecations
 - The ``reduce`` parameter of ``.apply()`` is deprecated in favor of ``result_type='reduce'`` (:issue:`18577`)
 - The ``order`` parameter of :func:`factorize` is deprecated and will be removed in a future release (:issue:`19727`)
 
+- ``pandas.tseries.plotting.tsplot`` is deprecated. Use :func:`TimeSeries.plot` instead (:issue:`18627`)
+
 .. _whatsnew_0230.prior_deprecations:
 
 Removal of prior version deprecations/changes

pandas/plotting/_timeseries.py

@@ -23,19 +23,14 @@
 
 
 def tsplot(series, plotf, ax=None, **kwargs):
+    import warnings
     """
-    Plots a Series on the given Matplotlib axes or the current axes
-
-    Parameters
-    ----------
-    axes : Axes
-    series : Series
-
-    Notes
-    _____
-    Supports same kwargs as Axes.plot
-
+        DEPRECATED: use ts.plot() instead
     """
+    warnings.warn("'tsplot' is deprecated and will be removed in a "
+                  "future version. Please use ts.plot() instead.",
+                  FutureWarning, stacklevel=2)
+
     # Used inferred freq is possible, need a test case for inferred
     if ax is None:
         import matplotlib.pyplot as plt

pandas/tests/plotting/test_datetimelike.py

@@ -100,6 +100,16 @@ def test_nonnumeric_exclude(self):
 
         pytest.raises(TypeError, df['A'].plot)
 
+    @pytest.mark.slow
+    def test_tsplot_deprecated(self):
+        from pandas.tseries.plotting import tsplot
+
+        _, ax = self.plt.subplots()
+        ts = tm.makeTimeSeries()
+
+        with tm.assert_produces_warning(FutureWarning):
+            tsplot(ts, self.plt.Axes.plot, ax=ax)
+
     @pytest.mark.slow
     def test_tsplot(self):
         from pandas.tseries.plotting import tsplot