a Sicv4@s&dZddlZddlZddlZddlZddlZddlZz ddlZWneyVdZYn0z ddl Z WneyzdZ Yn0dZ dZ dZ e dZeeejegZdZdZGdddedd Zd d Zd d ZddZddZddZddZddZd!ddZd"ddZ ddZ!dd Z"dS)#z:Internal helper functions for Abseil Python flags library.NP(g?u [- --„†-Ÿ-￾￿]c@seZdZdZdS)_ModuleObjectAndNamezkModule object and name. Fields: - module: object, module object. - module_name: str, module name. N)__name__ __module__ __qualname____doc__r r O/var/www/html/django/DPS/env/lib/python3.9/site-packages/absl/flags/_helpers.pyrJsrzmodule module_namecCs6|dd}tj|d}t||dkr0tjdn|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)Z globals_dictnamemoduler r r get_module_object_and_nameTs rcCsZtdtD]>}t|j}t|\}}t|tvr|durt||Sqt ddS)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_globalsriddisclaim_module_idsrAssertionError)depthZglobals_for_framer module_namer r r "get_calling_module_object_and_namefs   rcCstjS)z?Returns the name of the module that's calling into this module.)rrr r r r get_calling_module|srcCsDt|}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. ) str isinstanceboollower_ILLEGAL_XML_CHARS_REGEXsub createElement appendChildcreateTextNode)docrvalueser r r create_xml_dom_elements    r-c CstjrtdustdurtSzBttjtjd}t d|d}|t krP|WSt t dtWStttjfy~tYS0dS)zAReturns the integer width of help lines that is used in TextWrap.NZ1234hhrCOLUMNS)r stdoutisattytermiosfcntl_DEFAULT_HELP_WIDTHioctl TIOCGWINSZstructunpack_MIN_HELP_WIDTHintosgetenv TypeErrorIOErrorerror)datacolumnsr r r get_help_widthsrBc stdks|sgSdd|D}fdd|D}||d\}}|ttkr\gSg}|D] \}}||kr||qdqqd|S)z4Returns helpful similar matches for an invalid flag.cSsg|]}|ddqS)=r)split).0vr r r z(get_flag_suggestions..cs&g|]}t|dt|fqS)r)_damerau_levenshteinlen)rFoptionattemptr r rHsr)rKsort _SUGGESTION_ERROR_RATE_THRESHOLDappend) rNZ longopt_listZ option_names distancesZ least_errors_Z suggestionserrorsrr rMr get_flag_suggestionss     rUcsifdd||S)z6Returns Damerau-Levenshtein edit distance from a to b.cs||fvr||fS|s&t|}n|s4t|}nt|dd|d||ddd|dd|dd|d|dk}t|dkrt|dkr|d|dkr|d|dkr|dd|ddd}||kr|}|||f<|S)z5Recursively defined string distance with memoization.rNrrC)rKmin)xydtdistancememor r r\s"    (8 z&_damerau_levenshtein..distancer )abr r[r rJsrJrcCs|durt}|durd}|dur&|}t||kr:tdt||krNtd|d}g}tj|||d}tj|||d}dd|DD](}|r|||n | d|}qd |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. NrzLength of indent exceeds lengthz*Length of first line indent exceeds length)widthinitial_indentsubsequent_indentcss|]}|VqdSN)strip)rFpr r r rIztext_wrap.. ) rBrK ValueError expandtabstextwrap TextWrapper splitlinesextendwraprQjoin)textlengthindentZfirstline_indentresultwrapperZsubsequent_wrapper paragraphr r r text_wraps0    rwc cs|D]\}}|dur$d|Vqt|trJ|r>d|Vqd|Vqt|ttdfrld||fVqzL|r||vr|D]}d|t|fVq~nd|ddd|DfVWqtyd||fVYq0qdS) 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%srz--%s=%s,css|]}t|VqdSrd)r )rFitemr r r rgJrIz$flag_dict_to_args..)itemsr!r"bytestyper rpr=)Zflag_mapZ multi_flagskeyr*ryr r r flag_dict_to_argss      " r~cCs|sdSd}|}|}|ddD]&}|}|r(t|t|t|}q(|dg}||kr|ddD]}|||dqr|r|ds|q|r|ds|dqd |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. ri rNrrh) rjrmlstriprVrKrerQrstrippoprp) docstring max_indentlinesrslinestrippedtrimmedr r r trim_docstringPs$      rcCsB|}tdtj}|d|}t|}tjdd|tjd}|S)z0Takes a __doc__ string and reformats it as help.z^[ ]+$rz(?<=\S)\n(?=\S) )flags)rerecompileMr%r)r)Zwhitespace_only_liner r r doc_to_helpzs  r)NrN)N)#r collectionsr;rr7r rkr3 ImportErrorr2r4r9rPrr$setrrrr SPECIAL_FLAGS FLAGS_MODULE namedtuplerrrrr-rBrUrJrwr~rrr r r r sJ           9 2*