class Bundler::Thor::Shell::Basic

Parent:: Object

Attributes

base[RW]

padding[R]

Public Instance Methods

ask(statement, *args) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 70
def ask(statement, *args)
  options = args.last.is_a?(Hash) ? args.pop : {}
  color = args.first

  if options[:limited_to]
    ask_filtered(statement, color, options)
  else
    ask_simply(statement, color, options)
  end
end

Asks something to the user and receives a response.

If asked to limit the correct responses, you can pass in an array of acceptable answers. If one of those is not supplied, they will be shown a message stating that one of those answers must be given and re-asked the question.

If asking for sensitive information, the :echo option can be set to false to mask user input from $stdin.

If the required input is a path, then set the path option to true. This will enable tab completion for file paths relative to the current working directory on systems that support Readline.

Example

ask(“What is your name?”)

ask(“What is your favorite Neopolitan flavor?”, :limited_to => [“strawberry”, “chocolate”, “vanilla”])

ask(“What is your password?”, :echo => false)

ask(“Where should the file be saved?”, :path => true)

error(statement) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 294
def error(statement)
  stderr.puts statement
end

Called if something goes wrong during the execution. This is used by Bundler::Thor internally and should not be used inside your scripts. If something went wrong, you can always raise an exception. If you raise a Bundler::Thor::Error, it will be rescued and wrapped in the method below.

file_collision(destination) { || ... } Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 244
def file_collision(destination)
  return true if @always_force
  options = block_given? ? "[Ynaqdh]" : "[Ynaqh]"

  loop do
    answer = ask(
      %[Overwrite #{destination}? (enter "h" for help) #{options}],
      :add_to_history => false
    )

    case answer
    when nil
      say ""
      return true
    when is?(:yes), is?(:force), ""
      return true
    when is?(:no), is?(:skip)
      return false
    when is?(:always)
      return @always_force = true
    when is?(:quit)
      say "Aborting..."
      raise SystemExit
    when is?(:diff)
      show_diff(destination, yield) if block_given?
      say "Retrying..."
    else
      say file_collision_help
    end
  end
end

Deals with file collision and returns true if the file should be overwritten and false otherwise. If a block is given, it uses the block response as the content for the diff.

Parameters

destination<String>: the destination file to solve conflicts
block<Proc>: an optional block that returns the value to be used in diff

indent(count = 1) { || ... } Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 39
def indent(count = 1)
  orig_padding = padding
  self.padding = padding + count
  yield
  self.padding = orig_padding
end

Sets the output padding while executing a block and resets it.

mute() { || ... } Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 18
def mute
  @mute = true
  yield
ensure
  @mute = false
end

Mute everything that's inside given block

mute?() Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 27
def mute?
  @mute
end

Check if base is muted

no?(statement, color = nil) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 126
def no?(statement, color = nil)
  !!(ask(statement, color, :add_to_history => false) =~ is?(:no))
end

Make a question the to user and returns true if the user replies “n” or “no”.

padding=(value) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 33
def padding=(value)
  @padding = [0, value].max
end

Sets the output padding, not allowing less than zero values.

print_in_columns(array) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 135
def print_in_columns(array)
  return if array.empty?
  colwidth = (array.map { |el| el.to_s.size }.max || 0) + 2
  array.each_with_index do |value, index|
    # Don't output trailing spaces when printing the last column
    if ((((index + 1) % (terminal_width / colwidth))).zero? && !index.zero?) || index + 1 == array.length
      stdout.puts value
    else
      stdout.printf("%-#{colwidth}s", value)
    end
  end
end

Prints values in columns

Parameters

Array[String, String, …]

print_table(array, options = {}) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 157
def print_table(array, options = {}) # rubocop:disable MethodLength
  return if array.empty?

  formats = []
  indent = options[:indent].to_i
  colwidth = options[:colwidth]
  options[:truncate] = terminal_width if options[:truncate] == true

  formats << "%-#{colwidth + 2}s".dup if colwidth
  start = colwidth ? 1 : 0

  colcount = array.max { |a, b| a.size <=> b.size }.size

  maximas = []

  start.upto(colcount - 1) do |index|
    maxima = array.map { |row| row[index] ? row[index].to_s.size : 0 }.max
    maximas << maxima
    formats << if index == colcount - 1
                 # Don't output 2 trailing spaces when printing the last column
                 "%-s".dup
               else
                 "%-#{maxima + 2}s".dup
               end
  end

  formats[0] = formats[0].insert(0, " " * indent)
  formats << "%s"

  array.each do |row|
    sentence = "".dup

    row.each_with_index do |column, index|
      maxima = maximas[index]

      f = if column.is_a?(Numeric)
        if index == row.size - 1
          # Don't output 2 trailing spaces when printing the last column
          "%#{maxima}s"
        else
          "%#{maxima}s  "
        end
      else
        formats[index]
      end
      sentence << f % column.to_s
    end

    sentence = truncate(sentence, options[:truncate]) if options[:truncate]
    stdout.puts sentence
  end
end

Prints a table.

Parameters

Array[Array[String, String, …]]

Options

indent<Integer>: Indent the first column by indent value.
colwidth<Integer>: Force the first column to colwidth spaces wide.

print_wrapped(message, options = {}) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 219
def print_wrapped(message, options = {})
  indent = options[:indent] || 0
  width = terminal_width - indent
  paras = message.split("\n\n")

  paras.map! do |unwrapped|
    unwrapped.strip.tr("\n", " ").squeeze(" ").gsub(/.{1,#{width}}(?:\s|\Z)/) { ($& + 5.chr).gsub(/\n\005/, "\n").gsub(/\005/, "\n") }
  end

  paras.each do |para|
    para.split("\n").each do |line|
      stdout.puts line.insert(0, " " * indent)
    end
    stdout.puts unless para == paras.last
  end
end

Prints a long string, word-wrapping the text to the current width of the terminal display. Ideal for printing heredocs.

Parameters

String

Options

indent<Integer>: Indent each line of the printed paragraph by indent value.

say(message = "", color = nil, force_new_line = (message.to_s !~ /( |\t)\Z/)) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 88
def say(message = "", color = nil, force_new_line = (message.to_s !~ /( |\t)\Z/))
  buffer = prepare_message(message, *color)
  buffer << "\n" if force_new_line && !message.to_s.end_with?("\n")

  stdout.print(buffer)
  stdout.flush
end

Say (print) something to the user. If the sentence ends with a whitespace or tab character, a new line is not appended (print + flush). Otherwise are passed straight to puts (behavior got from Highline).

Example

say(“I know you knew that.”)

say_status(status, message, log_status = true) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 101
def say_status(status, message, log_status = true)
  return if quiet? || log_status == false
  spaces = "  " * (padding + 1)
  color  = log_status.is_a?(Symbol) ? log_status : :green

  status = status.to_s.rjust(12)
  status = set_color status, color, true if color

  buffer = "#{status}#{spaces}#{message}"
  buffer = "#{buffer}\n" unless buffer.end_with?("\n")

  stdout.print(buffer)
  stdout.flush
end

Say a status with the given color and appends the message. Since this method is used frequently by actions, it allows nil or false to be given in log_status, avoiding the message from being shown. If a Symbol is given in log_status, it's used as the color.

terminal_width() Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 278
def terminal_width
  result = if ENV["THOR_COLUMNS"]
    ENV["THOR_COLUMNS"].to_i
  else
    unix? ? dynamic_width : 80
  end
  result < 10 ? 80 : result
rescue
  80
end

yes?(statement, color = nil) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 119
def yes?(statement, color = nil)
  !!(ask(statement, color, :add_to_history => false) =~ is?(:yes))
end

Make a question the to user and returns true if the user replies “y” or “yes”.

Protected Instance Methods

as_unicode() { || ... } Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 394
def as_unicode
  yield
end

ask_filtered(statement, color, options) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 424
def ask_filtered(statement, color, options)
  answer_set = options[:limited_to]
  correct_answer = nil
  until correct_answer
    answers = answer_set.join(", ")
    answer = ask_simply("#{statement} [#{answers}]", color, options)
    correct_answer = answer_set.include?(answer) ? answer : nil
    say("Your response must be one of: [#{answers}]. Please try again.") unless correct_answer
  end
  correct_answer
end

ask_simply(statement, color, options) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 407
def ask_simply(statement, color, options)
  default = options[:default]
  message = [statement, ("(#{default})" if default), nil].uniq.join(" ")
  message = prepare_message(message, *color)
  result = Bundler::Thor::LineEditor.readline(message, options)

  return unless result

  result = result.strip

  if default && result == ""
    default
  else
    result
  end
end

can_display_colors?() Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 312
def can_display_colors?
  false
end

dynamic_width() Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 366
def dynamic_width
  @dynamic_width ||= (dynamic_width_stty.nonzero? || dynamic_width_tput)
end

Calculate the dynamic width of the terminal

dynamic_width_stty() Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 370
def dynamic_width_stty
  `stty size 2>/dev/null`.split[1].to_i
end

dynamic_width_tput() Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 374
def dynamic_width_tput
  `tput cols 2>/dev/null`.to_i
end

lookup_color(color) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 316
def lookup_color(color)
  return color unless color.is_a?(Symbol)
  self.class.const_get(color.to_s.upcase)
end

prepare_message(message, *color) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 307
def prepare_message(message, *color)
  spaces = "  " * padding
  spaces + set_color(message.to_s, *color)
end

stderr() Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 325
def stderr
  $stderr
end

stdout() Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 321
def stdout
  $stdout
end

truncate(string, width) Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 382
def truncate(string, width)
  as_unicode do
    chars = string.chars.to_a
    if chars.length <= width
      chars.join
    else
      chars[0, width - 3].join + "..."
    end
  end
end

unix?() Show source

# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 378
def unix?
  RUBY_PLATFORM =~ /(aix|darwin|linux|(net|free|open)bsd|cygwin|solaris|irix|hpux)/i
end

Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.

Docs

Docs4dev

Title here

class Bundler::Thor::Shell::Basic

Attributes

Public Instance Methods

Example

Parameters

Parameters

Parameters

Options

Parameters

Options

Example

Protected Instance Methods