ó ‡ˆ\c@siddlZddlZddlZddgZdefd„ƒYZd„Zdefd„ƒYZdS(iÿÿÿÿNt deprecatedtDeprecationDictcBs>eZdZdd„Zd„Zd„Zd„Zd„ZRS(s—Decorator to mark a function or class as deprecated. Issue a warning when the function is called/the class is instantiated and adds a warning to the docstring. The optional extra argument will be appended to the deprecation message and the docstring. Note: to use this with the default value for extra, put in an empty of parentheses: >>> from sklearn.utils import deprecated >>> deprecated() # doctest: +ELLIPSIS >>> @deprecated() ... def some_function(): pass Parameters ---------- extra : string to be added to the deprecation messages tcCs ||_dS(N(textra(tselfR((s8lib/python2.7/site-packages/sklearn/utils/deprecation.pyt__init__"scCs-t|tƒr|j|ƒS|j|ƒSdS(sPCall method Parameters ---------- obj : object N(t isinstancettypet_decorate_classt _decorate_fun(Rtobj((s8lib/python2.7/site-packages/sklearn/utils/deprecation.pyt__call__%s csyd|j‰|jr*ˆd|j7‰n|j‰‡‡fd†}||_d|_|jˆjƒ|_ˆ|_|S(NsClass %s is deprecateds; %scs tjˆdtƒˆ||ŽS(Ntcategory(twarningstwarntDeprecationWarning(targstkwargs(tinittmsg(s8lib/python2.7/site-packages/sklearn/utils/deprecation.pytwrapped9sR(t__name__RRt _update_doct__doc__tdeprecated_original(RtclsR((RRs8lib/python2.7/site-packages/sklearn/utils/deprecation.pyR1s      csmdˆj‰|jr*ˆd|j7‰ntjˆƒ‡‡fd†ƒ}|j|jƒ|_ˆ|_|S(sDecorate function funsFunction %s is deprecateds; %scs tjˆdtƒˆ||ŽS(NR (R RR(RR(tfunR(s8lib/python2.7/site-packages/sklearn/utils/deprecation.pyRKs(RRt functoolstwrapsRRt __wrapped__(RRR((RRs8lib/python2.7/site-packages/sklearn/utils/deprecation.pyR Ds  ! cCsBd}|jr%d||jf}n|r>d||f}n|S(Nt DEPRECATEDs%s: %ss%s %s(R(Rtolddoctnewdoc((s8lib/python2.7/site-packages/sklearn/utils/deprecation.pyRWs  (Rt __module__RRR RR R(((s8lib/python2.7/site-packages/sklearn/utils/deprecation.pyRs    cCs†tjdkrtdƒ‚nt|dgƒ}|dkrEg}nddjg|D]!}t|jtƒrU|j^qUƒk}|S( s=Helper to check if func is wraped by our deprecated decoratoriis-This is only available for python3.5 or abovet __closure__RR(iiN( tsyst version_infotNotImplementedErrortgetattrtNonetjoinRt cell_contentststr(tfunctclosurestct is_deprecated((s8lib/python2.7/site-packages/sklearn/utils/deprecation.pyt_is_deprecated`s    'cBs5eZdZd„Zd„Zdd„Zd„ZRS(säA dict which raises a warning when some keys are looked up Note, this does not raise a warning for __contains__ and iteration. It also will raise a warning even after the key has been manually set by the user. cOs&i|_tt|ƒj||ŽdS(N(t _deprecationstsuperRR(RRR((s8lib/python2.7/site-packages/sklearn/utils/deprecation.pyRvs cCsK||jkr5|j|\}}tj||Žntt|ƒj|ƒS(N(R0R RR1Rt __getitem__(Rtkeyt warn_argst warn_kwargs((s8lib/python2.7/site-packages/sklearn/utils/deprecation.pyR2zscCs%y ||SWntk r |SXdS(söReturn the value corresponding to key, else default. Parameters ---------- key : any hashable object The key default : object, optional The default returned when key is not in dict N(tKeyError(RR3tdefault((s8lib/python2.7/site-packages/sklearn/utils/deprecation.pytget€s   cOs||f|j|s    X