brew/Library/Homebrew/utils/tty.rb

# typed: true # rubocop:todo Sorbet/StrictSigil
# frozen_string_literal: true

# Various helper functions for interacting with TTYs.
module Tty
  @stream = $stdout

  COLOR_CODES = {
    red:     31,
    green:   32,
    yellow:  33,
    blue:    34,
    magenta: 35,
    cyan:    36,
    default: 39,
  }.freeze

  STYLE_CODES = {
    reset:         0,
    bold:          1,
    italic:        3,
    underline:     4,
    strikethrough: 9,
    no_underline:  24,
  }.freeze

  SPECIAL_CODES = {
    up:         "1A",
    down:       "1B",
    right:      "1C",
    left:       "1D",
    erase_line: "K",
    erase_char: "P",
  }.freeze

  CODES = COLOR_CODES.merge(STYLE_CODES).freeze

  class << self
    sig { params(stream: T.any(IO, StringIO), _block: T.proc.params(arg0: T.any(IO, StringIO)).void).void }
    def with(stream, &_block)
      previous_stream = @stream
      @stream = stream

      yield stream
    ensure
      @stream = previous_stream
    end

    sig { params(string: String).returns(String) }
    def strip_ansi(string)
      string.gsub(/\033\[\d+(;\d+)*m/, "")
    end

    sig { params(line_count: Integer).returns(String) }
    def move_cursor_up(line_count)
      "\033[#{line_count}A"
    end

    sig { params(line_count: Integer).returns(String) }
    def move_cursor_down(line_count)
      "\033[#{line_count}B"
    end

    sig { returns(String) }
    def clear_to_end
      "\033[K"
    end

    sig { returns(String) }
    def hide_cursor
      "\033[?25l"
    end

    sig { returns(String) }
    def show_cursor
      "\033[?25h"
    end

    sig { returns(T.nilable([Integer, Integer])) }
    def size
      return @size if defined?(@size)

      height, width = `/bin/stty size 2>/dev/null`.presence&.split&.map(&:to_i)
      return if height.nil? || width.nil?

      @size = [height, width]
    end

    sig { returns(Integer) }
    def height
      @height ||= size&.first || `/usr/bin/tput lines 2>/dev/null`.presence&.to_i || 40
    end

    sig { returns(Integer) }
    def width
      @width ||= size&.second || `/usr/bin/tput cols 2>/dev/null`.presence&.to_i || 80
    end

    sig { params(string: String).returns(String) }
    def truncate(string)
      (w = width).zero? ? string.to_s : (string.to_s[0, w - 4] || "")
    end

    sig { returns(String) }
    def current_escape_sequence
      return "" if @escape_sequence.nil?

      "\033[#{@escape_sequence.join(";")}m"
    end

    sig { void }
    def reset_escape_sequence!
      @escape_sequence = nil
    end

    CODES.each do |name, code|
      define_method(name) do
        @escape_sequence ||= []
        @escape_sequence << code
        self
      end
    end

    SPECIAL_CODES.each do |name, code|
      define_method(name) do
        if @stream.tty?
          "\033[#{code}"
        else
          ""
        end
      end
    end

    sig { returns(String) }
    def to_s
      return "" unless color?

      current_escape_sequence
    ensure
      reset_escape_sequence!
    end

    sig { returns(T::Boolean) }
    def color?
      require "env_config"

      return false if Homebrew::EnvConfig.no_color?
      return true if Homebrew::EnvConfig.color?

      @stream.tty?
    end
  end
end