0Vhe7 UdZddlZddlZddlZddlZddlZddlZddlmZm Z m Z m Z m Z m Z mZmZddlmZe ej$ed< ddlZe ej$ed< ddlZdZdZd Zej4d Zeej:ehZee ed <dZ!eed <dZ"e ej$ed <Gdde Z#de e$efde#fdZ%de#fdZ&de$fdZ'dejPde$dedejRfdZ*de fdZ+de$dee$de e$fdZ,dZ- d)de$de e d e$d!e e$de$f d"Z. d*d#e e$efd$e ee$de e$fd%Z/d&e$de$fd'Z0de$de$fd(Z1y#e$rdZYwxYw#e$rdZY wxYw)+z:Internal helper functions for Abseil Python flags library.N)AnyDictIterableList NamedTupleOptionalSequenceSet)minidomfcntltermiosP(g?u [- --„†-Ÿ-￾￿]disclaim_module_ids SPECIAL_FLAGS FLAGS_MODULEc@eZdZUdZeej ed<eed<y)_ModuleObjectAndNamezkModule object and name. Fields: - module: object, module object. - module_name: str, module name. module module_nameN) __name__ __module__ __qualname____doc__rtypes ModuleType__annotations__strC/home/dcms/DCMS/lib/python3.12/site-packages/absl/flags/_helpers.pyrrSs  5## $$r r globals_dictreturnc|jdd}tjj|d}t||dk(rtjdS|S)aNReturns the module that defines a global environment, and its name. Args: globals_dict: A dictionary that should correspond to an environment providing the values of the globals. Returns: _ModuleObjectAndName - pair of module object & module name. Returns (None, None) if the module could not be identified. rN__main__r)getsysmodulesrargv)r"namers r!get_module_object_and_namer+^s\   *d +$ ;;??4 && f.2j.@sxx{ MMFJ MMr ctdtjD]Q}tj|j}t |\}}t |tvsB|Et||cStd)a)Returns the module that's calling into this module. We generally use this function to get the name of the module calling a DEFINE_foo... function. Returns: The module object that called into this one. Raises: AssertionError: Raised when no calling module could be identified. zNo module was found) ranger'getrecursionlimit _getframe f_globalsr+idrrAssertionError)depthglobals_for_framerrs r!"get_calling_module_object_and_namer6rswQ--/07e e,6645FGFK &z,,1H !&+ 66 7 ,--r c*tjS)z?Returns the name of the module that's calling into this module.)r6rrr r!get_calling_moduler8s + - 9 99r docr*valuect|}t|tr|j}tj d|}|j |}|j|j||S)aReturns an XML DOM element with name and text value. Args: doc: minidom.Document, the DOM document it should create nodes from. name: str, the tag of XML element. value: object, whose string representation will be used as the value of the XML element. Illegal or highly discouraged xml 1.0 characters are stripped. Returns: An instance of minidom.Element. ) r isinstanceboollower_ILLEGAL_XML_CHARS_REGEXsub createElement appendChildcreateTextNode)r9r*r:ses r!create_xml_dom_elementrGs` %j!t  A""2q)! !--""1%& (r ctjjr ttt S t j tjtjd}tjd|d}|tk\r|Sttjdt S#tttj f$r t cYSwxYw)zAReturns the integer width of help lines that is used in TextWrap.s1234hhr-COLUMNS)r'stdoutisattyr r _DEFAULT_HELP_WIDTHioctl TIOCGWINSZstructunpack_MIN_HELP_WIDTHintosgetenv TypeErrorOSErrorerror)datacolumnss r!get_help_widthr[s    5=   ;;szz7#5#5w ?DmmD$'*G/! n ryy$78 99 Wfll + sAB, "B,,$CCattempt longopt_listc vt|dks|sgS|Dcgc]}|jdd}}|Dcgc]}t||dt||f}}|j|d\}}|tt|zk\rgSg}|D]\} } | |k(r|j | |S|Scc}wcc}w)z4Returns helpful similar matches for an invalid flag.=r)lensplit_damerau_levenshteinsort _SUGGESTION_ERROR_RATE_THRESHOLDappend) r\r]v option_namesoption distances least_errors_ suggestionserrorsr*s r!get_flag_suggestionsros  \Ql I+78a!''#,q/8,8 *+%WfQs7|.DEvN+)+ ..aL/,5G DD I+ lfd    )9+s B1!B6c(ifd||S)z6Returns Damerau-Levenshtein edit distance from a to b.c ~||fvr||fS|s t|}n|s t|}nt|dd|dz||dddz|dd|dd|d|dk7z}t|dk\r=t|dk\r/|d|dk(r$|d|dk(r|dd|dddz}||kDr|}|||f<|S)z5Recursively defined string distance with memoization.r-Nrr_)ramin)xydtdistancememos r!rwz&_damerau_levenshtein..distances 1v~ !Q$Z a&a  a&a 1QR5! q 1ae q 1QR5!AB% AaDAaDL 1 3a Q1Q111!A$!A$, QqrUAabE "Q & q5!DAJ Hr r)abrwrxs @@r!rcrcs $ * !Qr textlengthindentfirstline_indentc| t}|d}||}t||k\r tdt||k\r td|jd}g}t j |||}t j |||}d|j DD]8}|r!|j|j|n|jd|}:dj|S)aLWraps a given text to a maximum line length and returns it. It turns lines that only contain whitespace into empty lines, keeps new lines, and expands tabs using 4 spaces. Args: text: str, text to wrap. length: int, maximum length of a line, includes indentation. If this is None then use get_help_width() indent: str, indent for all but first line. firstline_indent: str, indent for first line; if None, fall back to indent. Returns: str, the wrapped text. Raises: ValueError: Raised if indent or firstline_indent not shorter than length. r<zLength of indent exceeds lengthz*Length of first line indent exceeds length)widthinitial_indentsubsequent_indentc3<K|]}|jywN)strip).0ps r! ztext_wrap..(s9!AGGI9s ) r[ra ValueError expandtabstextwrap TextWrapper splitlinesextendwraprfjoin)r{r|r}r~resultwrappersubsequent_wrapper paragraphs r! text_wraprs2 ^  F ^ F[F 6 77 f$ A BB  $ &  #3v O'++ 6VE:t'89!i mmGLL+, mmB G ! 6 r flag_map multi_flagsc#K|jD]\}}|d|zt|tr|rd|z*d|z2t|ttfr d|d|S |r||vr|D]}d|dt |n d|ddj d|Dy#t $r d|d|YwxYww)a3Convert a dict of values into process call parameters. This method is used to convert a dictionary into a sequence of parameters for a binary that parses arguments using this module. Args: flag_map: dict, a mapping where the keys are flag names (strings). values are treated according to their type: * If value is ``None``, then only the name is emitted. * If value is ``True``, then only the name is emitted. * If value is ``False``, then only the name prepended with 'no' is emitted. * If value is a string then ``--name=value`` is emitted. * If value is a collection, this will emit ``--name=value1,value2,value3``, unless the flag name is in ``multi_flags``, in which case this will emit ``--name=value1 --name=value2 --name=value3``. * Everything else is converted to string an passed as such. multi_flags: set, names (strings) of flags that should be treated as multi-flags. Yields: sequence of string suitable for a subprocess execution. Nz--%sz--no%sz--r`,c32K|]}t|ywr)r)ritems r!rz$flag_dict_to_args..as*G3t9*Gs)itemsr=r>bytesrrrV)rrkeyr:rs r!flag_dict_to_argsr3s8NN$'jc5 } SL E4 sln EE3< (e $$' 3+- /d"CI. . /!#((*G*G"GH H%'&'&&'s+A$C'AB+(C+C>CCC docstringc|syd}|jj}|}|ddD]6}|j}|st|t |t |z }8|dj g}||kr,|ddD]$}|j ||dj&|r|ds|j|r|ds|r|ds|jd|r|dsdj|S)a Removes indentation from triple-quoted strings. This is the function specified in PEP 257 to handle docstrings: https://www.python.org/dev/peps/pep-0257/. Args: docstring: str, a python docstring. Returns: str, docstring with indentation removed. r<i r-Nrr) rrlstriprrrarrfrstrippopr)r max_indentlinesr}linestrippedtrimmeds r!trim_docstringrgs   *    + + -% &ABi6d{{}H63t9s8}45f6 1X^^  ' jab - nnT&']))+,-   KKM    KKN   7 r c|j}tjdtj}|j d|}t |}tjdd|tj}|S)z0Takes a __doc__ string and reformats it as help.z^[ ]+$r<z(?<=\S)\n(?=\S) )flags)rrecompileMrAr)r9whitespace_only_lines r! doc_to_helprsd #J5  S)# s# !32448# *r )Nr<Nr)2rrTrrPr'rrtypingrrrrrrr r xml.domr rrr ImportErrorr rMrRrerr@r2r(rrrSrrrrr+r6r8DocumentElementrGr[rorcrrrrrr r!rsMA  QQQ  !! %"" ## $( &2::M"$CKK$9!: ;SX; s ,0 hu''(/:MsCx.MM(.,@.,:C:     !$ -0  __ 6$  (  #Y><!&* ; ; SM; ;sm ;  ;~AE1'38n1'+3CH+=1' c]1'h'c'c'T S S i  %  's$ E E#E E #E.-E.