Add deprecation wrapper

Author: sinhrks

pandas/__init__.py

@@ -46,7 +46,10 @@
 from pandas.tools.merge import (merge, concat, ordered_merge,
                                 merge_ordered, merge_asof)
 from pandas.tools.pivot import pivot_table, crosstab
-from pandas.tools.plotting import scatter_matrix, plot_params
+
+# deprecated
+import pandas.tools.plotting
+from pandas.plotting import scatter_matrix, plot_params
 from pandas.tools.tile import cut, qcut
 from pandas.tools.util import to_numeric
 from pandas.core.reshape import melt

pandas/tools/plotting.py

@@ -1,3 +1,21 @@
-# flake8: noqa
+import sys
+import warnings
 
-from pandas.plotting.api import *
+import pandas.plotting.api as api
+
+# back-compat of public API
+# deprecate these functions
+m = sys.modules['pandas.tools.plotting']
+for t in [t for t in dir(api) if not t.startswith('_')]:
+
+    def outer(t=t):
+
+        def wrapper(*args, **kwargs):
+            warnings.warn("pandas.tools.plotting{t} is deprecated. "
+                          "import from the "
+                          "pandas.plotting.{t} instead".format(t=t),
+                          UserWarning, stacklevel=3)
+            return getattr(api, t)(*args, **kwargs)
+        return wrapper
+
+    setattr(m, t, outer(t))