o 2hJ7 @s>UdZddlZddlZddlZddlZddlZddlZddlmZm Z m Z m Z m Z m Z mZmZddlmZe ejed<zddlZWn eyMdZYnwe ejed<zddlZWn eyfdZYnwdZdZd Zed ZeejehZee ed <dZ!eed <dZ"e ejed <Gddde Z#de e$efde e#fddZ%de#fddZ&de$fddZ'dej(de$dedej)fddZ*de fddZ+de$d ee$de e$fd!d"Z,d#d$Z-  % d5d&e$d'e e d(e$d)e e$de$f d*d+Z. d6d,e e$efd-e ee$de e$fd.d/Z/d0e$de$fd1d2Z0de$de$fd3d4Z1dS)7z:Internal helper functions for Abseil Python flags library.N)AnyDictIterableList NamedTupleOptionalSequenceSet)minidomfcntltermiosP(g?u [- --„†-Ÿ-￾￿]disclaim_module_ids SPECIAL_FLAGS FLAGS_MODULEc@s$eZdZUdZejed<eed<dS)_ModuleObjectAndNamezkModule object and name. Fields: - module: object, module object. - module_name: str, module name. module module_nameN)__name__ __module__ __qualname____doc__types ModuleType__annotations__strrrN/var/www/html/chatgem/venv/lib/python3.10/site-packages/absl/flags/_helpers.pyrSs   r globals_dictreturncCsJz |d}tj|}Wn tyYdSwt||dkr"tjdS|S)aFReturns 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 if the module could not be identified. rN__main__r)sysmodulesKeyErrorrargv)rnamerrrrget_module_object_and_name^s  r'cCsNtdtD]}t|j}t|}|dur"t|jtvr"|Sqt d)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. NzNo module was found) ranger"getrecursionlimit _getframe f_globalsr'idrrAssertionError)depthglobals_for_framerrrr"get_calling_module_object_and_nameus r1cCstjS)z?Returns the name of the module that's calling into this module.)r1rrrrrget_calling_modulesr2docr&valuecCsDt|}t|tr |}td|}||}||||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)r3r&r4serrrcreate_xml_dom_elements   r@c Cstjr tdus tdurtSz!ttjtjd}t d|d}|t kr(|WSt t dtWStttjfy?tYSw)zAReturns the integer width of help lines that is used in TextWrap.Ns1234hhr(COLUMNS)r"stdoutisattyr r _DEFAULT_HELP_WIDTHioctl TIOCGWINSZstructunpack_MIN_HELP_WIDTHintosgetenv TypeErrorOSErrorerror)datacolumnsrrrget_help_widthsrSattempt longopt_listc stdks|s gSdd|D}fdd|D}||d\}}|ttkr.gSg}|D]\}}||kr@||q2|S|S)z4Returns helpful similar matches for an invalid flag.cSsg|] }|ddqS)=r)split).0vrrr sz(get_flag_suggestions..cs&g|]}t|dt|fqS)r)_damerau_levenshteinlen)rYoptionrTrrr[sr)r]sort _SUGGESTION_ERROR_RATE_THRESHOLDappend) rTrU option_names distances least_errors_ suggestionserrorsr&rr_rget_flag_suggestionss     ricsifdd||S)z6Returns Damerau-Levenshtein edit distance from a to b.cs||fvr ||fS|st|}nc|st|}n\t|dd|d||ddd|dd|dd|d|dk}t|dkrvt|dkrv|d|dkrv|d|dkrv|dd|ddd}||krv|}|||f<|S)z5Recursively defined string distance with memoization.r(NrrV)r]min)xydtdistancememorrrps"    (8 z&_damerau_levenshtein..distancer)abrrorr\s r\r5textlengthindentfirstline_indentcCs|durt}|dur d}|dur|}t||krtdt||kr'td|d}g}tj|||d}tj|||d}dd|DD]}|rT|||n| d|}qGd |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. Nr5zLength of indent exceeds lengthz*Length of first line indent exceeds length)widthinitial_indentsubsequent_indentcss|]}|VqdSN)strip)rYprrr +ztext_wrap.. ) rSr] ValueError expandtabstextwrap TextWrapper splitlinesextendwraprbjoin)rtrurvrwresultwrappersubsequent_wrapper paragraphrrr text_wraps0     rflag_map multi_flagsc cs|D]f\}}|durd|Vqt|tr&|r d|Vqd|Vqt|ttfr5d||fVqz&|rK||vrK|D] }d|t|fVq>nd|ddd|DfVWqtykd||fVYqwdS)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--%s=%s,css|]}t|VqdSr|)r)rYitemrrrrdrz$flag_dict_to_args..)itemsr6r7bytesrrrN)rrkeyr4rrrrflag_dict_to_args6s*      r docstringcCs|sdSd}|}|}|ddD]}|}|r't|t|t|}q|dg}||krG|ddD] }|||dq9|rW|dsW||rW|drM|rh|dsh|d|rh|dr]d |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. r5i r(Nrr) rrlstriprjr]r}rbrstrippopr)r max_indentlinesrvlinestrippedtrimmedrrrtrim_docstringjs*      rcCsB|}tdtj}|d|}t|}tjdd|tjd}|S)z0Takes a __doc__ string and reformats it as help.z^[ ]+$r5z(?<=\S)\n(?=\S) )flags)r}recompileMr:r)r3whitespace_only_linerrr doc_to_helps  r)Nr5Nr|)2rrLrrHr"rrtypingrrrrrrrr xml.domr rrr ImportErrorr rErJrarr9r-r#rrrKrrrrr'r1r2DocumentElementr@rSrir\rrrrrrrrs(            ?   4*