# 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
.
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)
# 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 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.
the destination file to solve conflicts
an optional block that returns the value to be used in diff
# 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.
# 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
# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 27 def mute? @mute end
Check if base is muted
# 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”.
# 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.
# 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
Array[String, String
, …]
# 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.
Array[Array[String, String
, …]]
Indent the first column by indent value.
Force the first column to colwidth spaces wide.
# 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.
Indent each line of the printed paragraph by indent value.
# 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).
say(“I know you knew that.”)
# 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.
# 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
This code was copied from Rake, available under MIT-LICENSE Copyright © 2003, 2004 Jim Weirich
# 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”.
# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 394 def as_unicode yield end
# 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
# 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
# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 312 def can_display_colors? false end
# 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
# 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
# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 374 def dynamic_width_tput `tput cols 2>/dev/null`.to_i end
# 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
# 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
# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 325 def stderr $stderr end
# File lib/bundler/vendor/thor/lib/thor/shell/basic.rb, line 321 def stdout $stdout end
# 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
# 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.