B )`8@s4dZddlmZddlmZddlmZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl mZddlmZdZd Zd Zd Zd ZGd ddeZGdddeZd&ddZd'ddZGdddeZddZddZGdddeZGdddeZ Gd d!d!eZ!Gd"d#d#eZ"Gd$d%d%eZ#dS)(z>Building Blocks of TensorFlow Debugger Command-Line Interface.)absolute_import)division)print_functionN)pywrap_tf_session)gfilez Zexplicit_user_exitregex_match_linesZinit_scroll_poszmm:c@s"eZdZdddZeddZdS)CommandLineExitNcCst|||_dS)N) Exception__init__ _exit_token)self exit_tokenr^/home/dcms/DCMS/lib/python3.7/site-packages/tensorflow/python/debug/cli/debugger_cli_common.pyr +s zCommandLineExit.__init__cCs|jS)N)r )r rrrr /szCommandLineExit.exit_token)N)__name__ __module__ __qualname__r propertyr rrrrr)s rc@s*eZdZdZd ddZddZdd ZdS) RichLineaRich single-line text. Attributes: text: A plain string, the raw text represented by this object. Should not contain newlines. font_attr_segs: A list of (start, end, font attribute) triples, representing richness information applied to substrings of text. NcCs(||_|rdt||fg|_ng|_dS)a2Construct a RichLine with no rich attributes or a single attribute. Args: text: Raw text string font_attr: If specified, a single font attribute to be applied to the entire text. Extending this object via concatenation allows creation of text with varying attributes. rN)textlenfont_attr_segs)r r font_attrrrrr >s zRichLine.__init__cCst}t|tjr2|j||_|jdd|_|St|tr|j|j|_|jdd|_t|j}x.|jD]$\}}}|j|||||fqlW|Std|dS)aConcatenate two chunks of maybe rich text to make a longer rich line. Does not modify self. Args: other: Another piece of text to concatenate with this one. If it is a plain str, it will be appended to this string with no attributes. If it is a RichLine, it will be appended to this string with its attributes preserved. Returns: A new RichLine comprising both chunks of text, with appropriate attributes applied to the corresponding substrings. Nz)%r cannot be concatenated with a RichLine) r isinstancesix string_typesrrrappend TypeError)r otherretZold_lenstartendrrrr__add__Os    zRichLine.__add__cCs t|jS)N)rr)r rrr__len__mszRichLine.__len__)rN)rrr__doc__r r#r$rrrrr4s rcCs^g}i}xFt|D]:\}}t|trB||j|jrL|j||<q||qWt|||dS)a Convert a list of RichLine objects or strings to a RichTextLines object. Args: rich_text_list: a list of RichLine objects or strings annotations: annotations for the resultant RichTextLines object. Returns: A corresponding RichTextLines object. ) annotations) enumeraterrrrr RichTextLines)Zrich_text_listr&linesriZrlrrr#rich_text_lines_from_rich_line_listqs    r+FcCsFdtjg}|d|r>|d|dtj|dt|S)zGenerate RichTextLines with TensorFlow version info. Args: include_dependency_versions: Include the version of TensorFlow's key dependencies, such as numpy. Returns: A formatted, multi-line `RichTextLines` object. zTensorFlow version: %srzDependency version(s):z numpy: %s)r __version__rnpr()include_dependency_versionsr)rrrget_tensorflow_version_liness    r/c@seZdZdZdddZeddZeddZed d Zd d Z d dZ ddZ ddZ dddZ ddZdddZddZdS)r(a]Rich multi-line text. Line-by-line text output, with font attributes (e.g., color) and annotations (e.g., indices in a multi-dimensional tensor). Used as the text output of CLI commands. Can be rendered on terminal environments such as curses. This is not to be confused with Rich Text Format (RTF). This class is for text lines only. NcCs`t|tr||_n&t|tjr(|g|_ntdt|||_|jsJi|_||_|js\i|_dS)a Constructor of RichTextLines. Args: lines: A list of str or a single str, representing text output to screen. The latter case is for convenience when the text output is single-line. font_attr_segs: A map from 0-based row index to a list of 3-tuples. It lists segments in each row that have special font attributes, such as colors, that are not the default attribute. For example: {1: [(0, 3, "red"), (4, 7, "green")], 2: [(10, 20, "yellow")]} In each tuple, the 1st element is the start index of the segment. The 2nd element is the end index, in an "open interval" fashion. The 3rd element is an object or a list of objects that represents the font attribute. Colors are represented as strings as in the examples above. annotations: A map from 0-based row index to any object for annotating the row. A typical use example is annotating rows of the output as indices in a multi-dimensional tensor. For example, consider the following text representation of a 3x2x2 tensor: [[[0, 0], [0, 0]], [[0, 0], [0, 0]], [[0, 0], [0, 0]]] The annotation can indicate the indices of the first element shown in each row, i.e., {0: [0, 0, 0], 1: [1, 0, 0], 2: [2, 0, 0]} This information can make display of tensors on screen clearer and can help the user navigate (scroll) to the desired location in a large tensor. Raises: ValueError: If lines is of invalid type. zUnexpected type in lines: %sN) rlist_linesrr ValueErrortype_font_attr_segs _annotations)r r)rr&rrrr s!   zRichTextLines.__init__cCs|jS)N)r1)r rrrr)szRichTextLines.linescCs|jS)N)r4)r rrrrszRichTextLines.font_attr_segscCs|jS)N)r5)r rrrr&szRichTextLines.annotationscCs t|jS)N)rr1)r rrr num_linesszRichTextLines.num_linescCs|dks|dkrtd|j||}i}x0|jD]&}||kr2||kr2|j||||<q2Wi}xJ|jD]@}t|ts|j|||<qh||krh||krh|j||||<qhWt|||dS)a}Slice a RichTextLines object. The object itself is not changed. A sliced instance is returned. Args: begin: (int) Beginning line index (inclusive). Must be >= 0. end: (int) Ending line index (exclusive). Must be >= 0. Returns: (RichTextLines) Sliced output instance of RichTextLines. Raises: ValueError: If begin or end is negative. rzEncountered negative index.)rr&)r2r)rr&rintr()r beginr"r)rkeyr&rrrslices   zRichTextLines.slicecCs~|}|j|jx"|jD]}|j||j||<qWx>|jD]4}t|trf|j||j ||<qB|j||j |<qBWdS)aCExtend this instance of RichTextLines with another instance. The extension takes effect on the text lines, the font attribute segments, as well as the annotations. The line indices in the font attribute segments and the annotations are adjusted to account for the existing lines. If there are duplicate, non-line-index fields in the annotations, the value from the input argument "other" will override that in this instance. Args: other: (RichTextLines) The other RichTextLines instance to be appended at the end of this instance. N) r6r1extendr)rr4r&rr7r5)r rZorig_num_lines line_indexr9rrrr;s   zRichTextLines.extendcCs|}|j|j|_i}x |jD]}|j||||<q"W||j||_i}x:|jD]0}t|tr||j ||||<qZ|j |||<qZW||j ||_dS)zAdd another RichTextLines object to the front. Args: other: (RichTextLines) The other object to add to the front to this object. N) r6r)r1rupdater4r5rr7r&)r rZother_num_linesZnew_font_attr_segsr<Znew_annotationsr9rrr_extend_before.s     zRichTextLines._extend_beforecCs(|j||r$||jt|jd<dS)zAppend a single line of text. Args: line: (str) The text to be added to the end. font_attr_segs: (list of tuples) Font attribute segments of the appended line. N)r1rr4r)r linerrrrrNs zRichTextLines.appendcCs||j|jdS)N)rrr)r Z rich_linerrrappend_rich_line[szRichTextLines.append_rich_linecCs$t|}|r||jd<||dS)zPrepend (i.e., add to the front) a single line of text. Args: line: (str) The text to be added to the front. font_attr_segs: (list of tuples) Font attribute segments of the appended line. rN)r(rr>)r r@rrrrrprepend^s  zRichTextLines.prependc Cs:t|d$}x|jD]}||dqWWdQRXdS)zWrite the object itself to file, in a plain format. The font_attr_segs and annotations are ignored. Args: file_path: (str) path of the file to write to. w N)rZOpenr1write)r file_pathfr@rrr write_to_filels  zRichTextLines.write_to_file)NN)N)N)rrrr%r rr)rr&r6r:r;r>rrArBrHrrrrr(s  2   (   r(c Cst|jt|j|jd}yt|}Wn"tj k rJt d|YnXg}xt |jD]\}}| |}g} x$|D]} | | | |fqxW| r\||jkr| |j|<n,|j|| t|j|ddd|j|<| |q\W||jt<|S)aPerform regex match in rich text lines. Produces a new RichTextLines object with font_attr_segs containing highlighted regex matches. Example use cases include: 1) search for specific items in a large list of items, and 2) search for specific numerical values in a large tensor. Args: orig_screen_output: The original RichTextLines, in which the regex find is to be performed. regex: The regex used for matching. font_attr: Font attribute used for highlighting the found result. Returns: A modified copy of orig_screen_output. Raises: ValueError: If input str regex is not a valid regular expression. )rr&z Invalid regular expression: "%s"cSs|dS)Nrr)xrrrzregex_find..)r9)r(r)copydeepcopyrr&recompile sre_constantserrorr2r'finditerrr!r"r;sortedREGEX_MATCH_LINES_KEY) Zorig_screen_outputregexrZnew_screen_outputZre_progrr*r@Zfind_itZ match_segsmatchrrr regex_find}s.       rWcCs"g}t|tstdt|ts(tdtg}d}xt|jD]\}}||||jkrt|j||j|<t ||kr|j|||j kr|j ||j |<|d7}qBg}g}||j kr|j |}d} x| t |kr| |t |krt |} n| |} ||| | x|D]} | d| kr| d| kr| d| krX| d| } nd} | d| krx| d| } n| | } | | kr| | | df}||j kr|g|j |<n|j ||qW| |7} |d7}qW|j |qBWx,|jD]"}t|ts|j||j|<qW||fS)abWrap RichTextLines according to maximum number of columns. Produces a new RichTextLines object with the text lines, font_attr_segs and annotations properly wrapped. This ought to be used sparingly, as in most cases, command handlers producing RichTextLines outputs should know the screen/panel width via the screen_info kwarg and should produce properly length-limited lines in the output accordingly. Args: inp: Input RichTextLines object. cols: Number of columns, as an int. Returns: 1) A new instance of RichTextLines, with line lengths limited to cols. 2) A list of new (wrapped) line index. For example, if the original input consists of three lines and only the second line is wrapped, and it's wrapped into two lines, this return value will be: [0, 1, 3]. Raises: ValueError: If inputs have invalid types. z#Invalid type of input screen_outputzInvalid type of input colsrr?) rr(r2r7r'r)rr6r&rrr;)inpcolsZnew_line_indicesoutZ row_counterr*r@ZwlinesZosegsidxZrlimsegZlbrbZwsegr9rrrwrap_rich_text_liness\                r_c@s~eZdZdZdZdgZdZdgZddZdd d Z dd d Z d dZ dddZ ddZ dddZdddZddZddZdS) CommandHandlerRegistryaRegistry of command handlers for CLI. Handler methods (callables) for user commands can be registered with this class, which then is able to dispatch commands to the correct handlers and retrieve the RichTextLines output. For example, suppose you have the following handler defined: def echo(argv, screen_info=None): return RichTextLines(["arguments = %s" % " ".join(argv), "screen_info = " + repr(screen_info)]) you can register the handler with the command prefix "echo" and alias "e": registry = CommandHandlerRegistry() registry.register_command_handler("echo", echo, "Echo arguments, along with screen info", prefix_aliases=["e"]) then to invoke this command handler with some arguments and screen_info, do: registry.dispatch_command("echo", ["foo", "bar"], screen_info={"cols": 80}) or with the prefix alias: registry.dispatch_command("e", ["foo", "bar"], screen_info={"cols": 80}) The call will return a RichTextLines object which can be rendered by a CLI. helphversionvercCsRi|_i|_i|_i|_d|_|j|j|jd|jd|j|j |j d|j ddS)NzPrint this help message.)prefix_aliasesz:Print the versions of TensorFlow and its key dependencies.) _handlers_alias_to_prefix_prefix_to_aliases_prefix_to_help _help_introregister_command_handler HELP_COMMAND _help_handlerHELP_COMMAND_ALIASESVERSION_COMMAND_version_handlerVERSION_COMMAND_ALIASES)r rrrr 1s zCommandHandlerRegistry.__init__NcCs|s td||jkr"td|t|s2tdt|tjsFtd|rx,|D]$}||rjtd|||j|<qPW||j|<||j|<||j |<dS)aRegister a callable as a command handler. Args: prefix: Command prefix, i.e., the first word in a command, e.g., "print" as in "print tensor_1". handler: A callable of the following signature: foo_handler(argv, screen_info=None), where argv is the argument vector (excluding the command prefix) and screen_info is a dictionary containing information about the screen, such as number of columns, e.g., {"cols": 100}. The callable should return: 1) a RichTextLines object representing the screen output. The callable can also raise an exception of the type CommandLineExit, which if caught by the command-line interface, will lead to its exit. The exception can optionally carry an exit token of arbitrary type. help_info: A help string. prefix_aliases: Aliases for the command prefix, as a list of str. E.g., shorthands for the command prefix: ["p", "pr"] Raises: ValueError: If 1) the prefix is empty, or 2) handler is not callable, or 3) a handler is already registered for the prefix, or 4) elements in prefix_aliases clash with existing aliases. 5) help_info is not a str. zEmpty command prefixz7A handler is already registered for command prefix "%s"zhandler is not callablezhelp_info is not a strz@The prefix alias "%s" clashes with existing prefixes or aliases.N) r2rfcallablerrr_resolve_prefixrgrhri)r prefixhandler help_inforealiasrrrrkOs&"       z/CommandHandlerRegistry.register_command_handlerc Cs8|s td||}|s&td||j|}y|||d}Wntk rf}z|Wdd}~XYntk r}zd|d|g}t|}Wdd}~XYnptk r }zPd|d|fd t|t |fg}| d | t d t|}Wdd}~XYnXt|ts4|dk r4td t ||S) aHandles a command by dispatching it to a registered command handler. Args: prefix: Command prefix, as a str, e.g., "print". argv: Command argument vector, excluding the command prefix, represented as a list of str, e.g., ["tensor_1"] screen_info: A dictionary containing screen info, e.g., {"cols": 100}. Returns: An instance of RichTextLines or None. If any exception is caught during the invocation of the command handler, the RichTextLines will wrap the error type and message. Raises: ValueError: If 1) prefix is empty, or 2) no command handler is registered for the command prefix, or 3) the handler is found for the prefix, but it fails to return a RichTextLines or raise any exception. CommandLineExit: If the command handler raises this type of exception, this method will simply pass it along. zPrefix is emptyz0No handler is registered for command prefix "%s") screen_infoNzSyntax error for command: %szFor help, do "help %s"z1Error occurred during handling of command: %s %s: z%s: %srrDzLReturn value from command handler %s is not None or a RichTextLines instance)r2rsrfr SystemExitr( BaseExceptionjoinr3strrr; traceback format_excsplitr) r rtargvrxresolved_prefixruoutputer)rrrdispatch_commands4   $  z'CommandHandlerRegistry.dispatch_commandcCs||dk S)zTest if a command prefix or its alias is has a registered handler. Args: prefix: A prefix or its alias, as a str. Returns: True iff a handler is registered for prefix. N)rs)r rtrrr is_registereds z$CommandHandlerRegistry.is_registeredcCsx|sftg}|jr||jt|j}x8|D]0}||}|d|d|t|q.W|St||SdS)aCompile help information into a RichTextLines object. Args: cmd_prefix: Optional command prefix. As the prefix itself or one of its aliases. Returns: A RichTextLines object containing the help information. If cmd_prefix is None, the return value will be the full command-line help. Otherwise, it will be the help information for the specified command. rN)r(rjr;rSrf_get_help_for_command_prefixr)r cmd_prefixrvZsorted_prefixesr)rrrget_helps       zCommandHandlerRegistry.get_helpcCs ||_dS)zSet an introductory message to help output. Args: help_intro: (RichTextLines) Rich text lines appended to the beginning of the output of the command "help", as introductory information. N)rj)r Z help_introrrrset_help_introsz%CommandHandlerRegistry.set_help_introcCs8|}|s|St|dkr*||dStdgSdS)atCommand handler for "help". "help" is a common command that merits built-in support from this class. Args: args: Command line arguments to "help" (not including "help" itself). screen_info: (dict) Information regarding the screen, e.g., the screen width in characters: {"cols": 80} Returns: (RichTextLines) Screen text output. r?rz-ERROR: help takes only 0 or 1 input argument.N)rrr()r argsrx_rrrrms  z$CommandHandlerRegistry._help_handlercCs~~tddS)NT)r.)r/)r rrxrrrrpsz'CommandHandlerRegistry._version_handlercCs*||jkr|S||jkr"|j|SdSdS)zResolve command prefix from the prefix itself or its alias. Args: token: a str to be resolved. Returns: If resolvable, the resolved command prefix. If not resolvable, None. N)rfrg)r tokenrrrrss   z&CommandHandlerRegistry._resolve_prefixcCsg}||}|s$|d||S||||jkrV|tdd|j||d|j|d}x|D]}|t|qvW|S)a>Compile the help information for a given command prefix. Args: cmd_prefix: Command prefix, as the prefix itself or one of its aliases. Returns: A list of str as the help information fo cmd_prefix. If the cmd_prefix does not exist, the returned list of str will indicate that. zInvalid command prefix: "%s"z Aliases: z, rrD)rsrrh HELP_INDENTr|rir)r rr)r help_linesr@rrrr.s      z3CommandHandlerRegistry._get_help_for_command_prefix)N)N)N)N)N)rrrr%rlrnrorqr rkrrrrrmrprsrrrrrr`s" > =   r`c@sHeZdZdZddZddZddZdd Zd d Zd d Z ddZ dS)TabCompletionRegistryz&Registry for tab completion responses.cCs i|_dS)N) _comp_dict)r rrrr QszTabCompletionRegistry.__init__cCsXt|tstdt|t|ts4tdt|t|}x|D]}||j|<qBWdS)aORegister a tab-completion context. Register that, for each word in context_words, the potential tab-completions are the words in comp_items. A context word is a pre-existing, completed word in the command line that determines how tab-completion works for another, incomplete word in the same command line. Completion items consist of potential candidates for the incomplete word. To give a general example, a context word can be "drink", and the completion items can be ["coffee", "tea", "water"] Note: A context word can be empty, in which case the context is for the top-level commands. Args: context_words: A list of context words belonging to the context being registered. It is a list of str, instead of a single string, to support synonym words triggering the same tab-completion context, e.g., both "drink" and the short-hand "dr" can trigger the same context. comp_items: A list of completion items, as a list of str. Raises: TypeError: if the input arguments are not all of the correct types. z5Incorrect type in context_list: Expected list, got %sz3Incorrect type in comp_items: Expected list, got %sN)rr0rr3rSr)r context_words comp_itemsZsorted_comp_items context_wordrrrregister_tab_comp_contextWs     z/TabCompletionRegistry.register_tab_comp_contextcCs>x"|D]}||jkrtd|qWx|D] }|j|=q*WdS)zDeregister a list of context words. Args: context_words: A list of context words to deregister, as a list of str. Raises: KeyError: if there are word(s) in context_words that do not correspond to any registered contexts. z0Cannot deregister unregistered context word "%s"N)rKeyError)r rrrrrderegister_contexts    z(TabCompletionRegistry.deregister_contextcCs>||jkrtd||j||t|j||j|<dS)abAdd a list of completion items to a completion context. Args: context_word: A single completion word as a string. The extension will also apply to all other context words of the same context. new_comp_items: (list of str) New completion items to add. Raises: KeyError: if the context word has not been registered. z)Context word "%s" has not been registeredN)rrr;rS)r rZnew_comp_itemsrrrextend_comp_itemss z'TabCompletionRegistry.extend_comp_itemscCs8||jkrtd|x|D]}|j||qWdS)aRRemove a list of completion items from a completion context. Args: context_word: A single completion word as a string. The removal will also apply to all other context words of the same context. comp_items: Completion items to remove. Raises: KeyError: if the context word has not been registered. z)Context word "%s" has not been registeredN)rrremove)r rritemrrrremove_comp_itemss  z'TabCompletionRegistry.remove_comp_itemscs<||jkrdS|j|}tfdd|D}|||fS)aGet the tab completions given a context word and a prefix. Args: context_word: The context word. prefix: The prefix of the incomplete word. Returns: (1) None if no registered context matches the context_word. A list of str for the matching completion items. Can be an empty list of a matching context exists, but no completion item matches the prefix. (2) Common prefix of all the words in the first return value. If the first return value is None, this return value will be None, too. If the first return value is not None, i.e., a list, this return value will be a str, which can be an empty str if there is no common prefix among the items of the list. )NNcsg|]}|r|qSr) startswith).0r)rtrr sz9TabCompletionRegistry.get_completions..)rrS_common_prefix)r rrtrr)rtrget_completionss   z%TabCompletionRegistry.get_completionscCsJ|sdSt|}t|}x,t|D] \}}|||kr"|d|Sq"W|S)zGiven a list of str, returns the longest common prefix. Args: m: (list of str) A list of strings. Returns: (str) The longest common prefix. rN)minmaxr')r ms1s2r*crrrrs  z$TabCompletionRegistry._common_prefixN) rrrr%r rrrrrrrrrrrNs+rc@sReZdZdZdZdddZddZd d Zed d Z d dZ ddZ ddZ dS)CommandHistoryz*Keeps command history and supports lookup.z.tfdbg_historydNcCs&g|_||_|p||_|dS)zCommandHistory constructor. Args: limit: Maximum number of the most recent commands that this instance keeps track of, as an int. history_file_path: (str) Manually specified path to history file. Used in testing. N) _commands_limit_get_default_history_file_path_history_file_path_load_history_from_file)r limitZhistory_file_pathrrrr s zCommandHistory.__init__c Cstj|jryt|jd}|}WdQRXdd|D|_t|j|jkr|j|j d|_t|jd$}x|jD]}| |dqzWWdQRXWnt k rt dYnXdS)NrtcSsg|]}|r|qSr)strip)rcommandrrrrsz:CommandHistory._load_history_from_file..wtrDz%WARNING: writing history file failed.) ospathisfileropen readlinesrrrrEIOErrorprint)r history_filecommandsrrrrrs  z&CommandHistory._load_history_from_filec CsDy*t|jd}||dWdQRXWntk r>YnXdS)NZatrD)rrrEr)r rrrrr_add_command_to_history_files z+CommandHistory._add_command_to_history_filecCstjtjd|jS)N~)rrr| expanduser_HISTORY_FILE_NAME)clsrrrrsz-CommandHistory._get_default_history_file_pathcCsj|jr||jdkrdSt|tjs,td|j|t|j|jkr\|j|j d|_||dS)zAdd a command to the command history. Args: command: The history command, as a str. Raises: TypeError: if command is not a str. Nz1Attempt to enter non-str entry to command history) rrrrrrrrr)r rrrr add_commands   zCommandHistory.add_commandcCs|j| dS)a Look up the n most recent commands. Args: n: Number of most recent commands to look up. Returns: A list of n most recent commands, or all available most recent commands, if n exceeds size of the command history, in chronological order. N)r)r nrrr most_recent_n5s zCommandHistory.most_recent_ncs"fdd|jD}|| dS)a}Look up the n most recent commands that starts with prefix. Args: prefix: The prefix to lookup. n: Number of most recent commands to look up. Returns: A list of n most recent commands that have the specified prefix, or all available most recent commands that have the prefix, if n exceeds the number of history commands with the prefix. csg|]}|r|qSr)r)rcmd)rtrrrOsz0CommandHistory.lookup_prefix..N)r)r rtrrr)rtr lookup_prefixBs zCommandHistory.lookup_prefix)rN) rrrr%rr rr classmethodrrrrrrrrrs   rc@sVeZdZdZdddZeddZeddZed d Zd d Z d dZ ddZ dS)MenuItemz)A class for an item in a text-based menu.TcCs||_||_||_dS)aTMenu constructor. TODO(cais): Nested menu is currently not supported. Support it. Args: caption: (str) caption of the menu item. content: Content of the menu item. For a menu item that triggers a command, for example, content is the command string. enabled: (bool) whether this menu item is enabled. N)_caption_content_enabled)r captioncontentZenabledrrrr Ys zMenuItem.__init__cCs|jS)N)r)r rrrriszMenuItem.captioncCs|jS)N)Z _node_type)r rrrr3msz MenuItem.typecCs|jS)N)r)r rrrrqszMenuItem.contentcCs|jS)N)r)r rrr is_enableduszMenuItem.is_enabledcCs d|_dS)NF)r)r rrrdisablexszMenuItem.disablecCs d|_dS)NT)r)r rrrenable{szMenuItem.enableN)T) rrrr%r rrr3rrrrrrrrrVs    rc@sLeZdZdZdddZddZddZd d Zd d Zd dZ dddZ dS)MenuzA class for text-based menu.NcCs||_g|_dS)zNMenu constructor. Args: name: (str or None) name of this menu. N)_name_items)r namerrrr sz Menu.__init__cCs|j|dS)z[Append an item to the Menu. Args: item: (MenuItem) the item to be appended. N)rr)r rrrrrsz Menu.appendcCs|j||dS)N)rinsert)r indexrrrrrsz Menu.insertcCs t|jS)N)rr)r rrr num_itemsszMenu.num_itemscCsdd|jDS)NcSsg|] }|jqSr)r)rrrrrrsz!Menu.captions..)r)r rrrcaptionssz Menu.captionscCs,|}||krtd||j||S)aGet a MenuItem from the caption. Args: caption: (str) The caption to look up. Returns: (MenuItem) The first-match menu item with the caption, if any. Raises: LookupError: If a menu item with the caption does not exist. z+There is no menu item with the caption "%s")r LookupErrorrr)r rrrrrcaption_to_items zMenu.caption_to_item | c Cs|dk rt|ts|g}|dk r0t|ts0|g}|dk r<|nd}g}x||jD]r}||j7}t|t|j}|r|g} |r| |||t|| fn|r||t||f||7}qLWt|d|idS)a?Format the menu as a single-line RichTextLines object. Args: prefix: (str) String added to the beginning of the line. divider: (str) The dividing string between the menu items. enabled_item_attrs: (list or str) Attributes applied to each enabled menu item, e.g., ["bold", "underline"]. disabled_item_attrs: (list or str) Attributes applied to each disabled menu item, e.g., ["red"]. Returns: (RichTextLines) A single-line output representing the menu, with font_attr_segs marking the individual menu items. Nrr)r) rr0rrrrr;rr() r rtdividerZenabled_item_attrsZdisabled_item_attrsZ menu_lineZ attr_segsrZitem_name_beginZ final_attrsrrrformat_as_single_lines*      zMenu.format_as_single_line)N)NrNN) rrrr%r rrrrrrrrrrrs r)N)F)$r% __future__rrrrLrrNrPr~numpyr-rZtensorflow.python.clientrZtensorflow.python.platformrrZEXPLICIT_USER_EXITrTZINIT_SCROLL_POS_KEYZ MAIN_MENU_KEYr robjectrr+r/r(rWr_r`rrrrrrrrsB      =  d5`>j)