rPjQdZddlmZddlZddlZddlmZddlm Z m Z ddlm Z ddl mZddlmZdd lmZdd lmZdd lmZmZmZmZmZmZdd lmZmZmZm Z dd l!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.m/Z/ddl0m1Z1ddl2m3Z3GddedZ4d9dZ5d:d;dZ6d d?dZ8d@dd dAd!Z9dBd"Z:dCd#Z;ddGd'Z? dH dId(Z@dCd)ZAdGd*ZBdJd+ZC dK dLd,ZDdMd-ZEdCd.ZFdNd/ZGdOd0ZHdGd1ZIdPd2ZJ dQ dRd3ZKdSd4ZLdTd5ZMdTd6ZNdUd7ZOgd8ZPy)Vz0Utility functions for pydantic-settings sources.) annotationsN)deque)MappingSequence)Set) is_dataclass)Enum)islice)Path)Any TypedDictTypeVarcastget_args get_origin) BaseModelJson RootModelSecret)is_model_class)is_pydantic_dataclass) FieldInfo)Strict)typing_objects)is_union_origin) IncompleteFieldDefinitionWarning SettingsError)_lenient_issubclass EnvNoneTypeceZdZUdZded<y) InitStatezJState shared between settings sources during a single settings resolution.zset[int]field_info_idsN)__name__ __module__ __qualname____doc____annotations__d/home/oem/CyberBrain26-unified/.venv/lib/python3.12/site-packages/pydantic_settings/sources/utils.pyr$r$sT]r,r$F)totalct|ddry|jdt}t||vry|j t|t j d|dty)uWarn if the field is incomplete, i.e. its annotation contains unresolved forward references. An incomplete `FieldInfo` instance is unsafe to inspect — any of its attributes (annotation, aliases, metadata, default) may rely on the unresolved annotation, so settings sources may silently fail to resolve the field's value. Each instance is only warned about once per `init_state`, so that a field accessed by multiple sources during a single settings resolution doesn't emit duplicate warnings. _completeTNr%zField z has an incomplete definition: its annotation contains an unresolved forward reference, so settings sources may fail to correctly resolve its value. Call `model_rebuild()` on the model where the field is defined, once all the referenced types are defined.)getattr setdefaultsetidaddwarningswarnr) field_info field_name init_state warned_idss r-_warn_if_field_info_incompleter<$siz;-&&'7?J *~#NN2j>" MM   ) r,c*|r|S|jSN)lower)keycase_sensitives r-_get_env_var_keyrB<s 31ciik1r,c*||k(r||St|Sr>r!)valueparse_none_strs r-_parse_env_none_strrF@s .0^5O5hVabgVhhr,c |jDcic]#\}}|r|dk(st||t||%c}}Scc}}w)N)itemsrBrF)env_varsrA ignore_emptyrEkvs r-parse_env_varsrNDsLNN$  Aqb N+-@N-SS  s(A) allow_fifoc\t|j}|js|r|jr|S|dks|j ryt tj j|D].}||z }|js|s|js,|cSy)zOResolve a config file path, optionally searching parent directories of the cwd.rN)r expanduseris_fileis_fifo is_absoluter cwdparents)filedepthrO file_pathparent candidates r-_resolve_config_filer\QsT %%'Izi.?.?.A zY**,++U3Y&    :)2C2C2E  r,ct|tr |vr|St|}|s|Stfd|D}||k(r|St |}| ||S|S#t $r'ddl}ddl}|j|j|cYSwxYw)zLSubstitute TypeVars in a type annotation with concrete types from param_map.c36K|]}t|ywr>)_substitute_typevars).0arg param_maps r- z'_substitute_typevars..ksJc)#y9JNr) isinstancerrtupler TypeError functoolsoperatorreduceor_)tprbargsnew_argsoriginrhris ` r-r_r_ds"g2?} Brerr`mds r-rcz)_annotation_is_complex..s 3B:b$  3F__pydantic_core_schema____get_pydantic_core_schema__)rzrrr model_fieldsr<r&rwanyrr is_annotatedr_annotation_is_complexr_annotation_is_complex_innerhasattr)rwmetadatar: root_fieldroot_annotationroinnermetas r-rrs%Z0J"5j)"LQ[clQl0*= ,,V4  ! *:*:M:M9Ne7TV` a$//  &(J 3( 33  #F""6* + %eT:>>66* %Z0 ; ' / ; 65 6 ; 69 : r,ct|j}|j}t|}t j |rt |^}}g||}||fS)zFResolve a field's type alias and collect its outer Annotated metadata.)rzrwrrrrr)fieldrwrrors r-"_get_field_annotation_and_metadatars^$U%5%56J~~H  #F""6*$Z0 T&X%% x r,ct|dS)zUCollect a field's metadata, including the outer Annotated metadata of its type alias.r )r)rs r-_get_field_metadatars -e 4Q 77r,c t|ttfryt|ttt t ttttfxs t|S)NF) rstrbytesrrr AbstractSetrfr3 frozensetrrrws r-rrsD:U|4 Y;sIW\]  " j !"r,ct|D]X}||vrg||}t|}t|||ryt|}t t |sIt ||||sXyy)z1Check if a union type contains any complex types.TF)rrzr_unwrap_union_memberrr_union_is_complex)rwrr:_seenraseenrs r-rrs{ # %< }}!#& !#x <%S) :e, -2CE8U_ae2f r,ctjt|rJt|^}}t d|Dryt |}tjt|rJ|S)zStrip Annotated layers and the type aliases they wrap from a union member. Returns `None` if any layer's metadata suppresses complexity (e.g. Json). c3<K|]}t|tywr>r~rs r-rcz'_unwrap_union_member..s3z"d#3rN)rrrrrrz)rwrs r-rrs^  % %j&< =$Z0 T 3d3 3(4  % %j&< = r,ct|D]B}tjt|s"t|^}}t d|DsByy)z:Check if a union type contains any strict-annotated types.c3<K|]}t|tywr>)rer)r`ms r-rcz*_union_has_strict_types..s7Q:a(7rTF)rrrrr)rwra_rs r-_union_has_strict_typesrsK #  & &z# 7}HA7$77  r,cVt|tttf xr t||S)zCheck if a type annotation is a class that subclasses any of the specified types. Text and bytes types never match, since they are sequences themselves, but are treated as scalar values by the settings sources. )rrr bytearray)rwtypess r-_is_subtype_ofrs* #:UI/FG G rL_`jlqLrrr,c * |r tt}|ur|vxrt|||||||g|S|dur[t |vs|r t |r|y|j |r(t fd|Dr|y|j tD]} t| |d|||||s|y|r(t fd|Dr|y|j |vs|r t |r||j yy)zCheck if a type annotation contains any of the specified types. With `is_subtype`, subclasses of the specified types match as well, so `tuple` matches `Sequence`, or `frozenset` matches `Set`. )is_include_originis_strip_annotated is_instancecollect is_subtype _seen_aliasesTc36K|]}t|ywr>re)r`type_ros r-rcz-_annotation_contains_types..3sLUz&%8Lrdc36K|]}t|ywr>r)r`rrws r-rcz-_annotation_contains_types..FsLU:j%8LrdF)_strip_annotatedrz_annotation_contains_typesrrr5rr) rwrrrrrrrresolvedrros ` @r-rrsO%j1 ":.Hz!.  3M  /1#!6M6:6 4 D J' U?znVU.K KK # 3LeLL KK #*% &"'%+ sLeLL ? JUznZ.O   KK # r,cttt|}||ur t|Stt |s|fSt dt |DS)zGet the members of a union, flattening unions nested inside type aliases or `Annotated`. A non-union annotation is returned as its only member. c3@K|]}t|D]}|ywr>)_get_union_members)r`ramembers r-rcz%_get_union_members..[s#^CFXY\F]^F^^s)rrzrrrrfr)rwrs r-rrQsX  34DZ4P QRHz!!(++ :j1 2} ^8J#7^ ^^r,cZtjt|r |jS|Sr>)rrr __origin__rs r-rr^s'"":j#9:$$$ r,c|t|fD]O}t|tstd|}||jj vs=||j cSt|D]}t||}||cSyNz type[Enum]) rrr r __members__valuesnamer_annotation_enum_val_to_name)rwrDr enum_typera enum_names r-rrdsj45- ud +\51I --4466 ',,, -  #0e<    r,c|t|fD]4}t|tstd|}||jvs/||cSt |D]}t ||}||cSyr)rrr rrr_annotation_enum_name_to_val)rwrrrraenum_vals r-rrqs{j45' ud +\51Iy,,, & '  #/T:  O r,cBtjt|rtdt |DStj t|rt |d}t |Stt|rtdt |DSy)zlCheck if annotation is a Literal type containing numeric Enum members (IntEnum, (int, Enum), (float, Enum)).c3lK|],}t|ttfxrt|t.ywr>)reintfloatr r`ras r-rcz,_literal_has_numeric_enum..s*ks:cC<0JZT5JJks24rc32K|]}t|ywr>)_literal_has_numeric_enumrs r-rcz,_literal_has_numeric_enum..sRc,S1RsF)r is_literalrrrrrr)rwrs r-rr~s  J!78kV^_iVjkkk"":j#9:$Q'(//z*-.RXj=QRRR r,ct|rt|dr |jSt|r |jSt d|j d)z.Get fields from a pydantic model or dataclass.__pydantic_fields__zError: z? is not subclass of BaseModel or pydantic.dataclasses.dataclass)rrrrrrr&) model_clss r-_get_model_fieldsrsRY'GI?T,U,,,i %%% ')"4"4!55tu vvr,cddlm}m}g}d} |r!t|j|j fs ||gz }d} nkg} |j |j n |j} t | tr|j| d} nnt | |rG| jD]7} t | tr|j| d} '| j| 9n| jt|| | D]} tt| jd} |s| jn| } |It| jdkDr,t | jdtr| jdnd|| <|r| s|j| |r||vr|j|d} |s|Dcgc]}|j}}tt j#|| fScc}w)aGet alias names for a field, handling alias paths and case sensitivity. With `validate_by_alias=False` pydantic ignores the aliases, so only the field name is returned. The first name is the key that sources pass the value to pydantic under. r) AliasChoices AliasPathTFNr )pydanticrrraliasvalidation_aliasrerappendchoicesrpathr?lenrrfrufromkeys)r9r8alias_path_argsrApopulate_by_namevalidate_by_aliasrr alias_namesis_alias_path_onlynew_alias_pathsrr alias_path alias_names r-_get_alias_namesrs1K# C)9)9:;V;V(W$X |# "+-/9/J/J/V ++\f\l\l eS !   u %!&  | ,  1dC(&&t,).&#**40  1  " "4 5#9 :) )JZ__Q/0D'54::<4D**-joo*>*BzR\RaRabcRdfiGjJOOA&pt %#5""4( )  + =   z *!&   ??r,)r$rrrrrrrBrrrrrFr\rzrrrr<rN)r8rr9rr:r$returnNone)F)r@rrAboolrrr>)rD str | NonerErrzstr | EnvNoneType | None)FFN) rJMapping[str, str | None]rArrKrrErrr)r)rWzstr | os.PathLike[str]rXrrOrrz Path | None)rlr rbzdict[Any, Any]rr )rwr rr )rwr r list[Any]r:InitState | Nonerr)rrrztuple[Any, list[Any]])rrrr)rwtype[Any] | Nonerr)Nr+) rwrrrr:rrtuple[Any, ...]rr)rwr rrrr)TFFNFr+)rwr rrrrrrrrrzset[Any] | Nonerrrrrr)rwr rr)rwr rDr rr)rwr rr rr )rz type[Any]rzdict[str, FieldInfo])NTFT)r9rr8rrzdict[str, int | None] | NonerArrrrrrztuple[tuple[str, ...], bool])rr rMapping[str, Any])rrrr)rr rr)Qr) __future__r _annotationsosr6 collectionsrcollections.abcrrrr dataclassesrenumr itertoolsr pathlibr typingr r rrrrrrrrrpydantic._internal._utilsrpydantic.dataclassesrpydantic.fieldsrpydantic.typesrtyping_inspectionrtyping_inspection.introspectionr exceptionsrrutilsrrr"r$r<rBrFrNr\r_rzrrrrrrrrrrrrrrrrrrrr__all__r+r,r-rs862 -.$FF7746%!,;H'^ ^02i !!% &      ]b&4k0 F  8 "$(  !    2 s#$#%'@@ @@ @  @  @@#@ @F _   w59"" 4A4A4A24A 4A  4A  4A"4An] 8 4 @ r,