# -*- coding:utf-8 -*- # Copyright 2016 The Android Open Source Project # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. """Terminal utilities This module handles terminal interaction including ANSI color codes. """ from __future__ import print_function import os import sys _path = os.path.realpath(__file__ + '/../..') if sys.path[0] != _path: sys.path.insert(0, _path) del _path import rh.shell class Color(object): """Conditionally wraps text in ANSI color escape sequences.""" BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE = range(8) BOLD = -1 COLOR_START = '\033[1;%dm' BOLD_START = '\033[1m' RESET = '\033[0m' def __init__(self, enabled=None): """Create a new Color object, optionally disabling color output. Args: enabled: True if color output should be enabled. If False then this class will not add color codes at all. """ self._enabled = enabled def start(self, color): """Returns a start color code. Args: color: Color to use, .e.g BLACK, RED, etc. Returns: If color is enabled, returns an ANSI sequence to start the given color, otherwise returns empty string """ if self.enabled: return self.COLOR_START % (color + 30) return '' def stop(self): """Returns a stop color code. Returns: If color is enabled, returns an ANSI color reset sequence, otherwise returns empty string """ if self.enabled: return self.RESET return '' def color(self, color, text): """Returns text with conditionally added color escape sequences. Args: color: Text color -- one of the color constants defined in this class. text: The text to color. Returns: If self._enabled is False, returns the original text. If it's True, returns text with color escape sequences based on the value of color. """ if not self.enabled: return text if color == self.BOLD: start = self.BOLD_START else: start = self.COLOR_START % (color + 30) return start + text + self.RESET @property def enabled(self): """See if the colorization is enabled.""" if self._enabled is None: if 'NOCOLOR' in os.environ: self._enabled = not rh.shell.boolean_shell_value( os.environ['NOCOLOR'], False) else: self._enabled = is_tty(sys.stderr) return self._enabled def is_tty(fh): """Returns whether the specified file handle is a TTY. Args: fh: File handle to check. Returns: True if |fh| is a TTY """ try: return os.isatty(fh.fileno()) except IOError: return False def print_status_line(line, print_newline=False): """Clears the current terminal line, and prints |line|. Args: line: String to print. print_newline: Print a newline at the end, if sys.stderr is a TTY. """ if is_tty(sys.stderr): output = '\r' + line + '\x1B[K' if print_newline: output += '\n' else: output = line + '\n' sys.stderr.write(output) sys.stderr.flush() def get_input(prompt): """Python 2/3 glue for raw_input/input differences.""" try: return raw_input(prompt) except NameError: # Python 3 renamed raw_input() to input(), which is safe to call since # it does not evaluate the input. # pylint: disable=bad-builtin return input(prompt) def boolean_prompt(prompt='Do you want to continue?', default=True, true_value='yes', false_value='no', prolog=None): """Helper function for processing boolean choice prompts. Args: prompt: The question to present to the user. default: Boolean to return if the user just presses enter. true_value: The text to display that represents a True returned. false_value: The text to display that represents a False returned. prolog: The text to display before prompt. Returns: True or False. """ true_value, false_value = true_value.lower(), false_value.lower() true_text, false_text = true_value, false_value if true_value == false_value: raise ValueError('true_value and false_value must differ: got %r' % true_value) if default: true_text = true_text[0].upper() + true_text[1:] else: false_text = false_text[0].upper() + false_text[1:] prompt = ('\n%s (%s/%s)? ' % (prompt, true_text, false_text)) if prolog: prompt = ('\n%s\n%s' % (prolog, prompt)) while True: try: response = get_input(prompt).lower() except EOFError: # If the user hits CTRL+D, or stdin is disabled, use the default. print() response = None except KeyboardInterrupt: # If the user hits CTRL+C, just exit the process. print() raise if not response: return default if true_value.startswith(response): if not false_value.startswith(response): return True # common prefix between the two... elif false_value.startswith(response): return False