SSrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK J r SSK r Sr "SS \ 5r"S S \ R"\\55r"S S \5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"S S!\5r"S"S#\5r"S$S%\5r"S&S'\5rg)(zContains base classes used to parse and convert arguments. Do NOT import this module directly. Import the flags package and use the aliases defined at the package level instead. )absolute_import)division)print_functionN)_helperscn[U[R5=(a [U[5(+$)z7Returns True if instance is an integer, and not a bool.) isinstancesix integer_typesbool)instances 6platform/bq/third_party/absl/flags/_argument_parser.py_is_integer_typer"s) Xs00 1 )4( (*c"\rSrSrSr0rSrSrg)_ArgumentParserCache(z?Metaclass used to cache and share argument parsers among flags.c6U(a[R"U/UQ70UD6$URnU4[U5-nX4$![a* UR U[R"U/UQ765s$[ a [R"U/UQ76s$f=f)a#Returns an instance of the argument parser cls. This method overrides behavior of the __new__ methods in all subclasses of ArgumentParser (inclusive). If an instance for cls with the same set of arguments exists, this instance is returned, otherwise a new instance is created. If any keyword arguments are defined, or the values in args are not hashable, this method always returns a new instance of cls. Args: *args: Positional initializer arguments. **kwargs: Initializer keyword arguments. Returns: An instance of cls, shared or new. )type__call__ _instancestupleKeyError setdefault TypeError)clsargskwargs instanceskeys r r_ArgumentParserCache.__call__-s& ]]3 0 0 00..i FU4[ c)~ D##Cs)BT)BCC )}}S(4(()sA1B5 BBN)__name__ __module__ __qualname____firstlineno____doc__rr__static_attributes__r!rr rr(sG* )rrc.\rSrSrSrSrSrSrSrSr g) ArgumentParserbaBase class used to parse and convert arguments. The parse() method checks to make sure that the string argument is a legal value and convert it to a native type. If the value cannot be converted, it should throw a 'ValueError' exception with a human readable explanation of why the value is illegal. Subclasses should also define a syntactic_help string which may be presented to the user to describe the form of the legal values. Argument parser classes must be stateless, since instances are cached and shared between flags. Initializer arguments are allowed, but all member variables must be derived from initializer arguments only. c[U[R5(d#[SR [ U555eU$)aQParses the string argument and returns the native value. By default it returns its argument unmodified. Args: argument: string argument passed in the commandline. Raises: ValueError: Raised when it fails to parse the argument. TypeError: Raised when the argument has the wrong type. Returns: The parsed value in native type. z'flag value must be a string, found "{}")rr string_typesrformatrselfarguments r parseArgumentParser.parsets> h 0 0 1 1 ?FF x.  Orcg)z3Returns a string representing the type of the flag.stringr!r0s r flag_typeArgumentParser.flag_types rcA/$)zReturns a list of minidom.Element to add additional flag information. Args: doc: minidom.Document, the DOM document it should create nodes from. r!)r0docs r _custom_xml_dom_elements'ArgumentParser._custom_xml_dom_elementss Irr!N) r"r#r$r%r&syntactic_helpr2r7r;r'r!rr r)r)bs .(rr)c\rSrSrSrSrSrg)ArgumentSerializerzABase class for generating string representations of a flag value.c.[R"U5$)z)Returns a serialized string of the value.)rstr_or_unicoder0values r serializeArgumentSerializer.serializes  " "5 ))rr!N)r"r#r$r%r&rEr'r!rr r?r?s I*rr?c0\rSrSrSrSrSrSrSrSr g) NumericParserzYParser of numeric values. Parsed value may be bounded to a given upper and lower bound. cURSL=(a XR:=(d# URSL=(a XR:$)z7Returns whether the value is outside the bounds or not.N) lower_bound upper_bound)r0vals r is_outside_boundsNumericParser.is_outside_boundssF   T ) Dc4D4D.D F   T ) Dc4D4D.DGrcURU5nURU5(a[U<SUR<35eU$)See base class.z is not )convertrN ValueErrorr=)r0r1rMs r r2NumericParser.parses< ,,x C c"" d.A.AB CC Jrc/nURb1UR[R"USUR55 URb1UR[R"USUR55 U$)NrKrL)rKappendrcreate_xml_dom_elementrL)r0r:elementss r r;&NumericParser._custom_xml_dom_elementsspH #ooh55 }d..01 #ooh55 }d..01 Orc[e)aReturns the correct numeric value of argument. Subclass must implement this method, and raise TypeError if argument is not string or has the right numeric type. Args: argument: string argument passed in the commandline, or the numeric type. Raises: TypeError: Raised when argument is not a string or the right numeric type. ValueError: Raised when failed to convert argument to the numeric value. )NotImplementedErrorr/s r rRNumericParser.converts  rr!N) r"r#r$r%r&rNr2r;rRr'r!rr rHrHs G  rrHcj^\rSrSrSrSrSrSR\\45rS U4Sjjr Sr Sr S r U=r $) FloatParserz`Parser of floating point values. Parsed value may be bounded to a given upper and lower bound. anumber cB>[[U] 5 XlX lUR nUbUbU<SU<SU<S3nOYUS:XaSUR -nOCUS:XaSUR -nO-UbUR <SU<3nOUbUR <SU<3nX0lg) N in the range [, ]ra non-negative %sa non-positive %s <=  >= )superr^__init__rKrLr= number_namer0rKrLsh __class__s r rlFloatParser.__init__s +t%'""  B;#:*,k; Gb   !1!1 1b   !1!1 1b  )); 7b  )); 7brc[U5(d4[U[5(d[U[R5(a [U5$[ SR [U555e)z$Returns the float value of argument.z7Expect argument to be a string, int, or float, found {})rrfloatr r-rr.rr/s r rRFloatParser.convertsX""j5&A&A8S--.. 8_  C J J8n  rcg)rQrsr!r6s r r7FloatParser.flag_types rrKr=rLNNr"r#r$r%r&number_articlermjoinr=rlrRr7r' __classcell__rps@r r^r^s;.+88^[9:."rr^cj^\rSrSrSrSrSrSR\\45rS U4Sjjr Sr Sr S r U=r $) IntegerParserz[Parser of an integer value. Parsed value may be bounded to a given upper and lower bound. anintegerrbc>[[U] 5 XlX lUR nUbUbU<SU<SU<S3nOUS:XaSUR -nOoUS:XaSUR -nOYUS:XaS UR -nOCUS:XaS UR -nO-UbUR <S U<3nOUbUR <S U<3nX0lg) Nrdrerfz a positive %sz a negative %srrgrhrirj)rkrrlrKrLr=rmrns r rlIntegerParser.__init__s -')""  B;#:*,k; Gb   T-- -b   T-- -b   !1!1 1b   !1!1 1b  )); 7b  )); 7brc"[U5(aU$[U[R5(a<Sn[ U5S:a USS:XaUSS:XaSnO USS:XaS n[ X5$[ S R[U555e) z"Returns the int value of argument. r0roxz/Expect argument to be a string or int, found {}) rrr r-lenintrr.r)r0r1bases r rRIntegerParser.converts!! o Hc.. / / d X x{c1 A;# $ a[C $   GNN x. rcg)rQrr!r6s r r7IntegerParser.flag_type!s rrwrxryr}s@r rrs;.+88^[9:.* rrc$\rSrSrSrSrSrSrg) BooleanParseri&zParser of boolean values.c>[U[R5(a6UR5S;agUR5S;ag[ SU5e[U[R 5(a[ U5nX:XaU$[ SU5e[SU5e)rQ)truet1T)falsefrFz$Non-boolean argument to boolean flag)rr r-lowerrSr r r)r0r1 bool_values r r2BooleanParser.parse)s(C,,--  / / >> 2 2?JJ Hc// 0 0>j  ?JJ :H EErcg)rQr r!r6s r r7BooleanParser.flag_type=s rr!N)r"r#r$r%r&r2r7r'r!rr rr&s!F(rrc<^\rSrSrSrSU4SjjrSrSrSrU=r $) EnumParseriBz@Parser of a string enum value (a string value from a given set).c>U(d[SRU55e[[U]5 XlX lg)zInitializes EnumParser. Args: enum_values: [str], a non-empty list of string values in the enum. case_sensitive: bool, whether or not the enum is to be case-sensitive. Raises: ValueError: When enum_values is empty. z'enum_values cannot be empty, found "{}"N)rSr.rkrrl enum_valuescase_sensitive)r0rrrps r rlEnumParser.__init__Es>   3 : :; G II *d$&"(rcUR(a8XR;a'[SSRUR5-5eU$UR 5URVs/sHo"R 5PM sn;a'[SSRUR5-5eURVs/sH)nUR 5UR 5:XdM'UPM+ snS$s snfs snf)zDetermines validity of argument and returns the correct element of enum. Args: argument: str, the supplied flag value. Returns: The first matching element from enum_values. Raises: ValueError: Raised when argument didn't match anything in enum. zvalue should be one of <%s>|r)rrrSr{upper)r0r1rDs r r2EnumParser.parseVs  )) )6$"2"2345 5  T=M=M!N=ME++-=M!N N6$"2"2345 5$(#3#36#3%;;=HNN$44#36679 9 "O6s'C1;&C6%C6cg)rQz string enumr!r6s r r7EnumParser.flag_typeps r)rrT r"r#r$r%r&rlr2r7r'r|r}s@r rrBsH)"94rrcL^\rSrSrSrSU4Sjjr\S5rSrSr Sr U=r $) EnumClassParseriuzParser of an Enum class member.c>SSKn[XR5(d[SR U55eUR (d[ SR U55eU(dt[R"SUR 55nUR5VVs1sHupVUS:dM UiM nnnU(a[ SR U55e[[U]35 Xl X lU(a[UR 5Ulg[SUR 55Ulgs snnf) aXInitializes EnumParser. Args: enum_class: class, the Enum class with all possible flag values. case_sensitive: bool, whether or not the enum is to be case-sensitive. If False, all member names must be unique when case is ignored. Raises: TypeError: When enum_class is not a subclass of Enum. ValueError: When enum_class is empty. rNz{} is not a subclass of Enum.z.enum_class cannot be empty, but "{}" is empty.c3@# UHoR5v M g7fNr.0names r +EnumClassParser.__init__..s$;#94**,,#9rz7Duplicate enum values for {} using case_sensitive=Falsec3@# UHoR5v M g7frrrs r rrs!;#94**,,#9r)enum issubclassEnumrr. __members__rS collectionsCounteritemsrkrrl enum_class_case_sensitiver _member_names) r0rrrmembersmembercountduplicate_keysrps r rlEnumClassParser.__init__xs j)) , , 5<# UH-upUR5TR5:XdM)Uv M/ g7frr)rrrDrs r r(EnumClassParser.parse..s02+NKDZZ\SYY[0%+Ns(8 8) rrr r-rSr.rrrr2nextrr)r0r1rs @r r2EnumClassParser.parses(OO,, o #"2"2 3 3  @ G G ) **  4+?+? AAFx  __S !!24??+F+F+L+L+N222rcg)rQz enum classr!r6s r r7EnumClassParser.flag_types r)rrrr) r"r#r$r%r&rlpropertyrr2r7r'r|r}s@r rrus/'';R  28rrc \rSrSrSrSrSrg)ListSerializericXlgrlist_sepr0rs r rlListSerializer.__init__MrcURRUVs/sHn[R"U5PM sn5$s snfrQ)rr{rrB)r0rDrs r rEListSerializer.serializes4 ==  5I5ax66q95I JJIs ArNr"r#r$r%rlrEr'r!rr rrs Krrc2^\rSrSrSrU4SjrSrSrU=r$)EnumClassListSerializerizA serializer for MultiEnumClass flags. This serializer simply joins the output of `EnumClassSerializer` using a provided separator. c L>[[U] U5 [S0UD6Ulg)zInitializes EnumClassListSerializer. Args: list_sep: String to be used as a separator when serializing **kwargs: Keyword arguments to the `EnumClassSerializer` used to serialize individual values. Nr!)rkrrlEnumClassSerializer_element_serializer)r0rrrps r rl EnumClassListSerializer.__init__s% !41(;2# UH nTRRU5v M" g7fr)rrE)rrr0s r r4EnumClassListSerializer.serialize..s) @9>A$ " " , ,Q / /s(+)rlistrr{rrErCs` r rE!EnumClassListSerializer.serializesQ% ]]   @9> @@@ % % / / 66r)r) r"r#r$r%r&rlrEr'r|r}s@r rrs =77rrc \rSrSrSrSrSrg)CsvListSerializericXlgrrrs r rlCsvListSerializer.__init__rrc[R(a[R"5n[R "X R S9nURUVs/sHn[U5RS5PM sn5 UR5RS5R5nO|[R"5n[R "X R S9nURUVs/sHn[U5PM sn5 UR5R5n[R "U5$s snfs snf)z-Serializes a list as a CSV string or unicode.) delimiterzutf-8)r PY2ioBytesIOcsvwriterrwriterowunicodeencodegetvaluedecodestripStringIOstrrrB)r0rDoutputrrserialized_values r rECsvListSerializer.serializes wwzz|fzz&MM:f oo5A5awqz((15AB*11':@@B{{}fzz&MM:f oou-u!s1vu-.*002  " "#3 44B .s $E3ErNrr!rr rrs 5rrc$\rSrSrSrSrSrSrg)rizHClass for generating string representations of an enum class flag value.cXlg)zuInitializes EnumClassSerializer. Args: lowercase: If True, enum member names are lowercased during serialization. N _lowercase)r0 lowercases r rlEnumClassSerializer.__init__s  Orc[R"UR5nUR(aUR 5$U$)z4Returns a serialized string of the Enum class value.)rrBrrr)r0rD as_strings r rEEnumClassSerializer.serializes.'' 3I $9?? >Y>rrN)r"r#r$r%r&rlrEr'r!rr rrsP ?rrc<^\rSrSrSrSU4SjjrSrSrSrU=r $)BaseListParserizBase class for a parser of lists of strings. To extend, inherit from this class; from the subclass __init__, call BaseListParser.__init__(self, token, name) where token is a character used to tokenize, and name is a description of the separator. c|>U(de[[U] 5 XlX lSUR-Ulg)Nza %s separated list)rkrrl_token_namer=)r0tokenrrps r rlBaseListParser.__init__!s2 K4 .$(*KJ/$**77rrc>^\rSrSrSrU4SjrSrU4SjrSrU=r $) ListParseri6z-Parser for a comma-separated list of strings.c.>[[U] SS5 g)N,comma)rkrrl)r0rps r rlListParser.__init__9s *d$S'2rc P[U[5(aU$U(d/$[[R"U/SS95SVs/sHo"R 5PM sn$s snf![R a*n[ SU<SUR5<SU<35eSnAff=f)z3Parses argument as comma-separated list of strings.T)strictrzUnable to parse the value z as a z: N)rrrreaderrErrorrSr7)r0r1res r r2ListParser.parse<s(D!! o  i <#' H:d(K#LQ#OP#Oa #OPPP YY< $dnn&6;< < [[U] U5nUR[R "US[ S555 U$)Nlist_separatorr)rkrr;rVrrWrepr)r0r:rXrps r r;#ListParser._custom_xml_dom_elementsNs>Z?DH OOH33 tCy*+ Orr! r"r#r$r%r&rlr2r;r'r|r}s@r rr6s53<$rrcB^\rSrSrSrSU4SjjrSrU4SjrSrU=r $)WhitespaceSeparatedListParseriUz2Parser for a whitespace-separated list of strings.cd>XlUR(aSOSn[[U]SU5 g)zInitializer. Args: comma_compat: bool, whether to support comma as an additional separator. If False then only whitespace is supported. This is intended only for backwards compatibility with flags that used to be comma-separated. zwhitespace or comma whitespaceN) _comma_compatrkr,rl)r0 comma_compatrrps r rl&WhitespaceSeparatedListParser.__init__Xs-&$($6$6 LD '7dCrc[U[5(aU$U(d/$UR(aURSS5nUR 5$)zParses argument as whitespace-separated list of strings. It also parses argument as comma-separated list of strings if requested. Args: argument: string argument passed in the commandline. Returns: [str], the parsed flag value. rrb)rrr/replacerr/s r r2#WhitespaceSeparatedListParser.parsedsF(D!! o  i  ##C- ^^ rc 6>[[U] U5n[[R 5nUR (aURS5 UR5 UH3nUR[R"US[U555 M5 U$)Nrr') rkr,r;rr5r.r/rVsortrrWr()r0r:rX separatorssep_charrps r r;6WhitespaceSeparatedListParser._custom_xml_dom_elementsxs2D//23 f''(J OOooh55 h12 Or)r/)Fr*r}s@r r,r,Us: D(  rr,) r& __future__rrrrrrr5 absl.flagsrr rrrwith_metaclassobjectr)r?rHr^rrrrrrrrrrr,r!rr r>s  '%  * %)4%)t1S''(-N-r