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,6 +23,7 @@
 
 
 def tsplot(series, plotf, ax=None, **kwargs):
+    import warnings
     """
     Plots a Series on the given Matplotlib axes or the current axes
 
@@ -35,7 +36,14 @@ def tsplot(series, plotf, ax=None, **kwargs):
     _____
     Supports same kwargs as Axes.plot
 
+
+    .. deprecated:: 0.23.0
+       Use TimeSeries.plot() instead
     """
+    warnings.warn("'tsplot' is deprecated and will be removed in a "
+                  "future version. Please use TimeSeries.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