class Thor::Shell::Basic

def ask(statement, color=nil)


ask("What is your name?")
==== Example

Ask something to the user and receives a response.
def ask(statement, color=nil)
  say("#{statement} ", color)
  $stdin.gets.strip
end

def dynamic_width

Calculate the dynamic width of the terminal
def dynamic_width
  @dynamic_width ||= (dynamic_width_stty.nonzero? || dynamic_width_tput)
end

def dynamic_width_stty

def dynamic_width_stty
  %x{stty size 2>/dev/null}.split[1].to_i
end

def dynamic_width_tput

def dynamic_width_tput
  %x{tput cols 2>/dev/null}.to_i
end

def error(statement)


will be rescued and wrapped in the method below.
wrong, you can always raise an exception. If you raise a Thor::Error, it
internally and should not be used inside your scripts. If someone went
Called if something goes wrong during the execution. This is used by Thor
def error(statement)
  $stderr.puts statement
end

def file_collision(destination)


block:: an optional block that returns the value to be used in diff
destination:: the destination file to solve conflicts
==== Parameters

response as the content for the diff.
overwriten and false otherwise. If a block is given, it uses the block
Deals with file collision and returns true if the file should be
def file_collision(destination)
  return true if @always_force
  options = block_given? ? "[Ynaqdh]" : "[Ynaqh]"
  while true
    answer = ask %[Overwrite #{destination}? (enter "h" for help) #{options}]
    case answer
      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

def file_collision_help #:nodoc:

:nodoc:
def file_collision_help #:nodoc:
 overwrite
do not overwrite
 overwrite this and all others
, abort
, show the differences between the old and the new
, show this help
end

def initialize #:nodoc:

:nodoc:

Initialize base and padding to nil.
def initialize #:nodoc:
  @base, @padding = nil, 0
end

def is?(value) #:nodoc:

:nodoc:
def is?(value) #:nodoc:
  value = value.to_s
  if value.size == 1
    /\A#{value}\z/i
  else
    /\A(#{value}|#{value[0,1]})\z/i
  end
end

def mute


Mute everything that's inside given block
def mute
  @mute = true
  yield
ensure
  @mute = false
end

def mute?


Check if base is muted
def mute?
  @mute
end

def no?(statement, color=nil)


"no".
Make a question the to user and returns true if the user replies "n" or
def no?(statement, color=nil)
  !yes?(statement, color)
end

def padding=(value)


Sets the output padding, not allowing less than zero values.
def padding=(value)
  @padding = [0, value].max
end

def print_table(table, options={})


colwidth:: Force the first column to colwidth spaces wide.
ident:: Indent the first column by ident value.
==== Options

Array[Array[String, String, ...]]
==== Parameters

Prints a table.
def print_table(table, options={})
  return if table.empty?
  formats, ident, colwidth = [], options[:ident].to_i, options[:colwidth]
  options[:truncate] = terminal_width if options[:truncate] == true
  formats << "%-#{colwidth + 2}s" if colwidth
  start = colwidth ? 1 : 0
  start.upto(table.first.length - 2) do |i|
    maxima ||= table.max{|a,b| a[i].size <=> b[i].size }[i].size
    formats << "%-#{maxima + 2}s"
  end
  formats[0] = formats[0].insert(0, " " * ident)
  formats << "%s"
  table.each do |row|
    sentence = ""
    row.each_with_index do |column, i|
      sentence << formats[i] % column.to_s
    end
    sentence = truncate(sentence, options[:truncate]) if options[:truncate]
    $stdout.puts sentence
  end
end

def print_wrapped(message, options={})


ident:: Indent each line of the printed paragraph by ident value.
==== Options

String
==== Parameters

terminal display. Ideal for printing heredocs.
Prints a long string, word-wrapping the text to the current width of the
def print_wrapped(message, options={})
  ident = options[:ident] || 0
  width = terminal_width - ident
  paras = message.split("\n\n")
  paras.map! do |unwrapped|
    unwrapped.strip.gsub(/\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, " " * ident)
    end
    $stdout.puts unless para == paras.last
  end
end

def quiet? #:nodoc:

:nodoc:
def quiet? #:nodoc:
  mute? || (base && base.options[:quiet])
end

def say(message="", color=nil, force_new_line=(message.to_s !~ /( |\t)$/))


say("I know you knew that.")
==== Example

are passed straight to puts (behavior got from Highline).
or tab character, a new line is not appended (print + flush). Otherwise
Say (print) something to the user. If the sentence ends with a whitespace
def say(message="", color=nil, force_new_line=(message.to_s !~ /( |\t)$/))
  message = message.to_s
  message = set_color(message, color) if color
  spaces = "  " * padding
  if force_new_line
    $stdout.puts(spaces + message)
  else
    $stdout.print(spaces + message)
  end
  $stdout.flush
end

def say_status(status, message, log_status=true)


given in log_status, it's used as the color.
in log_status, avoiding the message from being shown. If a Symbol is
method is used frequently by actions, it allows nil or false to be given
Say a status with the given color and appends the message. Since this
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
  $stdout.puts "#{status}#{spaces}#{message}"
  $stdout.flush
end

def set_color(string, color, bold=false) #:nodoc:

:nodoc:

Thor::Shell::Basic class.
Apply color to the given string with optional bold. Disabled in the
def set_color(string, color, bold=false) #:nodoc:
  string
end

def show_diff(destination, content) #:nodoc:

:nodoc:
def show_diff(destination, content) #:nodoc:
  diff_cmd = ENV['THOR_DIFF'] || ENV['RAILS_DIFF'] || 'diff -u'
  Tempfile.open(File.basename(destination), File.dirname(destination)) do |temp|
    temp.write content
    temp.rewind
    system %(#{diff_cmd} "#{destination}" "#{temp.path}")
  end
end

def terminal_width

Copyright (c) 2003, 2004 Jim Weirich
This code was copied from Rake, available under MIT-LICENSE
def terminal_width
  if ENV['THOR_COLUMNS']
    result = ENV['THOR_COLUMNS'].to_i
  else
    result = unix? ? dynamic_width : 80
  end
  (result < 10) ? 80 : result
rescue
  80
end

def truncate(string, width)

def truncate(string, width)
  if string.length <= width
    string
  else
    ( string[0, width-3] || "" ) + "..."
  end
end

def unix?

def unix?
  RUBY_PLATFORM =~ /(aix|darwin|linux|(net|free|open)bsd|cygwin|solaris|irix|hpux)/i
end

def yes?(statement, color=nil)


"yes".
Make a question the to user and returns true if the user replies "y" or
def yes?(statement, color=nil)
  !!(ask(statement, color) =~ is?(:yes))
end