"ShoNdZddlmZddlZddlZddlZddlmZmZm Z m Z m Z m Z m Z mZmZddlmZddlmZddlmZddlmZed Zed ej ZejGd d e eZGddeeZGddeeZGddeeZGdde eee eZ Gdde eZ!dS)zContains Flag class - information about single command-line flag. Do NOT import this module directly. Import the flags package and use the aliases defined at the package level instead. )abcN) AnyDictGenericIterableListOptionalTypeTypeVarUnion)minidom)_argument_parser) _exceptions)_helpers_T_ET)boundc`eZdZUdZeeed<eeed<eeeefed<e j eed< d1de j ed ee j ed edeeeefd eed eed e de de de de de ddfdZ edeefdZejdeefdZdZdZdZdZdZdZdeeefddfd Zdeedeefd!Zd"eeefddfd#Zd"eeefdeefd$Zd2d%Zdefd&Zdeedefd'Z deeeefddfd(Z!deeefdeefd)Z"defd*Z# d3d+e$j%d,ed-e de$j&fd.Z'deedefd/Z(d+e$j%de)e$j&fd0Z*dS)4Flaga Information about a command-line flag. Attributes: name: the name for this flag default: the default value for this flag default_unparsed: the unparsed default value for this flag. default_as_str: default value as repr'd string, e.g., "'true'" (or None) value: the most recent parsed value of this flag set by :meth:`parse` help: a help string or None if no help is available short_name: the single letter alias for this flag (or None) boolean: if 'true', this flag does not accept arguments present: true if this flag was parsed from command line flags parser: an :class:`~absl.flags.ArgumentParser` object serializer: an ArgumentSerializer object allow_override: the flag may be redefined without raising an error, and newly defined flag overrides the old one. allow_override_cpp: use the flag from C++ if available the flag definition is replaced by the C++ flag after init allow_hide_cpp: use the Python flag despite having a C++ flag with the same name (ignore the C++ flag) using_default_value: the flag value has not been set by user allow_overwrite: the flag may be parsed more than once without raising an error, the last set value will be used allow_using_method_names: whether this flag can be defined even if it has a name that conflicts with a FlagValues method. validators: list of the flag validators. The only public method of a ``Flag`` object is :meth:`parse`, but it is typically only called by a :class:`~absl.flags.FlagValues` object. The :meth:`parse` method is a thin wrapper around the :meth:`ArgumentParser.parse()` method. The parsed value is saved in ``.value``, and the ``.present`` attribute is updated. If this flag was already present, an Error is raised. :meth:`parse` is also called during ``__init__`` to parse the default value and initialize the ``.value`` attribute. This enables other python modules to safely use flags even if the ``__main__`` module neglects to parse the command line arguments. The ``.present`` attribute is cleared after ``__init__`` parsing. If the default value is set to ``None``, then the ``__init__`` parsing step is skipped and the ``.value`` attribute is initialized to None. Note: The default value is also presented to the user in the help string, so it is important that it be a legal value for this flag. defaultdefault_as_strdefault_unparsedparserNFT serializername help_string short_namebooleanallow_overrideallow_override_cppallow_hide_cppallow_overwriteallow_using_method_namesreturnc N||_|sd}||_||_||_d|_||_||_||_| |_| |_ | |_ | |_ d|_ d|_ g|_|j r|jrtjd||dS)N(no help available)rTzsCan't have both allow_hide_cpp (means use Python flag) and allow_override_cpp (means use C++ flag after InitGoogle))rhelprrpresentrrrr r!r"r#using_default_value_value validatorsrError _set_default) selfrrrrrrrrr r!r"r#s V/var/www/html/movieo_spanner_bot/venv/lib/python3.11/site-packages/absl/flags/_flag.py__init__z Flag.__init__\sDI *)kDI DODLDLDK DO(D0D(D*D$>r1c ||uSr3r.others r/__eq__z Flag.__eq__s 5=r1czt|tr t|t|kStSr3) isinstancerr;NotImplementedr?s r/__lt__z Flag.__lt__s1%" XX5 !! r1c td)NzRA Flag instance would always be True. Did you mean to test the `.value` attribute? TypeErrorr5s r/__bool__z Flag.__bool__s C D DDr1c td)Nzcan't pickle Flag objectsrGr5s r/ __getstate__zFlag.__getstate__s / 0 00r1cJtdt|jz)Nz>%s does not support shallow copies. Use copy.deepcopy instead.)rHtype__name__r5s r/__copy__z Flag.__copy__s. 137::3FG H HHr1memozFlag[_T]ctt|}tj|j||_|Sr3)object__new__rMcopydeepcopy__dict__)r.rPresults r/ __deepcopy__zFlag.__deepcopy__s3 ^^DJJ ' 'FmDM488FO Mr1c|dS|jr't|j|S|jr |rtdStdStt |S)z$Returns parsed flag value as string.Ntruefalse)rrepr serializerstrr8s r/_get_parsed_value_as_stringz Flag._get_parsed_value_as_stringsr } T 4 $/++E22 3 33 | F||G}} E  r1argumentc|jr.|js'tjd|jd|d|j|||_|xjdz c_dS)z}Parses string and sets flag value. Args: argument: str or the correct flag value type, argument to be parsed. flag --=z: already defined as N)r(r"rIllegalFlagValueErrorrr6_parse)r.r`s r/parsez Flag.parsess  |0D00  - -iii4:: / 0 00X&&DJLLALLLLr1c  |j|S#tttf$r'}t jd|jd|d|d}~wwxYw)zInternal parse function. It returns the parsed value, and does not modify class states. Args: argument: str or the correct flag value type, argument to be parsed. Returns: The parsed value. rbrcz: N)rrgrH ValueError OverflowErrorrrer)r.r`es r/rfz Flag._parsesq9 [  x ( (( z= 1999  - - $ 888QQ 7 9 999sA"AAc:|j|_d|_d|_dS)NTr)rr6r)r(r5s r/unparsez Flag.unparsesDJ#DDLLLr1c6||jS)zSerializes the flag.) _serializer6r5s r/r]zFlag.serializes ??4: & &&r1c|dS|jr|r d|jzSd|jzS|jstjd|jzd|jd|j|S)zInternal serialize function.Nz--%sz--no%s"Serializer not present for flag %sz--rc)rrrrr,r]r8s r/rozFlag._serializes } R | G $ !!$)## _> 049 <>> >>)))T_%>%>u%E%E%E FFr1c||_|d|_n|||_||j|_|jr|j|_dSdS)z@Changes the default value (and current value too) for this Flag.N)rr_parse_from_defaultr_rr)r6r8s r/r-zFlag._set_defaultsg!D }dll--e44dl::4<HHD  r8s r/rzFlag._serialize_value_for_xml<s Lr1c6|j|S)aReturns extra info about this flag in XML. "Extra" means "not already included by _create_xml_dom_element above." Args: doc: minidom.Document, the DOM document it should create nodes from. Returns: A list of minidom.Element. )r_custom_xml_dom_elements)r.rys r/rzFlag._extra_xml_dom_elements@s ; / / 4 44r1)NFFFFTF)r$NF)+rN __module__ __qualname____doc__r r__annotations__r^r rArgumentParserArgumentSerializerboolr0propertyr6setterr<rArErIrKrOrintrrXr_rgrfrmr]ror-rtrxr DocumentElementrrrrr>r1r/rr$s --` B<3-(2,+,,,,  )" ----#'"!&""',((-b1(+>rBC(  ( Xb\3&' ( C= (3-((((((!%( ((((T Xb\ 8 <"< DDD111HHHtCH~* x|      E#r'N t    9U37^9 9999$ ''''' Ghrl Gs G G G G  hrlC&7 8  T     uS"W~(2,#####EJ44!4034=A44444lHRLS5!5 GO555555r1rc peZdZdZ d dedeeeefdeedeeddf fd ZxZ S) BooleanFlagaBasic boolean flag. Boolean flags do not take any arguments, and their value is either ``True`` (1) or ``False`` (0). The false value is specified on the command line by prepending the word ``'no'`` to either the long or the short flag name. For example, if a Boolean flag was created whose long name was ``'update'`` and whose short name was ``'x'``, then this flag could be explicitly unset through either ``--noupdate`` or ``--nox``. Nrrr'rr$c ntj}tj|d||||dfi|dSNT)r BooleanParsersuperr0)r.rrr'rargsp __class__s r/r0zBooleanFlag.__init___sD &((AEGGQdGT:tLLtLLLLLr1r3) rNrrrr^r r rr0 __classcell__rs@r/rrRs  "#' M M  MXd^S() M SM M 3- M  M M M M M M M M M Mr1rc eZdZUdZejed< ddedeedeede ed eed e f fd Z d e j d ee jfdZxZS)EnumFlagzFBasic enum flag; its value can be any string from list of enum_values.rNTrrr' enum_valuesrcase_sensitivec tj||}tj} tj|| ||||fi|||_dd|jd|j|_dS)N<|>: ) r EnumParserrrr0rjoinrr') r.rrr'rrrrrgrs r/r0zEnumFlag.__init__ps #K@@A+--AEGGQ4$ CCdCCCDKK!hhq}5555tyyADIIIr1ryr$czg}|jjD]+}|tj|d|,|SN enum_value)rrappendrrr.ryelementsrs r/rz EnumFlag._extra_xml_dom_elementssSHk-** ooh5 |Z))**** Or1r)rNrrrrrrr^r rrr0r rrrrrrs@r/rrksNN  %%%%#'!BB B}B SM B C= B 3- BBBBBBB"! GOr1rc eZdZUdZejed< ddedee e efde ede e d e ed e f fd Z d ejd eejfdZxZS) EnumClassFlagz5Basic enum flag; its value is an enum class's member.rNFrrr' enum_classrrc tj||}tj| } tj|| ||||fi|||_dd|jd|j|_dS)Nr) lowercaserrr) rEnumClassParserEnumClassSerializerrr0rr member_namesr') r.rrr'rrrrrrrs r/r0zEnumClassFlag.__init__s (>   A ,>7IJJJAEGGQ4$ CCdCCCDKK!hhq~6666 BDIIIr1ryr$cg}|jjjD]+}|t j|d|,|Srrr __members__keysrrrrs r/rz%EnumClassFlag._extra_xml_dom_elementsbHk,8==??** ooh5 |Z))**** Or1)NF)rNrrrrrrr^r r rr rr0r rrrrrrs@r/rrs==  ****#'"CC CXc]C'(C SM C s) C 3- CCCCCCC&! GOr1rceZdZdZfdZdeeeeeffdZ deeeeefde effd Z de e edeffd Z d Zd ejde ejfd ZxZS) MultiFlagaeA flag that can appear multiple time on the command-line. The value of such a flag is a list that contains the individual values from all the appearances of that flag on the command-line. See the __doc__ for Flag for most behavior of this class. Only differences in behavior are described here: * The default value may be either a single value or an iterable of values. A single value is transformed into a single-item list of that value. * The value of the flag is always a list, even if the option was only supplied once, and even if the default value is a single value cZtj|i||xjdz c_dS)N4; repeat this option to specify a list of values)rr0r')r.rkwargsrs r/r0zMultiFlag.__init__s4EGGd%f%%%IIHHIIIIr1 argumentsc||}|jr$|jJ|j|n||_|xjt |z c_dS)aParses one or more arguments with the installed parser. Args: arguments: a single argument or a list of arguments (typically a list of default values); a single argument is converted internally into a list containing one item. N)rfr(r6extendlen)r.r new_valuess r/rgzMultiFlag.parsesgY''J | Z # # # j ####djLLC OO#LLLLr1r$ct|tr|g}n-t|tjrt |}n|g}fd|DS)Nc`g|]*}tt|+Sr>)rrrf).0itemrr.s r/ z$MultiFlag._parse..s1 K K KDE)T " " ) )$ / / K K Kr1)rCr^rrlist)r.rarguments_listrs` r/rfzMultiFlag._parsesh)S!! #!{nn Is| , ,#Inn "{n K K K K KN K K KKr1r6cjstjdjz|dSfd|D}d|S)See base class.rrNrqc`g|]*}tt|+Sr>)rrro)r value_itemrr.s r/rz(MultiFlag._serialize..sA  i))*55r1 )rrr,rr)r.r6serialized_itemsrs` r/rozMultiFlag._serializesz ?<   . : < << } R 99% & &&r1c:d|jzS)rzmulti rwr5s r/rxzMultiFlag.flag_types dk++-- --r1rycg}t|jdr8|jjD]+}|t j|d|,|S)Nrr)hasattrrrrrrrs r/rz!MultiFlag._extra_xml_dom_elementssgHt{M**, /,,*7 z++ , , , , Or1)rNrrrr0r r^rrrgrrfr rorxr rrrrrs@r/rrs, IIIII$U3HRL#89$$$$ LeCXb\$9:LtBxLLLLLL" 'htBx0 'S ' ' ' ' ' '...! GOr1rc eZdZUdZejeed< ddede de eee eefdede ed e f fd Z d ejd eejfd ZdZxZS)MultiEnumClassFlagzA multi_enum_class flag. See the __doc__ for MultiFlag for most behaviors of this class. In addition, this class knows how to handle enum.Enum instances as values for this flag type. rFrrNrrrc tj||}tjd| }tj|||||fi|||_||_dd|jd|pdd|_ dS) Nr,)list_seprrrrr&r) rrEnumClassListSerializerrr0rrrrr') r.rrrrrrrrrs r/r0zMultiEnumClassFlag.__init__ s (> 3 3 3A 0N 2 4 4 4AEGGQ4+>>>>>DKDOO !. ! ! ! !;#G2G#G#G I IIIr1ryr$cg}|jjjD]+}|t j|d|,|Srrrs r/rz*MultiEnumClassFlag._extra_xml_dom_elements#rr1c|>|jstjd|jz|j|}nd}|S)rNrrrq)rrr,rr])r.r6rs r/rz+MultiEnumClassFlag._serialize_value_for_xml,sX  _  049 <   22599 r1r)rNrrrrrrrr^r rr rr0r rrrrrrrs@r/rrs  *3 ////# JJ JT8C=#x}cABJ J s) J  JJJJJJ0! GO       r1r)"r collectionsrrTenum functoolstypingrrrrrr r r r xml.domr absl.flagsrrrrEnumrtotal_orderingrrrr^rrrrr>r1r/rsB  UUUUUUUUUUUUUUUUUUUUUU''''''"""""" WT]] ge49%%% j5j5j5j5j572;j5j5j5Z MMMMM$t*MMM2tCy@DIDQQQQQ T$r(^QQQh55555355555r1