d@BddlZddlZGddeZddZddZdS)NceZdZdS)AltairDeprecationWarningN)__name__ __module__ __qualname__8lib/python3.11/site-packages/altair/utils/deprecation.pyrrsDr rcfd}|S)zDecorator to deprecate a function or class. Parameters ---------- message : string (optional) The deprecation message c&t|S)N)message) _deprecate)objr s r wrapperzdeprecated..wrappers#w////r r)r rs` r deprecatedr s#00000 Nr c d|jttr.t|fjt jddStr)tj fd}d|_ |Stdt)amReturn a version of a class or function that raises a deprecation warning. Parameters ---------- obj : class or function The object to create a deprecated version of. name : string (optional) The name of the deprecated object message : string (optional) The deprecation message Returns ------- deprecated_obj : The deprecated version of obj Examples -------- >>> class Foo: pass >>> OldFoo = _deprecate(Foo, "OldFoo") >>> f = OldFoo() # doctest: +SKIP AltairDeprecationWarning: alt.OldFoo is deprecated. Use alt.Foo instead. Nz)alt.{} is deprecated. Use alt.{} instead.__init__)__doc__rcLtjtd|i|S)N) stacklevel)warningswarnr)argskwargsr rs r new_objz_deprecate..new_obj?s0 M'#; J J J J3''' 'r Tz"Cannot deprecate object of type {}) formatr isinstancetyperrrcallable functoolswraps _deprecated ValueError)rnamer rs` ` r rrs0@GG #,  #tQ  F;&s|ZII      # Q    ( ( ( ( (   (#=DDT#YYOOPPPr )N)NN)rr! UserWarningrrrrr r r's|     {       /Q/Q/Q/Q/Q/Qr