&`i48ddlZddlZddlZddlmZddlmZddlmZGddeZ dZ dZ Gd d e Z ejsejd e d ZdddedeedefdZdedefdZe jdfde ddfdZdefdZdeefdZdS)N)Enum)wraps)OptionalceZdZdZdZdZdZdS)AnnotationType PublicAPI DeveloperAPI DeprecatedUnknownN)__name__ __module__ __qualname__ PUBLIC_API DEVELOPER_API DEPRECATEDUNKNOWNh/home/jaya/work/projects/VOICE-AGENT/VIET/agent-env/lib/python3.11/site-packages/ray/util/annotations.pyrr s"J"MJGGGrrc2t|dkrHt|dkr5t|dr tdd|dSd|vr|ddvs Jnd|ddfd }|S) a+Annotation for documenting public APIs. Public APIs are classes and methods exposed to end users of Ray. If ``stability="alpha"``, the API can be used by advanced users who are tolerant to and expect breaking changes. If ``stability="beta"``, the API is still public and can be used by early users, but are subject to change. If ``stability="stable"``, the APIs will remain backwards compatible across minor Ray releases (e.g., Ray 1.4 -> 1.8). For a full definition of the stability levels, please refer to the :ref:`Ray API Stability definitions `. Args: stability: One of {"stable", "beta", "alpha"}. api_group: Optional. Used only for doc rendering purpose. APIs in the same group will be grouped together in the API doc pages. Examples: >>> from ray.util.annotations import PublicAPI >>> @PublicAPI ... def func(x): ... return x >>> @PublicAPI(stability="beta") ... def func(y): ... return y rstableOthers) stability api_groupr)rbetaalpharc|dvrddd}t||t|tj|S)N)rrz **PublicAPI (z):** This API is in z' and may change before becoming stable.message)typer) _append_doc_mark_annotatedrr)objr rrs rwrapzPublicAPI..wrap:sh ) ) )9 99y999  W - - - -.";yQQQQ r)lencallablerget)argskwargsr%rrs @@rrrs@ 4yyA~~#f++**xQ/@/@*@y8x@@@aIIIf;' 77777777  ;11I       Krct|dkrEt|dkr2t|drt|dSd}|S)apAnnotation for documenting developer APIs. Developer APIs are lower-level methods explicitly exposed to advanced Ray users and library developers. Their interfaces may change across minor Ray releases. Examples: >>> from ray.util.annotations import DeveloperAPI >>> @DeveloperAPI ... def func(x): ... return x rrc^t|dt|tj|S)Nz@**DeveloperAPI:** This API may change across minor Ray releases.rr!)r"r#rrr$s rr%zDeveloperAPI..wrapXs< V     .">???? r)r&r'r )r)r*r%s rr r Hsb 4yyA~~#f++**xQ/@/@*|~~d1g&&& KrceZdZdZdS)RayDeprecationWarningzBSpecialized Deprecation Warning for fine grained filtering controlN)r r r__doc__rrrr0r0csLLDrr0module)categoryct|dkrEt|dkr2t|drt|dSdd|ddd|vrdz|dzdz|dz|d=|r4t d |fd }|S) a9Annotation for documenting a deprecated API. Deprecated APIs may be removed in future releases of Ray. Args: message: a message to help users understand the reason for the deprecation, and provide a migration path. Examples: >>> from ray.util.annotations import Deprecated >>> @Deprecated ... def func(x): ... return x >>> @Deprecated(message="g() is deprecated because the API is error " ... "prone. Please call h() instead.") ... def g(y): ... return y rrzQ**DEPRECATED**: This API is deprecated and may be removed in future Ray releases.zThis API is deprecated and may be removed in future Ray releases. You could suppress this warning by setting env variable PYTHONWARNINGS="ignore::DeprecationWarning"warningFr  zUnknown kwargs: {}ctdttjsSt jrjfd}|_Stfd}|S)Nr5)r directiver-cLtjtd|i|SN) stacklevelwarningswarnr0)r)r*obj_initwarning_messages r patched_initz/Deprecated..inner..patched_inits1 o/DQRSSSSx0000rcLtjtd|i|Sr:r=)r)r*r$rAs rwrapperz*Deprecated..inner..wrappers1 o/DQRSSSSsD+F+++r)r"r#rrinspectisclass__init__r)r$rBrDr@ doc_messager5rAs` @rinnerzDeprecated..innersC BBBB.";<<<< J ?3   |H 1 1 1 1 1 1(CLJ3ZZ , , , , ,Z ,Nr)r&r'r pop ValueErrorformatkeys)r)r*rIrHr5rAs @@@rr r os ( 4yyA~~#f++**xQ/@/@*z||DG$$$ "  6 jjE**GF!D(6)+<< )D06)3DD 9  E-44V[[]]CCDDD2 Lr)r8r r8returnc|jsd|_|j|_t|j}|xjdz c_|S|xjd|zd|dz c_|ddd|dzzz}|xjd|dzz|z c_n6|ddd|dzzz}|xjd|z|z c_|xjdd|zz c_dS)Nz  z.. z:: r6)r1rstrip _get_indentreplace)r$r r8indents rr"r"s ; +$$&&CK  % %FKK6KK #,<<9<<<< //$sfqj/A(ABB #!,7g777 //$sfqj/A(ABB #,1111 KK&f &&&KKKKr docstringc|sdSttt|}t |dkrdSt |dt |dz S)a! Example: >>> def f(): ... '''Docstring summary.''' >>> f.__doc__ 'Docstring summary.' >>> _get_indent(f.__doc__) 0 >>> def g(foo): ... '''Docstring summary. ... ... Args: ... foo: Does bar. ... ''' >>> g.__doc__ 'Docstring summary.\n\n Args:\n foo: Does bar.\n ' >>> _get_indent(g.__doc__) 4 >>> class A: ... def h(): ... '''Docstring summary. ... ... Returns: ... None. ... ''' >>> A.h.__doc__ 'Docstring summary.\n\n Returns:\n None.\n ' >>> _get_indent(A.h.__doc__) 8 rr)listfilterbool splitlinesr&lstrip)rWnon_empty_liness rrTrTsD q6$ (<(<(>(>??@@O ?q  q q! " "S);)B)B)D)D%E%E EErrr!c^t|dr|j|_||_||_dSdS)Nr )hasattrr _annotated_annotated_type_annotated_api_group)r$r!rs rr#r#s?sJ-"#,   --rcBt|do|j|jkS)Nra)r`rar r.s r _is_annotatedres 3 % % H#.CL*HHrc<t|sdS|jjS)N)rerbvaluer.s r_get_annotation_typerhs#   t   $$r)rEsysr>enumr functoolsrtypingrrrr DeprecationWarningr0 warnoptionsfilterwarningsr strr"intrTrr#r[rerhrrrrrs T555p6     .    FHH/DEEEEDDDNBF''''#'#''''(,F3,F3,F,F,F,F`!/ 6(--- ----I$IIII %#%%%%%%r