q-Ph5UddlmZddlZddlZddlZddlmZddlmZddl m Z ddl m Z ddl mZmZmZmZmZddlmZejd krdd lmZn dd lmZn#e$rd:dZYnwxYwddlmZer:ddlmZejdkrddl mZnddlmZddlmZedZedZ dddZ!de"d<ddd;d Z#d:d!Z$dd)Z' d?d@d-Z(dAd/Z)dBd0Z*dCd4Z+dDd8Z,gd9Z-dS)E) annotationsN) defaultdict)Sequence)wraps)Path) TYPE_CHECKINGAnyCallableTypeVarget_args)DeprecationType) ) deprecatedmessagestrreturn*Callable[[Callable[P, T]], Callable[P, T]]c t|SN)_deprecate_function)rs Y/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/polars/_utils/deprecation.pyrrs'w// /) issue_warning)Mapping)r ) ParamSpec) AmbiguousPTearliestlatest)TFzMapping[bool, Ambiguous]USE_EARLIEST_TO_AMBIGUOUSversionr&Nonech|r|d|d}t|tdS)a Issue a deprecation warning. Parameters ---------- message The message associated with the warning. version The version in which deprecation occurred (if the version number was not already included in `message`). z (Deprecated in version )N)striprDeprecationWarning)rr&s rissue_deprecation_warningr,/sBJ]]__IIwIII'-.....rcdfd }|S)z+Decorator to mark a function as deprecated.functionCallable[P, T]rctdfd }tj|_|_|S) NargsP.argskwargsP.kwargsrr c2t|i|Srr,)r1r3r.rs rwrapperz6_deprecate_function..decorate..wrapperDs& %g . . .8T,V,, ,rr1r2r3r4rr )rinspect signature __signature____deprecated__)r.r7rs` rdecoratez%_deprecate_function..decorateCsY x - - - - - -  -!( 1( ; ;!(rr.r/rr/)rr=s` rrr@s( Orcdd}|S)zJDecorator to mark `streaming` argument as deprecated due to being renamed.r.r/rcptdfd }tj|_|S) Nr1r2r3r4rr cnd|vr)td|drd|d<n d|vrd|d<|d=|i|S)N streamingzIthe `streaming` parameter was deprecated in 1.25.0; use `engine` instead.z old-streamingenginez in-memoryr6)r1r3r.s rr7z@deprecate_streaming_parameter..decorate..wrapperTsqf$$)_+&3'6F8$$V++'2F8$;'8T,V,, ,rr8rr9r:r;)r.r7s` rr=z/deprecate_streaming_parameter..decorateSsK x - - - - -  -!( 1( ; ;rr>r?)r=s rdeprecate_streaming_parameterrFPs& Orold_namenew_namecdfd }|S)a Decorator to mark a function parameter as deprecated due to being renamed. Use as follows: @deprecate_renamed_parameter("old_name", new_name="new_name") def myfunc(new_name): ... Ensure that you also update the function docstring with a note about the deprecation, specifically adding a `.. versionchanged:: 0.0.0` directive that states which parameter was renamed to which new name and in which version the rename happened. r.r/rcxtdfd }tj|_|S) Nr1r2r3r4rr cDt|j|i|Sr)_rename_keyword_argument __qualname__)r1r3r.rHrGr&s rr7z>deprecate_renamed_parameter..decorate..wrapper{s: $(FH,A7   8T,V,, ,rr8rE)r.r7rHrGr&s` rr=z-deprecate_renamed_parameter..decoratezs[ x - - - - - - - -  - !( 1( ; ;rr>r?)rGrHr&r=s``` rdeprecate_renamed_parameterrNis4"         Orr3dict[str, object] func_namec ||vrp||vr-|rd|nd}d|d|d|d|d|d|d }t||rd |nd }td |d |d|d|d ||||<dSdS)z(Rename a keyword argument of a function.zwas deprecated in version z is deprecated`z` received both `z` and `z` as arguments; `z` z, use `z ` insteadz in version r$zthe argument `z` for `z$` is deprecated. It was renamed to `.N) TypeErrorr,pop)rGrHr3rPr& is_deprecatedmsg in_versions rrLrLs76 v  :AV6W666 OIOO(OOXOOOO#0OO9AOOO C.. 18@-G---b ! ;X ; ;i ; ;"* ; ;-7 ; ; ;   "::h//x!r allowed_argslist[str] | None str | Nonecdfd }|S)a Decorator for deprecating the use of non-keyword arguments in a function. Use as follows: @deprecate_nonkeyword_arguments(allowed_args=["self", "val"], version="1.0.0") def myfunc(self, val: int = 0, other: int: = 0): ... Ensure that you also update the function docstring with a note about the deprecation, specifically adding a `.. versionchanged:: 0.0.0` directive that states that we now expect keyword args and in which version this update happened. Parameters ---------- allowed_args The names of some first arguments of the decorated function that are allowed to be given as positional arguments. Should include "self" when decorating class methods. If set to None (default), equal to all arguments that do not have a default value. message Optionally overwrite the default warning message. version The Polars version number in which the warning is first issued. r.r/rctj}  n#d|jDfd|jD}|d||}t  /djd}|tn td fd }||_ |S)Ncbg|],}|j|j|jfvr|j|ju%|j-Sr?)kindPOSITIONAL_ONLYPOSITIONAL_OR_KEYWORDdefaultemptyname).0ps r zDdeprecate_nonkeyword_arguments..decorate..sM6a/1HIIII(()((rcg|]=}|j|j|jfvr$|jvr||jn|>S)r_)r_r`rardreplace KEYWORD_ONLY)rerf allow_argss rrgzDdeprecate_nonkeyword_arguments..decorate..sj    1,a.EFFFF*,, II1>I * * *     rc|jSrri)rfs rzBdeprecate_nonkeyword_arguments..decorate..safr)key) parameterszall arguments of zo{except_args} will be keyword-only in the next breaking release. Use keyword arguments to silence this warning.) except_argsr1r2r3r4rr c\t|krt|i|S)Nr%)lenr,)r1r3r.rWnum_allowed_argsr&s rr7zAdeprecate_nonkeyword_arguments..decorate..wrappers=4yy+++)#w????8T,V,, ,rr8) r9r:rpvaluessortrjrsrMformat_format_argument_listrr;) r.old_sig new_paramsnew_sig msg_formatr7rlrWrtrYrr&s ` @@@rr=z0deprecate_nonkeyword_arguments..decorates^#H--  #%JJ +2244J    '..00    ,,---//Z/88z?? ?BH$9BBB ##0Ej0Q0Q#RRCCC x - - - - - - - -  - !(rr>r?)rYrr&r=s``` rdeprecate_nonkeyword_argumentsr}s5:++++++++Z Or list[str]cd|vr|d|sdSt|dkr d|dS|d}dd|d dD}d|d |S) zaFormat allowed arguments list for use in the warning message of `deprecate_nonkeyword_arguments`.selfr$z except for rz, cg|]}|Sr?r?)rexs rrgz)_format_argument_list..s>>>qQ(>>>rNz and )removersjoin)rYlastr1s rrxrxs F### 2r \  a  1l1o111Byy>>L",=>>>??1d11111rcdfd }|S)a Decorator to mark a function argument as deprecated due to being made multi-positional. Use as follows: @deprecate_parameter_as_multi_positional("columns") def myfunc(*columns): ... Ensure that you also update the function docstring with a note about the deprecation, specifically adding a `.. versionchanged:: 0.0.0` directive that states that we now expect positional args and in which version this update happened. r.r/rcttdfd }tj|_|S) Nr1r2r3r4rr cF |}n#t$r |i|cYSwxYwtddt|trt|t r|f}n$t|t st |}||z}|i|S)Nz passing `zP` as a keyword argument is deprecated. Pass it as a positional argument instead.)rUKeyErrorr, isinstancerrtuple)r1r3 arg_valuer.rGs rr7zJdeprecate_parameter_as_multi_positional..decorate..wrappers 1"JJx00  1 1 1x000000 1 &=H===    i22 -jC6P6P -&L  511 -!),, )#D8T,V,, ,s ..r8rE)r.r7rGs` rr=z9deprecate_parameter_as_multi_positional..decoratesQ x - - - - - -  -&!( 1( ; ;rr>r?)rGr=s` r'deprecate_parameter_as_multi_positionalrs("0 Orsource module_pathdefaultdict[str, list[str]]ctj|}gd fd d fd ttGfdd tj}||S) N decoratorr rrct|tjrd|jvr|jndSt|tjr|jSdS)N deprecater$)rastNameidCallfunc)rrs rrz._find_deprecated_functions..deprecated0sZ i * * .#.),#>#>9<.qualified_name7s"xx>{>I>???rc0eZdZdfd Zdfd ZeZdS) 3_find_deprecated_functions..FunctionVisitornoder rr'c|j||dSr)appendrd generic_visitrU)rrrs rvisit_ClassDefzB_find_deprecated_functions..FunctionVisitor.visit_ClassDef=sC   ty ) ) )   t $ $ $ OO     rctfd|jDrRddd}||j||dS)Nc32K|]}|xVdSrr?)reddecorator_namers r zX_find_deprecated_functions..FunctionVisitor.visit_FunctionDef..Cs0RRjjmm3NRRRRRRr deprecate_rr.)anydecorator_list removeprefixrjrrdr)rrrorrrresultss @rvisit_FunctionDefzE_find_deprecated_functions..FunctionVisitor.visit_FunctionDefBsRRRRRd>QRRRRR ?$11,??GG * ##NN49$=$=>>>   t $ $ $ $ $rN)rr rr')__name__ __module__rMrrvisit_AsyncFunctionDef)rrrrsrFunctionVisitorr<s_        % % % % % % % %"3rr)rr rr)rPrrr)rparserlist NodeVisitorvisit)rrtreerrrrrs ` @@@@r_find_deprecated_functionsr*s 9V  DK@@@@@@@$G3333333333#/333 OD!!! Nrtypesr dict[str, list[str]]c p ttt}D]?}||vr9d|dtt |dd}t |@t tjdj j }tt | dD]}||}d|jd}|d d 5}t'|| D]9\} } | |vrd|d }t | | | : dddn #1swxYwY fdt DS)a Return a dict identifying functions/methods that are deprecated in some way. Parameters ---------- *types The types of deprecations to identify. If empty, all types are returned; recognised values are: - "function" - "renamed_parameter" - "streaming_parameter" - "nonkeyword_arguments" - "parameter_as_multi_positional" Examples -------- >>> from polars._utils.deprecation import identify_deprecations >>> identify_deprecations("streaming_parameter") # doctest: +IGNORE_RESULT {'streaming_parameter': [ 'functions.lazy.collect_all', 'functions.lazy.collect_all_async', 'lazyframe.frame.LazyFrame.collect', 'lazyframe.frame.LazyFrame.collect_async', 'lazyframe.frame.LazyFrame.explain', 'lazyframe.frame.LazyFrame.show_graph', ]} zunrecognised deprecation type z. Expected one (or more) of rrpolarsz*.pyrSz.pyrzutf-8)encoding)rrz. NcHi|]}r|v|t|Sr?)sorted)redeprrs r z)identify_deprecations..sB     u  VGCL ! !$ r)setr r reprr ValueErrorrsysmodules__file__parentrrrglob relative_torparts removesuffixopenrreaditemsextend) r valid_typestprW package_pathpy_filerel_pathrsrcdeprecation_type func_namesrs ` @ridentify_deprecationsrPs-8h//00K"" [ OOO-1&2E2E-F-Fqt-LOO S// ! ! H-677>L$G%%f--==&&|44hhx~..;;EBB \\#\ 0 0 =C0Jxxzz'111egg = =, *$;66E2DDDC$S//)()00<<<< = = = = = = = = = = = = = = = =     '??   sA0FF F )r}rrNrFrr)rrrr)rrr&rrr')rr)rGrrHrr&rrr) rGrrHrr3rOrPrr&rrr')NN)rYrZrr[r&rrr)rYr~rr)rGrrr)rrrrrr)rr rr). __future__rrr9r collectionsrcollections.abcr functoolsrpathlibrtypingrr r r r polars._typingr version_infowarningsrtyping_extensions ImportErrorpolars._utils.variousrrrrrr r#__annotations__r,rrFrNrLr}rxrrr__all__r?rrrs"""""""  ######$$$$$$BBBBBBBBBBBBBB******w#######00000000 000 0 0 0 0 0 000///// '''''' 7""$$$$$$$//////(((((( #A A  77 ?A//////"     2>00008BFJJJJJZ 2 2 2 2))))X####L<<<<~   sA A&%A&