RpfMdZddlmZddlZddlZddlZddlmZmZm Z m Z m Z m Z m Z mZmZmZddlmZddlmZddlmZddlmZed Zed ej ZejGd d e eZGddeeZGddee ZGddeeZGdde 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) AnyDictGenericIterableListOptionalTextTypeTypeVarUnion)minidom)_argument_parser) _exceptions)_helpers_T_ET)boundcLeZdZUdZeeed<eeed<eeeefed< d1de j ed ee j ed edeeeefd eed eed e de de de de de ddfdZ edeefdZejdeefdZdZdZdZdZdZdZdeeefddfd Zdeedeefd!Zd"eeeefddfd#Zd"eeefdeefd$Zd2d%Zdefd&Zdeedefd'Z deeeefddfd(Z!deeefdeefd)Z"defd*Z# d3d+e$j%d,e&d-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_unparsedNFTparser 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))rhelprrpresentrrr r!r"r#r$using_default_value_value validatorsrError _set_default) selfrrrrrrrr r!r"r#r$s P/var/www/html/nettyfy-visnx/env/lib/python3.11/site-packages/absl/flags/_flag.py__init__z Flag.__init__ZsDI *)kDI DODLDLDK DO(D0D(D*D$>r2c ||uSr4r/others r0__eq__z Flag.__eq__s 5=r2czt|tr t|t|kStSr4) isinstancerr<NotImplementedr@s r0__lt__z Flag.__lt__s1%" XX5 !! r2c td)NzRA Flag instance would always be True. Did you mean to test the `.value` attribute? TypeErrorr6s r0__bool__z Flag.__bool__s C D DDr2c td)Nzcan't pickle Flag objectsrHr6s r0 __getstate__zFlag.__getstate__s / 0 00r2cJtdt|jz)Nz>%s does not support shallow copies. Use copy.deepcopy instead.)rItype__name__r6s r0__copy__z Flag.__copy__s. 137::3FG H HHr2memozFlag[_T]ctt|}tj|j||_|Sr4)object__new__rNcopydeepcopy__dict__)r/rQresults r0 __deepcopy__zFlag.__deepcopy__s3 ^^DJJ ' 'FmDM488FO Mr2c|dS|jr't|j|S|jr |rtdStdStt |S)z$Returns parsed flag value as string.Ntruefalse)rrepr serializerstrr9s r0_get_parsed_value_as_stringz Flag._get_parsed_value_as_stringsr } T 4 $/++E22 3 33 | F||G}} E  r2argumentc|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#rIllegalFlagValueErrorrr7_parse)r/ras r0parsez Flag.parsess  |0D00  - -iii4:: / 0 00X&&DJLLALLLLr2c  |j|S#ttf$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. rcrdz: N)rrhrI ValueErrorrrfr)r/raes r0rgz Flag._parseso9 [  x ( (( z "999  - - $ 888QQ 7 9 999sA"AAc:|j|_d|_d|_dS)NTr)rr7r*r)r6s r0unparsez Flag.unparsesDJ#DDLLLr2c6||jS)zSerializes the flag.) _serializer7r6s r0r^zFlag.serializes ??4: & &&r2c|dS|jr|r d|jzSd|jzS|jstjd|jzd|jd|j|S)zInternal serialize function.Nz--%sz--no%s"Serializer not present for flag %sz--rd)rrrrr-r^r9s r0rozFlag._serializes } R | G $ !!$)## _> 049 <>> >>)))T_%>%>u%E%E%E FFr2c||_|d|_n|||_||j|_|jr|j|_dSdS)z@Changes the default value (and current value too) for this Flag.N)rr_parse_from_defaultr`rr*r7r9s r0r.zFlag._set_defaultsg!D }dll--e44dl::4<HHD  rBC(  ( Xb\4'( ( D> (4.((((((!%( ((((T Xb\ 8 <"< DDD111HHHtCH~* x|      E$ "45 $    9U48_9"9999" ''''' Ghrl Gt G G G G  hrlD&8 9  d     uT2X8B<#####EJ44!4034=A44444lHRLS5!5 GO555555r2rc 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 |tj}tt|j|d||||dfi|dSNT)r BooleanParsersuperrr1)r/rrr(rargsp __class__s r0r1zBooleanFlag.__init__\sZ &((A%E+t% 4wj$:>r2r4) rOrrrr r r rr1 __classcell__rs@r0rrOs  "$(    Xd^T)*  TN  4.            r2rc eZdZdZ ddedeedeedeedeed ef fd Zd e j d e e j fd Z xZS)EnumFlagzFBasic enum flag; its value can be any string from list of enum_values.NTrrr( enum_valuesrcase_sensitivec tj||}tj} tt|j|| ||||fi|||_dd|jd|j |_ dS)N<|>: ) r EnumParserrrrr1rjoinrr() r/rrr(rrrrrgrs r0r1zEnumFlag.__init__ms #K@@A+--A"E(D" 1dGT:7715777DKK!hhq}5555tyyADIIIr2ryr%czg}|jjD]+}|tj|d|,|SN enum_value)rrappendrrr/ryelementsrs r0rz EnumFlag._extra_xml_dom_elementssSHk-** ooh5 |Z))**** Or2r)rOrrrr r rrr1rrrrrrrs@r0rrjsNN$(!BB B~B TN B D> B 4. BBBBBBB&! GOr2rc eZdZdZ ddedeeeefdeedeedeed e f fd Z d e j d e e jfd ZxZS) EnumClassFlagz5Basic enum flag; its value is an enum class's member.NFrrr( enum_classrrc tj||}tj| } tt|j|| ||||fi|||_dd|jd|j |_ dS)Nr) lowercaserrr) rEnumClassParserEnumClassSerializerrrr1rr member_namesr() r/rrr(rrrrrrrs r0r1zEnumClassFlag.__init__s (> 3 3 3A,>7IJJJA'E-' 1dGT:7715777DKK!hhq~6666 BDIIIr2ryr%cg}|jjjD]+}|t j|d|,|Srrr __members__keysrrrrs r0rz%EnumClassFlag._extra_xml_dom_elementsbHk,8==??** ooh5 |Z))**** Or2)NF)rOrrrr r r rr rr1rrrrrrrs@r0rrs==$("CC CXc]D()C TN C s) C 4. CCCCCCC(! GOr2rceZdZdZfdZdeeeeeffdZ deee eefde 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 chtt|j|i||xjdz c_dS)N4; repeat this option to specify a list of values)rrr1r()r/rkwargsrs r0r1zMultiFlag.__init__s:#E)T#T4V444IIHHIIIIr2 argumentsc||}|jr|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)rgr)r7extendlen)r/r new_valuess r0rhzMultiFlag.parsesYY''J | j ####djLLC OO#LLLLr2r%ct|tjr$t|tst |}t|ts|g}fd|DS)Nc`g|]*}tt|+Sr?)rrrg).0itemrr/s r0 z$MultiFlag._parse..s1 F F FDE)T " " ) )$ / / F F Fr2)rDrrr_list)r/rrs` r0rgzMultiFlag._parsesm9cl++" y# & &"y//i i & &+i F F F F FI F F FFr2r7cjstjdjz|dSfd|D}d|S)See base class.rrNrqc`g|]*}tt|+Sr?)rrro)r value_itemrr/s r0rz(MultiFlag._serialize..s>:Di))*55r2 )rrr-rr)r/r7serialized_itemsrs` r0rozMultiFlag._serializesz ?<   . : < << } RHM 99% & &&r2c:d|jzS)rzmulti rwr6s r0rxzMultiFlag.flag_types dk++-- --r2rycg}t|jdr8|jjD]+}|t j|d|,|S)Nrr)hasattrrrrrrrs r0rz!MultiFlag._extra_xml_dom_elementssgHt{M**, /,,*7 z++ , , , , Or2)rOrrrr1r r rrrhr rrgrorxrrrrrrs@r0rrs/ IIIII $U4Xb\#9: $ $ $ $ GeD(8B<*@$@A Gd2h G G G G G G 'htBx0 'T ' ' ' ' ' '...! GOr2rc eZdZdZ ddededeeeeeefdede ede f fd Z d e j d ee jfd Zd ZxZS)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. FrrNrrrc tj||}tjd| }tt|j|||||fi|||_||_dd|j d|pdd|_ dS) Nr,)list_seprrrrr'r) rrEnumClassListSerializerrrr1rrrrr() r/rrrrrrrrrs r0r1zMultiEnumClassFlag.__init__s (> 3 3 3A0N 2 4 4 4A,E d##, 1dG[22,0222DKDOO !. ! ! ! !;#G2G#G#G I IIIr2ryr%cg}|jjjD]+}|t j|d|,|Srrrs r0rz*MultiEnumClassFlag._extra_xml_dom_elementsrr2c|>|jstjd|jz|j|}nd}|S)rNrrrq)rrr-rr^)r/r7rs r0rz+MultiEnumClassFlag._serialize_value_for_xml"sX  _  049 <   22599 r2r)rOrrrr_r rrr r rr1rrrrrrrrs@r0rrs# JJ JT8C=#x~tCDJ J s) J  JJJJJJ0! GO       r2r)"r collectionsrrUenum functoolstypingrrrrrr r r r r xml.domr absl.flagsrrrrEnumrtotal_orderingrrrrrrrr?r2r0rs@  [[[[[[[[[[[[[[[[[[[[[[[[''''''"""""" WT]] ge49%%% g5g5g5g5g572;g5g5g5T $t*6tDz@DIBKKKKK T$r(^KKK\33333333333r2