+ QV-jM >^RIt^RIt^RIt^RIt^RIt^RIHtHtHt^RI H t H t ^RI H t ^RI Ht^RIHt^RIHt^RIHtHtHtHtHt^RIt]!R ]4t]!R ]4tR tR R ltRRRRR]P<R]P<RR/RRllt!RR]4t R#)N)ArgumentDefaultsHelpFormatterArgumentParserArgumentTypeError)CallableIterable)copy)Enum)isclass)Path)AnyLiteralNewTypeUnionget_type_hints DataClass DataClassTypec\V\4'dV#VP4R9dR#VP4R9dR#\RV R24h)yesTFzTruthy value expected: got zJ but expected one of yes/no, true/false, t/f, y/n, 1/0 (case insensitive).)rtruety1)nofalsefn0) isinstanceboollowerr)vs&j/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/transformers/hf_argparser.pystring_to_boolr#$sR!Twwy22 4 4)!,v w  cTV^8dQhR\R\\.\3,/#)choicesreturn)listrstrr )formats"r" __annotate__r,1s% 3 3t 3#0D 3r$cRaVUu/uFp\V4VbK upoV3Rl#uupi)a2 Creates a mapping function from each choices string representation to the actual value. Used to support multiple value types for a single argument. Args: choices (list): List of choices. Returns: Callable[[str], Any]: Mapping function from string representation to actual value for each choice. c&<SPW4#N)get)arg str_to_choices&r"+make_choice_type_function..=s}((2r$)r*)r'choicer2s& @r"make_choice_type_functionr61s.8??wVS[&(w?M 22@s$aliaseshelpdefaultdefault_factorymetadatac V^8dQhR\\\,,R,R\R,R\R\.\3,R\R,R\ P /#)r&r7Nr8r9r:r;r()r*r)r rdict dataclassesField)r+s"r"r,r,@sr,l,l 49_t #,l *,l ,l b#g& ,l Tk ,l,lr$c fVf/pVeWR&VeWR&\P!RRVRVRV/VB#)aArgument helper enabling a concise syntax to create dataclass fields for parsing with `HfArgumentParser`. Example comparing the use of `HfArg` and `dataclasses.field`: ``` @dataclass class Args: regular_arg: str = dataclasses.field(default="Huggingface", metadata={"aliases": ["--example", "-e"], "help": "This syntax could be better!"}) hf_arg: str = HfArg(default="Huggingface", aliases=["--example", "-e"], help="What a nice syntax!") ``` Args: aliases (Union[str, list[str]], optional): Single string or list of strings of aliases to pass on to argparse, e.g. `aliases=["--example", "-e"]`. Defaults to None. help (str, optional): Help string to pass on to argparse that can be displayed with --help. Defaults to None. default (Any, optional): Default value for the argument. If not default or default_factory is specified, the argument is required. Defaults to dataclasses.MISSING. default_factory (Callable[[], Any], optional): The default_factory is a 0-argument function called to initialize a field's value. It is useful to provide default values for mutable types, e.g. lists: `default_factory=list`. Mutually exclusive with `default=`. Defaults to dataclasses.MISSING. metadata (dict, optional): Further metadata to pass on to `dataclasses.field`. Defaults to None. Returns: Field: A `dataclasses.Field` with the desired properties. r7r8r;r9r:)r>field)r7r8r9r:r;kwargss$$$$$,r"HfArgrD@sQH%     kh k kQ` kdj kkr$caa]tRt^otoRtRV3RlV3Rlllt]V3RlRl4tV3RlRltRV3RlR llt RV3R lR llt RV3R lR llt RV3RlRllt V3Rlt RtVtV;t#)HfArgumentParsera This subclass of `argparse.ArgumentParser` uses type hints on dataclasses to generate arguments. The class is designed to play well with the native argparse. In particular, you can add more (non-dataclass backed) arguments to the parser after initialization and you'll get the output back after parsing as an additional namespace. Optional: To create sub argument groups use the `_argument_group_name` attribute in the dataclass. Args: dataclass_types (`DataClassType` or `Iterable[DataClassType]`, *optional*): Dataclass type, or list of dataclass types for which we will "fill" instances with the parsed args. kwargs (`dict[str, Any]`, *optional*): Passed to `argparse.ArgumentParser()` in the regular way. cN<V^8dQhRS[S[S[,,R,/#)r&dataclass_typesN)rr)r+ __classdict__s"r"r,HfArgumentParser.__annotate__s$11 8O(ORV(V1r$c .<Vf.pM\V\4'gV.pRV9d \VR&\SV`!R/VB\ P !V4'dV.p\V4VnVPFpVPV4K R#)Nformatter_classrA) rrrsuper__init__r> is_dataclassr)rH_add_dataclass_arguments)selfrHrCdtype __class__s&&, r"rNHfArgumentParser.__init__s  " OOX66./O F *(EF$ % "6"  # #O 4 4./O#O4))E  ) )% 0*r$c:<V^8dQhRS[RS[P/#)r&parserrB)rr>r?)r+rIs"r"r,rJs%gg~gk>O>Ogr$c RVP 2.pRVP9d/VPRVPPRR4 24VPP 4p\ VP \4'd \R4hVPR.4p\ V\4'dV.p\VP RVP 4pV\Jg9\\R4'Ed\ V\P4'Ed\VP P9db\!VP P4^8wg%\ R4VP P9d\#RVP R 24h\ R4VP P9dVP P^,\JdVP P^,MVP P^,Vn\VP RVP 4pM\$VP P9d\ RVP P^,4'dVP P^,MVP P^,Vn\VP RVP 4p/pV\&JgA\ VP \ 4'd\)VP \*4'dV\&JdVP PVR &M(VP Uu.uFqwP,NK upVR &\/VR ,4VR &VP0\2P4JdVP0VR &EMR VR&EMVP \$JgVP \$R,8Xd\ V4p\6VR &VP \$Jg-VP0eYVP0\2P4Jd;VP0\2P4JdRM VP0pWR &RVR&R VR&EM\9V4'd\)V\:4'd|VP P^,VR &RVR&VP<\2P4JdVP=4VR &MVP0\2P4JdR VR&MtVP VR &VP0\2P4JdVP0VR &M7VP<\2P4JdVP=4VR &MR VR&VP>!.VOVO5/VBVP0R JdVP \$JgVP \$R,8XdTRVR &VP>!RVP 2RVPPRR4 23RRRVP/VBR#R#R#uupi)z--_-zpUnresolved type detected, which should have been done with the help of `typing.get_type_hints` method by defaultr7 __origin__ UnionTypeNzOnly `Union[X, NoneType]` (i.e., `Optional[X]`) is allowed for `Union` because the argument parser only supports one type per argument. Problem encountered in field 'z'.r'typer9TrequiredF?nargsconst+z--no_z--no-action store_falsedest) nameappendreplacer;rrr\r* RuntimeErrorpopgetattrrhasattrtypesr[__args__len ValueErrorrr issubclassr valuer6r9r>MISSINGr#r r)r: add_argument) rVrB long_optionsrCr7 origin_type bool_kwargsxr9s && r"_parse_dataclass_field'HfArgumentParser._parse_dataclass_fields UZZL)* %**    "UZZ%7%7S%A$B C D$$& ejj# & &<  **Y+ gs # #iGejj, C % GE;$?$?J{\a\k\kDlDl%**---EJJ''(A-d5::CVCV1V 66;jj\E Dz!4!447\>G>v> ==D ejjD&8EJJ$QU+fieldsinitrer\rx)rQrRrV type_hintsrBs&& r"rP)HfArgumentParser._add_dataclass_argumentss 50 1 1,,U-G-GHFF *8*?J!''.E:::#JJ/EJ  ' ' 6 / -eW566  s BB3c4<V^8dQhRS[S[R3,/#)r&r(.)tupler)r+rIs"r"r,rJs#TT y#~ Tr$c V'g2V'g*V'Ed\\P4'Ed.pV'dVP\ V44MeV'd^\\P4'd?VP\ \P^,4P R44V'd\ 4pVPV\RR7VPVR7wr\V4PVPR4R4p V 'd+TPV U u.uFp \ V 4NK up 4.p VF?p V P4'gKWP4P!4, p KA Ve W,MV \PR,,pVPVR7wr.pVP"Fp\$P&!V4Uu0uF#pVP('gKVP*kK% pp\V 4P-4UUu/uFwppVV9gKVVbK pppVFp\/V V4K V!R /VBpVPV4K \V P04^8dVPV 4V'd.VOVN5#V'd\3RV 24h.VO5#uup iuupiuuppi) am Parse command-line args into instances of the specified dataclass types. This relies on argparse's `ArgumentParser.parse_known_args`. See the doc at: docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_args Args: args: List of strings to parse. The default is taken from sys.argv. (same as argparse.ArgumentParser) return_remaining_strings: If true, also return a list of remaining argument strings. look_for_args_file: If true, will look for a ".args" file with the same base name as the entry point script for this process, and will append its potential content to the command line args. args_filename: If not None, will uses this file instead of the ".args" file specified in the previous argument. args_file_flag: If not None, will look for a file in the command-line args specified with this flag. The flag can be specified multiple times and precedence is determined by the order (last one wins). Returns: Tuple consisting of: - the dataclass instances in the same order as they were passed to the initializer.abspath - if applicable, an additional namespace for more (non-dataclass backed) arguments added to the parser after initialization. - The potential list of remaining argument strings. (same as argparse.ArgumentParser.parse_known_args) z.argsrf)r\rb)argsrYN:NNz?Some specified arguments are not used by the HfArgumentParser: rA)rnsysargvrfr with_suffixrrsr*parse_known_argsvarsr0lstripextendexists read_textsplitrHr>rrreitemsdelattr__dict__ro)rQrreturn_remaining_stringslook_for_args_file args_filenameargs_file_flag args_filesargs_file_parsercfgcmd_args_file_pathsp file_args args_file namespaceremaining_argsoutputsrRrkeyskr!inputsobjs&&&&&& r"parse_args_into_dataclasses,HfArgumentParser.parse_args_into_dataclassess`J ]/A/Ac#((mmJ!!$}"56#CHH !!$sxx{"3"?"?"HI#1#3  --n3x-X-==4=H &*3immN4I4I#4NPT&U#&%%8K&L8K1tAw8K&LMI' ##%%!4!4!6!>I( (,'79#YRT=UD$($9$9t$9$D! ))E$/$6$6u$=H$=qFAFF$=DH'+I'<'<'>L'>tq!!t)dad'>FL 1%/&/C NN3  * y!! "Q & NN9 % #-W-n- - #bcqbr!sttW; 9'MILsK5 K:%K: K?$K?cV<V^8dQhRS[S[S[3,RS[RS[S[R3,/#)r&rallow_extra_keysr(.)r=r*r rrr)r+rIs"r"r,rJfs7tCH~RWXacfXfRgr$c "\VP44p.pVPFp\P!V4Uu0uF"qfP 'gKVP kK$ ppVP4UU u/uFwrW9gK WbK p pp VPV P44V!R/V Bp VPV 4K V'g V'd\R\V4 24h\V4#uupiuup pi)a Alternative helper method that does not use `argparse` at all, instead uses a dict and populating the dataclass types. Args: args (`dict`): dict containing config values allow_extra_keys (`bool`, *optional*, defaults to `False`): Defaults to False. If False, will raise an exception if the dict contains keys that are not parsed. Returns: Tuple consisting of: - the dataclass instances in the same order as they were passed to the initializer. z0Some keys are not used by the HfArgumentParser: rA) setrrHr>rrrerdifference_updaterfrosortedr) rQrr unused_keysrrRrrrr!rrs &&& r" parse_dictHfArgumentParser.parse_dictfs $))+& ))E$/$6$6u$=H$=qFAFF$=DH'+zz|A|tqqydad|FA  ) )&++- 8/&/C NN3  *  KOPVWbPcOdef fW~IAsDD D D cd<V^8dQhRS[S[P,RS[RS[S[R3,/#)r& json_filerr(.r*osPathLikerrr)r+rIs"r"r,rJs8r{{):d_denpses_tr$c \\V4RR7;_uu_4p\P!VP 44pRRR4VP XVR7p\ V4# +'giL.;i)a Alternative helper method that does not use `argparse` at all, instead loading a json file and populating the dataclass types. Args: json_file (`str` or `os.PathLike`): File name of the json file to parse allow_extra_keys (`bool`, *optional*, defaults to `False`): Defaults to False. If False, will raise an exception if the json file contains keys that are not parsed. Returns: Tuple consisting of: - the dataclass instances in the same order as they were passed to the initializer. zutf-8)encodingNr)openr jsonloadsreadrr)rQrropen_json_filedatars&&& r"parse_json_file HfArgumentParser.parse_json_filesY"$y/G 4 4::n1134D5//$9I/JW~5 4s %A** A: cd<V^8dQhRS[S[P,RS[RS[S[R3,/#)r& yaml_filerr(.r)r+rIs"r"r,rJs8r{{):d_denpses_tr$c VP\P!\V4P 44VR7p\ V4#)a Alternative helper method that does not use `argparse` at all, instead loading a yaml file and populating the dataclass types. Args: yaml_file (`str` or `os.PathLike`): File name of the yaml file to parse allow_extra_keys (`bool`, *optional*, defaults to `False`): Defaults to False. If False, will raise an exception if the json file contains keys that are not parsed. Returns: Tuple consisting of: - the dataclass instances in the same order as they were passed to the initializer. r)ryaml safe_loadr rr)rQrrrs&&& r"parse_yaml_file HfArgumentParser.parse_yaml_files7"//$..i1J1J1L"M`p/qW~r$c6<V^8dQh/S[S[,;R&#)r&rH)rr)r+rIs"r"r,rJosm,,r$)rHr/)NFTNN)F)__name__ __module__ __qualname____firstlineno____doc__rN staticmethodrxrPrrrr__annotate_func____static_attributes____classdictcell__ __classcell__)rSrIs@@r"rFrFosh  11"ggR77*TTl8,S r$rF)!r>rrrrlargparserrrcollections.abcrrrenumr inspectr pathlibr typingr r rrrrrrr#r6rrrDrFrAr$r"rs UU.??  K % -    3,l&*,l,l&& ,l *5)<)< ,l ! ,l^{~{r$