DEP: Deprecate direct import of implementation functions.

1 files changed, 292 insertions, 4 deletions

diff --git a/numpy/polynomial/__init__.py b/numpy/polynomial/__init__.py
index 32b39aa98..851bde109 100644
--- a/numpy/polynomial/__init__.py
+++ b/numpy/polynomial/__init__.py
@@ -13,14 +13,302 @@ implemented as operations on the coefficients.  Additional (module-specific)
 information can be found in the docstring for the module of interest.
 
 """
-from polynomial import *
-from chebyshev import *
-from legendre import *
-from polyutils import *
+import warnings
+
+from polynomial import Polynomial
+from chebyshev import Chebyshev
+from legendre import Legendre
 from hermite import Hermite
 from hermite_e import HermiteE
 from laguerre import Laguerre
 
+# Deprecate direct import of functions from this package
+# version 1.6.0
+
+from numpy.lib import deprecate
+
+# polynomial functions
+
+@deprecate(message='Please import polyline from numpy.polynomial.polynomial')
+def polyline(off, scl) :
+    from numpy.polynomial.polynomial import polyline
+    return polyline(off, scl)
+
+@deprecate(message='Please import polyfromroots from numpy.polynomial.polynomial')
+def polyfromroots(roots) :
+    from numpy.polynomial.polynomial import polyfromroots
+    return polyfromroots(roots)
+
+@deprecate(message='Please import polyadd from numpy.polynomial.polynomial')
+def polyadd(c1, c2):
+    from numpy.polynomial.polynomial import polyadd
+    return polyadd(c1, c2)
+
+@deprecate(message='Please import polysub from numpy.polynomial.polynomial')
+def polysub(c1, c2):
+    from numpy.polynomial.polynomial import polysub
+    return polysub(c1, c2)
+
+@deprecate(message='Please import polymulx from numpy.polynomial.polynomial')
+def polymulx(cs):
+    from numpy.polynomial.polynomial import polymulx
+    return polymulx(cs)
+
+@deprecate(message='Please import polymul from numpy.polynomial.polynomial')
+def polymul(c1, c2):
+    from numpy.polynomial.polynomial import polymul
+    return polymul(c1, c2)
+
+@deprecate(message='Please import polydiv from numpy.polynomial.polynomial')
+def polydiv(c1, c2):
+    from numpy.polynomial.polynomial import polydiv
+    return polydiv(c1, c2)
+
+@deprecate(message='Please import polypow from numpy.polynomial.polynomial')
+def polypow(cs, pow, maxpower=None) :
+    from numpy.polynomial.polynomial import polypow
+    return polypow(cs, pow, maxpower)
+
+@deprecate(message='Please import polyder from numpy.polynomial.polynomial')
+def polyder(cs, m=1, scl=1):
+    from numpy.polynomial.polynomial import polyder
+    return polyder(cs, m, scl)
+
+@deprecate(message='Please import polyint from numpy.polynomial.polynomial')
+def polyint(cs, m=1, k=[], lbnd=0, scl=1):
+    from numpy.polynomial.polynomial import polyint
+    return polyint(cs, m, k, lbnd, scl)
+
+@deprecate(message='Please import polyval from numpy.polynomial.polynomial')
+def polyval(x, cs):
+    from numpy.polynomial.polynomial import polyval
+    return polyval(x, cs)
+
+@deprecate(message='Please import polyvander from numpy.polynomial.polynomial')
+def polyvander(x, deg) :
+    from numpy.polynomial.polynomial import polyvander
+    return polyvander(x, deg)
+
+@deprecate(message='Please import polyfit from numpy.polynomial.polynomial')
+def polyfit(x, y, deg, rcond=None, full=False, w=None):
+    from numpy.polynomial.polynomial import polyfit
+    return polyfit(x, y, deg, rcond, full, w)
+
+@deprecate(message='Please import polyroots from numpy.polynomial.polynomial')
+def polyroots(cs):
+    from numpy.polynomial.polynomial import polyroots
+    return polyroots(cs)
+
+
+# chebyshev functions
+
+@deprecate(message='Please import poly2cheb from numpy.polynomial.chebyshev')
+def poly2cheb(pol) :
+    from numpy.polynomial.chebyshev import poly2cheb
+    return poly2cheb(pol)
+
+@deprecate(message='Please import cheb2poly from numpy.polynomial.chebyshev')
+def cheb2poly(cs) :
+    from numpy.polynomial.chebyshev import cheb2poly
+    return cheb2poly(cs)
+
+@deprecate(message='Please import chebline from numpy.polynomial.chebyshev')
+def chebline(off, scl) :
+    from numpy.polynomial.chebyshev import chebline
+    return chebline(off, scl)
+
+@deprecate(message='Please import chebfromroots from numpy.polynomial.chebyshev')
+def chebfromroots(roots) :
+    from numpy.polynomial.chebyshev import chebfromroots
+    return chebfromroots(roots)
+
+@deprecate(message='Please import chebadd from numpy.polynomial.chebyshev')
+def chebadd(c1, c2):
+    from numpy.polynomial.chebyshev import chebadd
+    return chebadd(c1, c2)
+
+@deprecate(message='Please import chebsub from numpy.polynomial.chebyshev')
+def chebsub(c1, c2):
+    from numpy.polynomial.chebyshev import chebsub
+    return chebsub(c1, c2)
+
+@deprecate(message='Please import chebmulx from numpy.polynomial.chebyshev')
+def chebmulx(cs):
+    from numpy.polynomial.chebyshev import chebmulx
+    return chebmulx(cs)
+
+@deprecate(message='Please import chebmul from numpy.polynomial.chebyshev')
+def chebmul(c1, c2):
+    from numpy.polynomial.chebyshev import chebmul
+    return chebmul(c1, c2)
+
+@deprecate(message='Please import chebdiv from numpy.polynomial.chebyshev')
+def chebdiv(c1, c2):
+    from numpy.polynomial.chebyshev import chebdiv
+    return chebdiv(c1, c2)
+
+@deprecate(message='Please import chebpow from numpy.polynomial.chebyshev')
+def chebpow(cs, pow, maxpower=16) :
+    from numpy.polynomial.chebyshev import chebpow
+    return chebpow(cs, pow, maxpower)
+
+@deprecate(message='Please import chebder from numpy.polynomial.chebyshev')
+def chebder(cs, m=1, scl=1) :
+    from numpy.polynomial.chebyshev import chebder
+    return chebder(cs, m, scl)
+
+@deprecate(message='Please import chebint from numpy.polynomial.chebyshev')
+def chebint(cs, m=1, k=[], lbnd=0, scl=1):
+    from numpy.polynomial.chebyshev import chebint
+    return chebint(cs, m, k, lbnd, scl)
+
+@deprecate(message='Please import chebval from numpy.polynomial.chebyshev')
+def chebval(x, cs):
+    from numpy.polynomial.chebyshev import chebval
+    return chebval(x, cs)
+
+@deprecate(message='Please import chebvander from numpy.polynomial.chebyshev')
+def chebvander(x, deg) :
+    from numpy.polynomial.chebyshev import chebvander
+    return chebvander(x, deg)
+
+@deprecate(message='Please import chebfit from numpy.polynomial.chebyshev')
+def chebfit(x, y, deg, rcond=None, full=False, w=None):
+    from numpy.polynomial.chebyshev import chebfit
+    return chebfit(x, y, deg, rcond, full, w)
+
+@deprecate(message='Please import chebroots from numpy.polynomial.chebyshev')
+def chebroots(cs):
+    from numpy.polynomial.chebyshev import chebroots
+    return chebroots(cs)
+
+@deprecate(message='Please import chebpts1 from numpy.polynomial.chebyshev')
+def chebpts1(npts):
+    from numpy.polynomial.chebyshev import chebpts1
+    return chebpts1(npts)
+
+@deprecate(message='Please import chebpts2 from numpy.polynomial.chebyshev')
+def chebpts2(npts):
+    from numpy.polynomial.chebyshev import chebpts2
+    return chebpts2(npts)
+
+
+# legendre functions
+
+@deprecate(message='Please import poly2leg from numpy.polynomial.legendre')
+def poly2leg(pol) :
+    from numpy.polynomial.legendre import poly2leg
+    return poly2leg(pol)
+
+@deprecate(message='Please import leg2poly from numpy.polynomial.legendre')
+def leg2poly(cs) :
+    from numpy.polynomial.legendre import leg2poly
+    return leg2poly(cs)
+
+@deprecate(message='Please import legline from numpy.polynomial.legendre')
+def legline(off, scl) :
+    from numpy.polynomial.legendre import legline
+    return legline(off, scl)
+
+@deprecate(message='Please import legfromroots from numpy.polynomial.legendre')
+def legfromroots(roots) :
+    from numpy.polynomial.legendre import legfromroots
+    return legfromroots(roots)
+
+@deprecate(message='Please import legadd from numpy.polynomial.legendre')
+def legadd(c1, c2):
+    from numpy.polynomial.legendre import legadd
+    return legadd(c1, c2)
+
+@deprecate(message='Please import legsub from numpy.polynomial.legendre')
+def legsub(c1, c2):
+    from numpy.polynomial.legendre import legsub
+    return legsub(c1, c2)
+
+@deprecate(message='Please import legmulx from numpy.polynomial.legendre')
+def legmulx(cs):
+    from numpy.polynomial.legendre import legmulx
+    return legmulx(cs)
+
+@deprecate(message='Please import legmul from numpy.polynomial.legendre')
+def legmul(c1, c2):
+    from numpy.polynomial.legendre import legmul
+    return legmul(c1, c2)
+
+@deprecate(message='Please import legdiv from numpy.polynomial.legendre')
+def legdiv(c1, c2):
+    from numpy.polynomial.legendre import legdiv
+    return legdiv(c1, c2)
+
+@deprecate(message='Please import legpow from numpy.polynomial.legendre')
+def legpow(cs, pow, maxpower=16) :
+    from numpy.polynomial.legendre import legpow
+    return legpow(cs, pow, maxpower)
+
+@deprecate(message='Please import legder from numpy.polynomial.legendre')
+def legder(cs, m=1, scl=1) :
+    from numpy.polynomial.legendre import legder
+    return legder(cs, m, scl)
+
+@deprecate(message='Please import legint from numpy.polynomial.legendre')
+def legint(cs, m=1, k=[], lbnd=0, scl=1):
+    from numpy.polynomial.legendre import legint
+    return legint(cs, m, k, lbnd, scl)
+
+@deprecate(message='Please import legval from numpy.polynomial.legendre')
+def legval(x, cs):
+    from numpy.polynomial.legendre import legval
+    return legval(x, cs)
+
+@deprecate(message='Please import legvander from numpy.polynomial.legendre')
+def legvander(x, deg) :
+    from numpy.polynomial.legendre import legvander
+    return legvander(x, deg)
+
+@deprecate(message='Please import legfit from numpy.polynomial.legendre')
+def legfit(x, y, deg, rcond=None, full=False, w=None):
+    from numpy.polynomial.legendre import legfit
+    return legfit(x, y, deg, rcond, full, w)
+
+@deprecate(message='Please import legroots from numpy.polynomial.legendre')
+def legroots(cs):
+    from numpy.polynomial.legendre import legroots
+    return legroots(cs)
+
+
+# polyutils functions
+
+@deprecate(message='Please import trimseq from numpy.polynomial.polyutils')
+def trimseq(seq) :
+    from numpy.polynomial.polyutils import trimseq
+    return trimseq(seq)
+
+@deprecate(message='Please import as_series from numpy.polynomial.polyutils')
+def as_series(alist, trim=True) :
+    from numpy.polynomial.polyutils import as_series
+    return as_series(alist, trim)
+
+@deprecate(message='Please import trimcoef from numpy.polynomial.polyutils')
+def trimcoef(c, tol=0) :
+    from numpy.polynomial.polyutils import trimcoef
+    return trimcoef(c, tol)
+
+@deprecate(message='Please import getdomain from numpy.polynomial.polyutils')
+def getdomain(x) :
+    from numpy.polynomial.polyutils import getdomain
+    return getdomain(x)
+
+@deprecate(message='Please import mapparms from numpy.polynomial.polyutils')
+def mapparms(old, new) :
+    from numpy.polynomial.polyutils import mapparms
+    return mapparms(old, new)
+
+@deprecate(message='Please import mapdomain from numpy.polynomial.polyutils')
+def mapdomain(x, old, new) :
+    from numpy.polynomial.polyutils import mapdomain
+    return mapdomain(x, old, new)
+
+
 from numpy.testing import Tester
 test = Tester().test
 bench = Tester().bench