b9dZddlmZddlmZddlmZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddlZddlmZdZdZd Zej(d Zeee j0egZdZdZGd d ej:d d ZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&ddZ'ddZ(dZ)dZ*dZ+y#e $rdZ YwxYw#e $rdZ YwxYw)z:Internal helper functions for Abseil Python flags library.)absolute_import)division)print_functionN)rangeP(g?u [- --„†-Ÿ-￾￿]ceZdZdZy)_ModuleObjectAndNamezkModule object and name. Fields: - module: object, module object. - module_name: str, module name. N)__name__ __module__ __qualname____doc__.platform/bq/third_party/absl/flags/_helpers.pyr r Psrr zmodule module_namec|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. r N__main__r)getsysmodulesr argv) globals_dictnamemodules rget_module_object_and_namerZs\   *d +$ ;;??4 && f.2j.@sxx{ MMFJ MMrctdtjD]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) rrgetrecursionlimit _getframe f_globalsriddisclaim_module_idsr AssertionError)depthglobals_for_framer module_names r"get_calling_module_object_and_namer'lsrQ--/0e e,6645FGFK &z,,1H !&+ 66 1 ,--rc*tjS)z?Returns the name of the module that's calling into this module.)r'r&rrrget_calling_moduler)s + - 9 99rcN t|S#t$rt|cYSwxYw)aConverts a value to a python string. Behavior of this function is intentionally different in Python2/3. In Python2, the given value is attempted to convert to a str (byte string). If it contains non-ASCII characters, it is converted to a unicode instead. In Python3, the given value is always converted to a str (unicode string). This behavior reflects the (bad) practice in Python2 to try to represent a string as str as long as it contains ASCII characters only. Args: value: An object to be converted to a string. Returns: A string representation of the given value. See the description above for its type. )strUnicodeEncodeErrorunicode)values rstr_or_unicoder/s*( u:  5>s $$cNt|}tjr"t|ts|j dd}t|t r|j}tjd|}|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. zutf-8ignore) r/sixPY2 isinstancer-decodeboollower_ILLEGAL_XML_CHARS_REGEXsub createElement appendChildcreateTextNode)docrr.ses rcreate_xml_dom_elementrAsU!WWZ7+ (#At  A""3*! !--""1%& (rctjjr 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.1234hhrCOLUMNS)rstdoutisattytermiosfcntl_DEFAULT_HELP_WIDTHioctl TIOCGWINSZstructunpack_MIN_HELP_WIDTHintosgetenv TypeErrorIOErrorerror)datacolumnss rget_help_widthrXs    5=   ;;szz7#5#5v >DmmD$'*G/! n ryy$78 99 Wfll + sAB, "B,,$CCc 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) attempt longopt_listv option_namesoption distances least_errors_ suggestionserrorsrs rget_flag_suggestionsrls \Ql I+78.distances 1v~ !Q$Z a&a  a&a 1QR5! q 1ae q 1QR5!AB% AaDAaDL 1 3a Q1Q111!A$!A$, QqrUAabE "Q & q5!DAJ Hrr)abrtrus @@rr^r^s $ * !Qrc| 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. r2zLength of indent exceeds lengthz*Length of first line indent exceeds length)widthinitial_indentsubsequent_indentc3<K|]}|jywN)strip).0ps r ztext_wrap..6s9'8!AGGI'8s ) rXr\ ValueError expandtabstextwrap TextWrapper splitlinesextendwraprajoin)textlengthindentfirstline_indentresultwrappersubsequent_wrapper paragraphs r text_wraprs( ^  F ^ F[F 6 77 f$ A BB  $ &  #3v O'++ 6VE:t'89i mmGLL+, mmB G : 6 rc#Ktj|D]\}}|d|zt|tr|rd|z*d|z2t|tt dfr d|d|X |r||vr|D]}d|dt |n d|ddjd|Dy#t$r d|d|YwxYww) aConvert 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%sr2z--r[,c32K|]}t|ywr~)r+)ritems rrz$flag_dict_to_args..is*G3t9s) r3 iteritemsr5r7bytestyper+rrS)flag_map multi_flagskeyr.rs rflag_dict_to_argsrAs,MM(+jc5 } SL E4 sln EE49- .e $$' 3+-d"CI. .!#((*G*G"GH H%,&'&&'s+A.C1AB52C5C C C  Cc|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. r2i rNrr) rrlstripror\rrarstrippopr) docstring max_indentlinesrlinestrippedtrimmeds rtrim_docstringros  *    + + -% &ABid{{}H63t9s8}45f 1X^^  ' jab  nnT&']))+,   KKM    KKN   7 rc|j}tjdtj}|j d|}t |}tjdd|tj}|S)z0Takes a __doc__ string and reformats it as help.z^[ ]+$r2z(?<=\S)\n(?=\S) )flags)rrecompileMr:r)r>whitespace_only_lines r doc_to_helprsd #J5  S)# s# !32448# *rcftturt|tSt|ttfSr~)r+rr5 basestring) maybe_strings ris_bytes_or_stringrs'E\ lJ // lS%L 11r)Nr2Nr~),r __future__rrr collectionsrQrrMrrrI ImportErrorrHr3 six.movesrrJrOr`rr9setr!rr r" SPECIAL_FLAGS FLAGS_MODULE namedtupler rr'r)r/rArXrlr^rrrrrrrrrs%A&%  $( &2::NP 2ckk(3456   K13GHM$.,: 4 8$:86r+'\'T 42m  %  's"B?C ?C C  CC