pyie%SSKrSSKrSSKrSSKJr SSKJrJrJrJ r J r J r SSK J r Jr SSKJrJrJrJrJrJrJrJrJrJr SSKJrJr S S KJ r J!r!J"r" \\/S4r#\"S 5r$\"S \%\&\4S9r'\("5r)\S\\$S\\$4Sj5r*\SS.S\+S\\\$/\\$44Sjj5r*S>SS.S\\$S-S\+S\\$\\\$/\\$4-4Sjjjr*S\\'S\%SS4Sjr,\ S\\'S\4Sj5r-S\\'S\%\&\44Sjr.\\SSSSS4S\/\#\#-S\\-S\/\4\-S \+S!\+S"\+S-S#\+S$\%S-S%\S\4S&jjr0S\#4S'jr1S(\&S)\S*\SS4S+jr2S(\&S)\SS4S,jr3S(\&S)\S-\4\S.4SS4S/jr5S(\&S)\S-\4\S.4SS4S0jr6S(\&S)\S-\4\S.4SS4S1jr7S(\&S)\S-\4\S.4SS4S2jr8S(\&S)\S-\4\S.4SS4S3jr9S(\&S)\S-\4\S.4SS4S4jr:S(\&S)\S-\4\S.4SS4S5jr;S(\&S)\S*\SS4S6jrS:\S\+4S;jr?\\5\\6\/\7\%\8\4\9\@\:\RR\;0rC\%\\\&\\4\S.4/S44\DS<'\5\C\R'/S=QrFg!\a/ SSKJrJr GN!\a \"SS05r\"S S05rGN5f=ff=f)?N)Callable) _MISSING_TYPEMISSINGFieldfieldfieldsmake_dataclass) lru_cachewraps) AnnotatedAny ForwardRefLiteralTypeTypeVarUnionget_args get_originoverload) NotRequiredRequiredrr)#StrictDataclassClassValidationErrorStrictDataclassDefinitionError#StrictDataclassFieldValidationErrorT TypedDictType)boundclsreturncgNr)r s X/home/mande/repo/quber/.venv/lib/python3.13/site-packages/huggingface_hub/dataclasses.pystrictr%0s%(F accept_kwargsr(cgr#rr's r$r%r%4sLOr&cb^S[[S[[4U4SjjnUbU"U5$U$)a Decorator to add strict validation to a dataclass. This decorator must be used on top of `@dataclass` to ensure IDEs and static typing tools recognize the class as a dataclass. Can be used with or without arguments: - `@strict` - `@strict(accept_kwargs=True)` Args: cls: The class to convert to a strict dataclass. accept_kwargs (`bool`, *optional*): If True, allows arbitrary keyword arguments in `__init__`. Defaults to False. Returns: The enhanced dataclass with strict validation on field assignment. Example: ```py >>> from dataclasses import dataclass >>> from huggingface_hub.dataclasses import as_validated_field, strict, validated_field >>> @as_validated_field >>> def positive_int(value: int): ... if not value >= 0: ... raise ValueError(f"Value must be positive, got {value}") >>> @strict(accept_kwargs=True) ... @dataclass ... class User: ... name: str ... age: int = positive_int(default=10) # Initialize >>> User(name="John") User(name='John', age=10) # Extra kwargs are accepted >>> User(name="John", age=30, lastname="Doe") User(name='John', age=30, *lastname='Doe') # Invalid type => raises >>> User(name="John", age="30") huggingface_hub.errors.StrictDataclassFieldValidationError: Validation error for field 'age': TypeError: Field 'age' expected int, got str (value: '30') # Invalid value => raises >>> User(name="John", age=-1) huggingface_hub.errors.StrictDataclassFieldValidationError: Validation error for field 'age': ValueError: Value must be positive, got -1 ``` r r!c >^^^^[TS5(d[STRS35e0n[T5Hn/nUR [ U55 UR RS5nUb^[U[5(dU/nUH/n[U5(aM[SURSUS35e URU5 X1UR'M UTl TRmS[S [ S [S S4U4S jjnUTlT(aTR"n[%U5S [S S4U4Sjj5nUTl[TS5(dS [S S4Sjn U TlTR(m[%T5S [ 4UU4Sjj5n TR*R,SLaU Tl/n [/T5Hn U R1S5(dMU 5n [5U 5(dM9[7[8R:"U 5R<5S:wa[STRSU S35eU R U 5 M U TlS[@S S4U4SjjnSUl![TS5(a5[3TRDSS5(d[STRS35eUTl"TR"m[%T5SUU4Sjj5n[GTSU5 T$)N__dataclass_fields__zClass 'z.' must be a dataclass before applying @strict. validatorzInvalid validator for field '': z.. Must be a callable taking a single argument.selfnamevaluer!c>URRU/5H nU"U5 M T"XU5 g![[4an[ XS9UeSnAff=f)z1Custom __setattr__ method for strict dataclasses.)rcauseN)__validators__get ValueError TypeErrorr)r/r0r1r-eoriginal_setattrs r$__strict_setattr__0strict..wrap..__strict_setattr__sc"0044T2> Ze$? T / #I.Z=DRXYYZs8A AAkwargsc(>[T 5Vs1sHo3RiM nnUR5VVs0sHupVXT;dM XV_M nnn[U5S:a%[ ST R S[U5S35e[T 5HnURU;a$[ XRXsR5 M7UR[La"[ XRUR5 MlUR[La&[ XRUR55 M[SURS35e 0nUR5HupX;dM XU 'M UR"S0UD6 gs snfs snnf)NrzWhen `accept_kwargs=True`, z, accepts only keyword arguments, but found `z` positional args.zMissing required field - ''r) rr0itemslenr6__name__setattrdefaultrdefault_factoryr7 __post_init__) r/argsr<fdataclass_fieldskvstandard_kwargsadditional_kwargsr0r1r s r$__init__&strict..wrap..__init__sT5;3K#@KqFFK #@4:LLN"\NDAaF[414N"\ t9q=$5cll^D&&)$i[0BD  Avv0ffoff.EF'1ffaii8**'9ffa.?.?.AB'*DQVVHA(NOO%%'!#)<<>KD327$/$2""7%67=$A"\sF  FFrEcNUR5Hup#[XU5 M g)z2Default __post_init__ to accept additional kwargs.N)r?rB)r/r<r0r1s r$rE+strict..wrap..__post_init__s'-||~ E2(6r&c>T"U5nURR5VVs/sH up#UTR;dMSUSU<3PM" nnnSRU5nU(a USSSUS3$U$s snnf)N*=z, ))__dict__r?r,join)r/ standard_reprrIrJrLadditional_reprr original_reprs r$__repr__&strict..wrap..__repr__s!.d 3 !% 3 3 5%!6 8 88"as!A5M 5"% #')),=">GX-,-R/@Bj]jj%s A6 A6T validate_rz' has a class validator 'z' that takes more than one argument. Class validators must take only 'self' as an argument. Methods starting with 'validate_' are considered to be class validators.c>TRH nU"U5 M g![[4an[URUS9UeSnAff=f)z%Run class validators on the instance.)r-r3N)__class_validators__r6r7rrA)r/r-r8r s r$validate&strict..wrap..validatesP 55 ldO6#I.l= HZHZbcdjkklsA AA r`"__is_defined_by_strict_decorator__Fz' already implements a method called 'validate'. This method name is reserved when using the @strict decorator on a dataclass. If you want to keep your own method, please rename it.c@>T"U/UQ70UD6 TRU5 g)z*Run class validators after initialization.N)r`)r/rFr<r initial_inits r$init_with_validate0strict..wrap..init_with_validates#  / / / LL r&rM)r!N)$hasattrrrArappend_create_type_validatormetadatar5 isinstancelist _is_validatorr0extendr4 __setattr__r strrMr rEr[__dataclass_params__reprdir startswithgetattrcallabler@inspect signature parametersr_rrbr`rB)r field_validatorsrG validatorscustom_validatorr-r: original_initrMrEr[class_validatorsr0methodr`rerdrZr9r(s` @@@r$wrapstrict..wrappss2330#,,'UV  :<AJ   4Q7 8 zz~~k: +!"2D99(8'9$!1I(33<;AFF83ykQA"2 !!"23'1QVV $.?? 0S 0 0C 0D 0- LLM = ! 8 8 8" 8D$CL3003#3$3 %2! LLM = ! k# k" k '',,4' HD??;//S$'FF##7$$V,778A=4cll^+DTFK>>  # #F +$4  l1 l l7;3 3 # #3<<)MuUU4cll^,NN   || |     Z!34 r&)rr)r r(rs ` r$r%r%8s8ph$q'hd1ghV491T1r&schemadatac*[U5nU"S0UD6 g)an Validate that a dictionary conforms to the types defined in a TypedDict class. Under the hood, the typed dict is converted to a strict dataclass and validated using the `@strict` decorator. Args: schema (`type[TypedDictType]`): The TypedDict class defining the expected structure and types. data (`dict`): The dictionary to validate. Raises: `StrictDataclassFieldValidationError`: If any field in the dictionary does not conform to the expected type. Example: ```py >>> from typing import Annotated, TypedDict >>> from huggingface_hub.dataclasses import validate_typed_dict >>> def positive_int(value: int): ... if not value >= 0: ... raise ValueError(f"Value must be positive, got {value}") >>> class User(TypedDict): ... name: str ... age: Annotated[int, positive_int] >>> # Valid data >>> validate_typed_dict(User, {"name": "John", "age": 30}) >>> # Invalid type for age >>> validate_typed_dict(User, {"name": "John", "age": "30"}) huggingface_hub.errors.StrictDataclassFieldValidationError: Validation error for field 'age': TypeError: Field 'age' expected int, got str (value: '30') >>> # Invalid value for age >>> validate_typed_dict(User, {"name": "John", "age": -1}) huggingface_hub.errors.StrictDataclassFieldValidationError: Validation error for field 'age': ValueError: Value must be positive, got -1 ``` Nr)!_build_strict_cls_from_typed_dict)rr strict_clss r$validate_typed_dictrsX36:Jr&c [U5n[USS5(dUR5H~up#[U5nU[LaH[ U5tpV[ U5(d [Un[[U/[U5-5X'Ma[ U5(aMs[UX'M /nUR5Hiup#[U5[La3[ U5tpVUR"X%[[SUS0S945 MJUR"X#[[S945 Mk [[URU55$)N __total__Tr-r)rCrj)rC)_get_typed_dict_annotationsrur?rr r_is_required_or_notrequiredrtuplerlrhr_TYPED_DICT_DEFAULT_VALUEr%r rA)r type_hintskeyr1originbasemetars r$rrPs"-V4J 6; - -$**,JC&F"&uo 2488&t,D"+E4&4:2E,F"G 077"-e"4 -F &&(  e  )"5/KD MM3e4MYdfjklfmXn&op q MM3u5N'OP Q ) .&9 ::r&c SSKnURU5$![aW URR S05R 5VVs0sHup#X#bUO [ S5_M Os snnfsnns$f=f)z0Extract type annotations from a TypedDict class.rN__annotations__) annotationlibget_annotations ImportErrorrVr5r?type)rrr0r1s r$rrosz  ,,V44  &223DbIOOQ   R  ,%$t* <Q    s7A8A+* A87A8Tr-rCrDinitrrhashcomparerjr<c j[U[5(dU/nUc0nXS'[SUUUUUUUS.UD6$)a Create a dataclass field with a custom validator. Useful to apply several checks to a field. If only applying one rule, check out the [`as_validated_field`] decorator. Args: validator (`Callable` or `list[Callable]`): A method that takes a value as input and raises ValueError/TypeError if the value is invalid. Can be a list of validators to apply multiple checks. **kwargs: Additional arguments to pass to `dataclasses.field()`. Returns: A field with the validator attached in metadata r-rCrDrrrrrrjr)rkrlr) r-rCrDrrrrrrjr<s r$validated_fieldrs\4 i & &K %[  '       r&c^[[SSSSS4S[[-S[/[4[-S[S[S[S-S[S [ S-S [4U4S jjjnU$) z Decorates a validator function as a [`validated_field`] (i.e. a dataclass field with a custom validator). Args: validator (`Callable`): A method that takes a value as input and raises ValueError/TypeError if the value is invalid. TNrCrDrrrrrrjr<c ,>[T4UUUUUUUS.UD6$)Nr)r) rCrDrrrrrrjr<r-s r$_inner"as_validated_field.._inners9   +    r&)rr rrbooldict)r-rs` r$as_validated_fieldrs(/=D  $ }$ !"c'*]:    Tk    +   , Mr&r0r1 expected_typec[U5n[U5nU[LagUc [X5 g[R U5=n(a U"XU5 g[ U[5(a [XU5 g[ U[5(d[ U[5(agU[La(U[La[SUS35e[XUS5 gU[LaU[Lag[XUS5 g[SUSU35e)z.Validate that 'value' matches 'expected_type'.NField 'z' is required but missing.rzUnsupported type for field 'r.)rrr _validate_none_BASIC_TYPE_VALIDATORSr5rkr_validate_simple_typerrprrr7type_validatorr)r0r1rrrFr-s r$rrs  &F M "D  t#,008 8 8$t$ M4 ( (d=9 M: . .*]C2P2P 8  - -gdV+EFG GtDG, ;  - - tDG,6tfC OPPr&cRUb$[SUS[U5R35eg)zValidate None type. 'None' is not a type, it's a special value. Type should be `NoneType` instead. But in type annotations 'None' is accepted so we must support it. Nrz' expected None, got )r7rrA)r0r1s r$rrs3  '$'N)rkrlr7rrA enumeraterr0r1rF item_typeiitemr8s r$_validate_listr s eT " "'$'>tE{?S?S>TUVVQIU# R dV1QCq>4 ;$ R4QCz$qIJPQ Q RsA'' B 1BB c:[U[5(d$[SUS[U5R35eUup4UR 5H(upV[ US3XS5 [ USU<S3Xd5 M* g![an[SUS35UeSnAff=f) zValidate dict[K, V] type.rz' expected a dict, got z.keyrrzInvalid key or value in dict 'r>N)rkrr7rrAr?r)r0r1rFkey_type value_typerIrJr8s r$_validate_dictrs eT " "'$'>tE{?S?S>TUVV H  M dV4=! 6 dV1QE+Q ; MNz' expected a tuple of length r) rkrr7rrAr@Ellipsisrrzip)r0r1rFrrr8expecteds r$_validate_tupler)sT eU # #'$'?U @T@T?UVWW 4yA~$q'X- 'GA W$q1~t!W=( Tc%j '$'DSYKvVYZ_V`Uabcc#,S-=#> A W$q1~t>$?  W"8;tfA NOUVV W W"8;tfA NOUVV Ws0&C2D2 D<DD D9!D44D9c [U[5(d$[SUS[U5R35eUSn[ U5HupE[ US3XS5 M g![an[SUS35UeSnAff=f)zValidate set[T] type.rz' expected a set, got rz itemzInvalid item in set 'r>N)rksetr7rrArrrs r$ _validate_setr@s eS ! !'$'=d5k>R>R=STUUQIU# D dV5>4 ;$ D3D6;>Bc P[U[RR5(d$[ SUS[ U5R 35eU(dgUSn[U5HupE[USUS3XS5 M g![an[ SUSUS 35UeSnAff=f) z&Validate Sequence or Sequence[T] type.rz' expected a Sequence, got Nrrrrz in sequence 'r>) rk collectionsabcSequencer7rrArrrs r$_validate_sequencerNs e[__55 6 6'$'B4;CWCWBXYZZ QIU# V dV1QCq>4 ;$ V4QC~dV1MNTU U Vs,B B% B  B%c XU[LaS[U[5(a>[SUSURS[ U5RS[ U5S3 5e[X5(d>[SUSURS[ U5RS[ U5S3 5eg)z&Validate simple type (int, str, etc.).rz ' expected rz (value: rUN)rrkrr7rArrr)r0r1rs r$rr`s 5$ 7 7dV;}'='=&>fT%[EYEYDZZcdhindocppq r   e + +dV;}'='=&>fT%[EYEYDZZcdhindocppq r   ,r&rc(^S[SS4U4SjjnU$)z-Create a type validator function for a field.r1r!NcH>[TRUTR5 gr#)rr0r)r1rs r$r-)_create_type_validator..validatorpsuzz5%**5r&)r )rr-s` r$ririls666 r&c[U5(dg[R"U5n[URR 55n[ U5S:XagUSR[RR[RR[RR4;agUSSH-nUR[RR:XdM- g g)zCheck if a function is a validator. A validator is a Callable that can be called with a single positional argument. The validator can have more arguments with default values. Basically, returns True if `validator(value)` is possible. FrrNT)rvrwrxrlryvaluesr@kind ParameterPOSITIONAL_OR_KEYWORDPOSITIONAL_ONLYVAR_POSITIONALrCempty)r-rxry parameters r$rmrmvs I  !!),Ii**1134J :!!}//))((" ^    1 1 7 7 7$ r& type_hintc^U[[4;=(d [U5[[4;$)z2Helper to check if a type is Required/NotRequired.)rrr)rs r$rrs' ;/ / eJy4IhXcMd4der&r)r%rr Validator_Trrrr#)Gcollections.abcrrwtypesr dataclassesrrrrrr functoolsr r typingr r rrrrrrrrrrrtyping_extensionsrrrrrrrrrprobjectrr%rrrrrlrrrrrrrrrrrrrrirmrrrrrr UnionType__all__rr&r$rs $TT&    2,ud{#  CLtCH~> "H (Q(DG( ( $)OTOhQy$q'7I.JO Oc2c2Q$c2c2$q'T\^bcd^e]fhlmnho]oTpJpc2L/] 3/4/D/d ;d=.A;d; ;<  ](;  S#X  $$+9@ (K ;.( = (b#g&6(  (  ( + ((Tk(( (V+DQQSQQQ6UUSUTU # c sCx T  OC O O5c? Ot O R RS Rc3h RD R M MS Mc3h MD MW#WcWsCxWTW. D DC DuS#X D4 DVSVVE#s(OVV$    C      %KST6f3f4f  ? .. ?OO0RS(CeCHo+F+L"MMN+:u' Y22;; 2 B+="b1 2 2s*IJI$$J>JJJ