a Sic6P@s>dZddlZddlZddlZddlZddlmZddZGdddeZ Gdd d e d Z Gd d d e Z Gd dde Z Gddde ZGddde ZGddde ZGddde ZGddde ZGddde ZGdddeZGddde ZGdd d e ZGd!d"d"e ZGd#d$d$eZGd%d&d&eZdS)'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. N)_helperscCst|tot|t S)z7Returns True if instance is an integer, and not a bool.) isinstanceintbool)instancerW/var/www/html/django/DPS/env/lib/python3.9/site-packages/absl/flags/_argument_parser.py_is_integer_types  r c@seZdZdZiZddZdS)_ArgumentParserCachez?Metaclass used to cache and share argument parsers among flags.c Os|rtj|g|Ri|S|j}|ft|}z ||WStyf||tj|g|RYStytj|g|RYS0dS)aWReturns 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. N)type__call__ _instancestupleKeyError setdefault TypeError)clsargskwargs instanceskeyrrrr (s   z_ArgumentParserCache.__call__N)__name__ __module__ __qualname____doc__r r rrrrr #sr c@s,eZdZdZdZddZddZddZd S) ArgumentParseraBase class used to parse and convert arguments. The :meth:`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. cCs t|tstdt||S)auParses 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 "{}")rstrrformatr selfargumentrrrparseos  zArgumentParser.parsecCsdS)z3Returns a string representing the type of the flag.stringrr rrr flag_typeszArgumentParser.flag_typecCs~gS)zReturns a list of minidom.Element to add additional flag information. Args: doc: minidom.Document, the DOM document it should create nodes from. r)r docrrr_custom_xml_dom_elementssz'ArgumentParser._custom_xml_dom_elementsN)rrrrsyntactic_helpr"r%r'rrrrr]s r) metaclassc@seZdZdZddZdS)ArgumentSerializerzABase class for generating string representations of a flag value.cCst|S)z)Returns a serialized string of the value.rr valuerrr serializeszArgumentSerializer.serializeN)rrrrr.rrrrr*sr*c@s0eZdZdZddZddZddZdd Zd S) NumericParserz]Parser of numeric values. Parsed value may be bounded to a given upper and lower bound. cCs(|jdur||jkp&|jduo&||jkS)z7Returns whether the value is outside the bounds or not.N) lower_bound upper_bound)r valrrris_outside_boundsszNumericParser.is_outside_boundscCs*||}||r&td||jf|S)See base class.z %s is not %s)convertr3 ValueErrorr()r r!r2rrrr"s  zNumericParser.parsecCsHg}|jdur$|t|d|j|jdurD|t|d|j|S)Nr0r1)r0appendrcreate_xml_dom_elementr1r r&elementsrrrr's  z&NumericParser._custom_xml_dom_elementscCstdS)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. N)NotImplementedErrorrrrrr5s zNumericParser.convertN)rrrrr3r"r'r5rrrrr/s  r/csHeZdZdZdZdZdeefZd fdd Zdd Z d d Z Z S) FloatParserzdParser of floating point values. Parsed value may be bounded to a given upper and lower bound. anumber Ncstt|||_||_|j}|dur@|dur@d|||f}nV|dkrTd|j}nB|dkrhd|j}n.|durd|j|f}n|durd|j|f}||_dS)N%s in the range [%s, %s]ra non-negative %sa non-positive %s%s <= %s%s >= %s)superr<__init__r0r1r( number_namer r0r1sh __class__rrrFs  zFloatParser.__init__cCs:t|st|tst|tr$t|Stdt|dS)z$Returns the float value of argument.z7Expect argument to be a string, int, or float, found {}N)r rfloatrrrr rrrrr5szFloatParser.convertcCsdS)r4rLrr$rrrr%szFloatParser.flag_type)NN rrrrZnumber_articlerGjoinr(rFr5r% __classcell__rrrJrr<s r<csHeZdZdZdZdZdeefZd fdd Zdd Z d d Z Z S) IntegerParserz_Parser of an integer value. Parsed value may be bounded to a given upper and lower bound. anintegerr?Ncstt|||_||_|j}|dur@|dur@d|||f}n~|dkrTd|j}nj|dkrhd|j}nV|dkr|d|j}nB|dkrd|j}n.|durd |j|f}n|durd |j|f}||_dS) Nr@z a positive %sz a negative %srrArBrCrD)rErPrFr0r1r(rGrHrJrrrFs&    zIntegerParser.__init__cCstt|r |St|tr^d}t|dkrT|ddkrT|ddkrDd}n|ddkrTd }t||Std t|d S) z"Returns the int value of argument. r0rSoxz/Expect argument to be a string or int, found {}N)r rrlenrrrr )r r!baserrrr5 s    zIntegerParser.convertcCsdS)r4rrr$rrrr%szIntegerParser.flag_type)NNrMrrrJrrPsrPc@s eZdZdZddZddZdS) BooleanParserzParser of boolean values.cCslt|tr6|dvrdS|dvr*dStd|n(t|tr^t|}||krT|Std|td|dS)r4)truet1T)falsefrWFz$Non-boolean argument to boolean flagN)rrlowerr6rrr)r r!Z bool_valuerrrr"$s      zBooleanParser.parsecCsdS)r4rrr$rrrr%8szBooleanParser.flag_typeN)rrrrr"r%rrrrr^!sr^cs2eZdZdZd fdd ZddZddZZS) EnumParserz@Parser of a string enum value (a string value from a given set).Tcs0|std|tt|||_||_dS)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)r6rrErerF enum_valuescase_sensitive)r rfrgrJrrrF@s zEnumParser.__init__csv|jr,|jvr&tdd|jqrSnFdd|jDvrZtdd|jnfdd|jDdSdS)aDetermines 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>|cSsg|] }|qSrupper.0r-rrr dz$EnumParser.parse..cs g|]}|kr|qSrrirkr!rrrmhsrN)rgrfr6rNrjrrrorr"Qs    zEnumParser.parsecCsdS)r4z string enumrr$rrrr%kszEnumParser.flag_type)TrrrrrFr"r%rOrrrJrre=srecs>eZdZdZd fdd ZeddZddZd d ZZ S) EnumClassParserzParser of an Enum class member.Tcsddl}t||js"td||js6td||sttdd|jD}dd| D}|rttd |t t | ||_ ||_|rt|j|_ntd d|jD|_dS) 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.css|]}|VqdSNrdrlnamerrr sz+EnumClassParser.__init__..cSsh|]\}}|dkr|qS)rSr)rlmembercountrrr sz+EnumClassParser.__init__..z7Duplicate enum values for {} using case_sensitive=Falsecss|]}|VqdSrrrsrtrrrrvs)enum issubclassEnumrr __members__r6 collectionsCounteritemsrErqrF enum_class_case_sensitiver _member_names)r rrgrzmembersZduplicate_keysrJrrrFss8  zEnumClassParser.__init__cCs|jS)z.N) rrrr6rrerrr"nextr}rrrrrr"s   zEnumClassParser.parsecCsdS)r4z enum classrr$rrrr%szEnumClassParser.flag_type)T) rrrrrFpropertyrr"r%rOrrrJrrqps ) rqc@seZdZddZddZdS)ListSerializercCs ||_dSrrlist_sepr rrrrrFszListSerializer.__init__cCs|jdd|DS)r4cSsg|] }t|qSrr+rlrZrrrrmrnz,ListSerializer.serialize..)rrNr,rrrr.szListSerializer.serializeNrrrrFr.rrrrrsrcs(eZdZdZfddZddZZS)EnumClassListSerializerzA serializer for :class:`MultiEnumClass` flags. This serializer simply joins the output of `EnumClassSerializer` using a provided separator. c s$tt||tfi||_dS)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. N)rErrFEnumClassSerializer_element_serializer)r rrrJrrrFsz EnumClassListSerializer.__init__cs4t|tr$jfdd|DSj|SdS)r4c3s|]}j|VqdSrr)rr.rr$rrrvsz4EnumClassListSerializer.serialize..N)rlistrrNrr.r,rr$rr.s  z!EnumClassListSerializer.serialize)rrrrrFr.rOrrrJrrs rc@seZdZddZddZdS)CsvListSerializercCs ||_dSrrrrrrrrFszCsvListSerializer.__init__cCs@t}tj||jd}|dd|D|}t|S)z-Serializes a list as a CSV string or unicode.) delimitercSsg|] }t|qSrr+rrrrrmrnz/CsvListSerializer.serialize..) ioStringIOcsvwriterrwriterowgetvaluestripr)r r-outputrZserialized_valuerrrr.s  zCsvListSerializer.serializeNrrrrrrsrc@s eZdZdZddZddZdS)rzHClass for generating string representations of an enum class flag value.cCs ||_dS)zInitializes EnumClassSerializer. Args: lowercase: If True, enum member names are lowercased during serialization. N) _lowercase)r Z lowercaserrrrFszEnumClassSerializer.__init__cCst|j}|jr|S|S)z4Returns a serialized string of the Enum class value.)rrurrd)r r- as_stringrrrr.s zEnumClassSerializer.serializeN)rrrrrFr.rrrrrsrcs2eZdZdZd fdd ZddZddZZS) BaseListParseraBase class for a parser of lists of strings. To extend, inherit from this class; from the subclass ``__init__``, call:: super().__init__(token, name) where token is a character used to tokenize, and name is a description of the separator. Ncs2|sJtt|||_||_d|j|_dS)Nza %s separated list)rErrF_token_namer()r tokenrurJrrrFs zBaseListParser.__init__cCs0t|tr|S|sgSdd||jDSdS)r4cSsg|] }|qSrrrlsrrrrm"rnz(BaseListParser.parse..N)rrsplitrrrrrr"s  zBaseListParser.parsecCs d|jS)r4z%s separated list of strings)rr$rrrr%$szBaseListParser.flag_type)NNrprrrJrr s  rcs4eZdZdZfddZddZfddZZS) ListParserz-Parser for a comma-separated list of strings.cstt|dddS)N,comma)rErrFr$rJrrrF,szListParser.__init__c Cs|t|tr|S|sgSz$ddttj|gdddDWStjyv}z"td|||fWYd}~n d}~00dS)z3Parses argument as comma-separated list of strings.cSsg|] }|qSrrrrrrrm7rnz$ListParser.parse..T)strictrz(Unable to parse the value %r as a %s: %sN)rrrreaderErrorr6r%)r r!errrr"/s $ zListParser.parsecs,tt||}|t|dtd|S)Nlist_separatorr)rErr'r7rr8reprr9rJrrr'As  z#ListParser._custom_xml_dom_elementsrrrrrFr"r'rOrrrJrr)s rcs6eZdZdZd fdd ZddZfddZZS) WhitespaceSeparatedListParserz2Parser for a whitespace-separated list of strings.Fcs*||_|jrdnd}tt|d|dS)a Initializer. 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_compatrErrF)r Z comma_compatrurJrrrFKsz&WhitespaceSeparatedListParser.__init__cCs4t|tr|S|sgS|jr(|dd}|SdS)aParses 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. rr?N)rrrreplacerrrrrr"Ws  z#WhitespaceSeparatedListParser.parsec sXtt||}ttj}|jr*|d||D]}|t |dt |q6|S)Nrr) rErr'rr#rrr7sortrr8r)r r&r: separatorsZsep_charrJrrr'ks    z6WhitespaceSeparatedListParser._custom_xml_dom_elements)FrrrrJrrHs r)rr~rrr# absl.flagsrr r r robjectr*r/r<rPr^rerqrrrrrrrrrrrs, :4,)33R