+ i~CRt^RIHt^RIt^RIt^RIt^RIt^RIHtH t H t H t H t ^RI Ht^RI Ht] ]]]3,t] ]]P(] ]] ]].]3,3,] ],]P*]P,3,t] ].]3,tRRltRR lt]P6!R R 7!R R ]P844tRRRllt!RR]P>4t !RR]P>4t!!RR]P>4t"]P6!R R 7!RR]44t#!RR]#4t$!RR]4t%]P6!R R 7!RR]44t&R#)aYClasses that define arguments for populating ArgumentParser. The argparse module's ArgumentParser.add_argument() takes several parameters and is quite customizable. However this can lead to bugs where arguments do not behave as expected. For better ease-of-use and better testability, define a set of classes for the types of flags used by LLM Magics. Sample usage: str_flag = SingleValueFlagDef(name="title", required=True) enum_flag = EnumFlagDef(name="colors", required=True, enum_type=ColorsEnum) str_flag.add_argument_to_parser(my_parser) enum_flag.add_argument_to_parser(my_parser) ) annotationsN)AnyCallableSequenceTupleUnion)llmfn_inputs_source) llmfn_outputsc V^8dQhRRRR/#)x type[Any]returnstr)formats"x/Users/igloo/.openclaw/workspace/scratch/fb_ad_env/lib/python3.14/site-packages/google/generativeai/notebook/flag_def.py __annotate__r?siCcTVP# \d\T4u#i;iN)__name__AttributeErrorrr s&r_get_type_namer?s)zz 1v s ''c V^8dQhRRRR/#)r namerrr)rs"rrrFsccrc^V'g \R4hV^,R8Xd \R4hV#)z.Validation for long and short names for flags.zCannot be empty-zCannot start with dash) ValueError)rs&r_validate_flag_namer Fs- *++ Aw#~122 KrT)frozenc]tRt^Ot$RtR]R&RtR]R&RtR]R &]t R ]R &Rt R ]R &Rt R]R&Rt R]R&Rt R]R&]PRRl4t]PRRl4tRRltRRltRtRtR#)FlagDefaAbstract base class for flag definitions. Attributes: name: Long name, e.g. "colors" will define the flag "--colors". required: Whether the flag must be provided on the command line. short_name: Optional short name. parse_type: The type that ArgumentParser should parse the command line argument to. dest_type: The type that the parsed value is converted to. This is used when we want ArgumentParser to parse as one type, then convert to a different type. E.g. for enums we parse as "str" then convert to the desired enum type in order to provide cleaner help messages. parse_to_dest_type_fn: If provided, this function will be used to convert the value from `parse_type` to `dest_type`. This can be used for validation as well. choices: If provided, limit the set of acceptable values to these choices. help_msg: If provided, adds help message when -h is used in the command line. rrFboolrequiredN str | None short_nameztype[_PARSETYPES] parse_typeztype[_DESTTYPES] | None dest_typez_PARSEFN | Noneparse_to_dest_type_fnzlist[_PARSETYPES] | Nonechoiceshelp_msgc V^8dQhRRRR/#r parserargparse.ArgumentParserrNoner)rs"rrFlagDef.__annotate__rs  -D  rc R#)zAdds this flag as an argument to `parser`. Child classes should implement this as a call to parser.add_argument() with the appropriate parameters. Args: parser: The parser to which this argument will be added. Nr)selfr/s&&radd_argument_to_parserFlagDef.add_argument_to_parserqrcV^8dQhRR/#r rr1r)rs"rrr2}s==4=rc R#)z.For child classes to do additional validation.Nrr4s&r_do_additional_validation!FlagDef._do_additional_validation|r7rcV^8dQhRR/#)r rztype[_DESTTYPES]r)rs"rrr2sMM 0Mrc NVPf VP#VP#)z!Returns the final converted type.)r)r(r;s&r_get_dest_typeFlagDef._get_dest_types"&.."8tLdnnLrcV^8dQhRR/#)r r_PARSEFNr)rs"rrr2s    rc VPe VP#VP4pWP8XdR#V#)z;Returns a function to convert from parse_type to dest_type.cV#rrrs&r4FlagDef._get_parse_to_dest_type_fn..sQr)r*r@r()r4r)s& r_get_parse_to_dest_type_fn"FlagDef._get_parse_to_dest_type_fns@  % % 1-- -'')  '  rc \VP4VPe\VP4VP4R#r)r rr'r<r;s&r __post_init__FlagDef.__post_init__s0DII& ?? &  0 &&(rr)r __module__ __qualname____firstlineno____doc____annotations__r%r'rr(r)r*r+r,abcabstractmethodr5r<r@rHrK__static_attributes__rrrr#r#Os( IHd!J !$'J!')-I&--1?1(,G %,Hj   ==M )rr#c ,V^8dQhRRRRRRRRR R/#) r namespaceargparse.Namespacedestr has_defaultr$ default_valuerrr)rs"rrrs:55!5 55 5  5rcX\W4'gR#V'gR#\W4V8g#)aReturns true if `namespace.dest` is set to a non-default value. Args: namespace: The Namespace that is populated by ArgumentParser. dest: The attribute in the Namespace to be populated. has_default: "None" is a valid default value so we use an additional `has_default` boolean to indicate that `default_value` is present. default_value: The default value to use when `has_default` is True. Returns: Whether namespace.dest is set to something other than the default value. FT)hasattrgetattr)rVrXrYrZs&&&&r_has_non_default_valuer^s*$ 9 # #  9 #} 44rcBa]tRt^tRtRV3RlltRRRlltRtV;t#)_SingleValueStoreActionzyCustom Action for storing a value in an argparse.Namespace. This action checks that the flag is specified at-most once. c V^8dQhRRRR/#r r)r r*rCr)rs"rr$_SingleValueStoreAction.__annotate__ < < < (  ,,,T3J3Q3QRW3XYY   o .) ,,7>>q >$q'#:A s8D E& AE!!E&rrrrs@rrrs < <#/#/rrc<a]tRtRtRtV3RltRRRlltRtV;t#)_BooleanValueStoreActioni%zCustom Action for setting a boolean value in argparse.Namespace. The boolean flag expects the default to be False and will set the value to True. This action checks that the flag is specified at-most once. c *<\SV`!W3/VBR#r)rgrh)r4rlrXrmrns&&&,rrh!_BooleanValueStoreAction.__init__-s 88rc(V^8dQhRRRRRRRR/#rrr)rs"rr%_BooleanValueStoreAction.__annotate__5s2,,',&,+ , " ,rc \VVPRRR7'd'\P!VRP V44h\ W PR4R#)TFrwrxN)r^rXr}r~rr)r4r/rVrsrts&&&&&rr!_BooleanValueStoreAction.__call__5sQ "  II   ((/M/T/TUb/cd d 99d+rrrrrs@rrr%s9,,rrc]tRtRt$Rt!RR]P 4t]Pt R] R&RRlt R R lt R R lt R tR#)SingleValueFlagDefiGaODefinition for a flag that takes a single value. Sample usage: # This defines a flag that can be specified on the command line as: # --count=10 flag = SingleValueFlagDef(name="count", parse_type=int, required=True) flag.add_argument_to_parser(argument_parser) Attributes: default_value: Default value for optional flags. c]tRtRtRtRtRtR#) SingleValueFlagDef._DefaultValueiUzSpecial value to represent "no value provided". "None" can be used as a default value, so in order to differentiate between "None" and "no value provided", create a special value for "no value provided". Nr)rrMrNrOrPNOT_SETrTrrr _DefaultValuerUs rrz!_DESTTYPES | _DefaultValue | NonerZcV^8dQhRR/#)r rr$r)rs"rrSingleValueFlagDef.__annotate__asNNDNrc PVP\PP8g#)z2Returns whether `default_value` has been provided.)rZrrrr;s&r_has_default_value%SingleValueFlagDef._has_default_valueas !!%7%E%E%M%MMMrc V^8dQhRRRR/#r.r)rs"rrres  -D  rc RVP,.pVPeVRVP,., p/pVP4'dVPVR&VPeVPVR&VP eVP VR&VP !VR\RVPRVP4R VP4R VPR ^/VBR#) --Nrrvr+helpactionrr)r*r%nargs) rr'rrZr+r, add_argumentr`r(r@rHr%r4r/argsrms&& rr5)SingleValueFlagDef.add_argument_to_parserestyy ! ?? & S4??*+ +D  " " $ $ $ 2 2F9  << # $ F9  == $!]]F6N  *  ))+ #'"A"A"C ]]   rcV^8dQhRR/#r9r)rs"rrr}s c c4 crc jVP'd#VP4'd \R4hM!VP4'g \R4hVP4'dHVPe8\ VPVP 44'g \R4hR#R#R#)z(Required flags cannot have default valuez(Optional flags must have a default valueNz>Default value must be of the same type as the destination type)r%rrrZr{r@r;s&rr<,SingleValueFlagDef._do_additional_validation}s ===&&(( !KLL)**,, !KLL  " " $ $););)Gd00$2E2E2GHH !abbI*H $rrN)rrMrNrOrPenumEnumrrrZrQrr5r<rTrrrrrGsB  8E7L7LM4LN 0 c crrc2a]tRtRtRtRV3RlltRtV;t#) EnumFlagDefia8Definition for a flag that takes a value from an Enum. Sample usage: # This defines a flag that can be specified on the command line as: # --color=red flag = SingleValueFlagDef(name="color", enum_type=ColorsEnum, required=True) flag.add_argument_to_parser(argument_parser) cV^8dQhRR/#)r enum_typeztype[enum.Enum]r)rs"rrEnumFlagDef.__annotate__s***rc <\V\P4'g \R4hRV9d \ R4h\ VR&RV9d \ R4hWR&RV9dVR,F pV!V4K MVUu.uFqDPNK upVR&\SV`$!V/VBR# \d\ RP T44Rhi;iuupi)z "enum_type" must be of type Enumr(z@Cannot set "parse_type" for EnumFlagDef; set "enum_type" insteadr)z?Cannot set "dest_type" for EnumFlagDef; set "enum_type" insteadr+z Invalid value in "choices": "{}"N) issubclassrr TypeErrorrrrrrgrh)r4rrrmr rns&$*, rrhEnumFlagDef.__init__s)TYY//>? ? 6 !_` `"| & ^_ _'{  I&&]aL' 3< <)Q) > %IJ J  % % 1UV V << #GH H $rc V^8dQhRRRR/#r.r)rs"rrrs  -D  rc  RVP,.pVPeVRVP,., p/pVPeVPVR&VP!VR\R\ RRRRR ^/VBR#) rNrrrrr%Frvr)rr'r,rrr$rs&& rr5%BooleanFlagDef.add_argument_to_parserstyy ! ?? & S4??*+ +D == $!]]F6N  +         rrN)rrMrNrOrPr<r5rTrrrrrsI  rr)FN)'rP __future__rrRr} dataclassesrtypingrrrrr google.generativeai.notebook.librr rintfloat _PARSETYPESrLLMFnInputsSourceLLMFnOutputsSink _DESTTYPESrCrr dataclassABCr#r^Actionr`rrrrrrrrrrsu"#  88@:CeO$ II #xc C( () SM))"" $  [M:- . d#F)cggF)$F)R5:47hoo47n5/x5/p,x,D d#?c?c$?cD"*$"*J# # L d#! W! $! r