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
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 something 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
destination
==== 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:
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:
Initialize base and padding to nil.
def initialize #:nodoc: @base, @padding = nil, 0 end
def is?(value) #: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
ident
==== 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
==== 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:
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:
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:
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 stderr
def stderr $stderr end
def stdin
def stdin $stdin end
def stdout
def stdout $stdout end
def terminal_width
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