Class: Thor::Shell::Basic
- Inherits:
-
Object
- Object
- Thor::Shell::Basic
- Defined in:
- lib/thor/shell/basic.rb
Direct Known Subclasses
Instance Attribute Summary collapse
-
#base ⇒ Object
Returns the value of attribute base.
-
#padding ⇒ Object
Returns the value of attribute padding.
Instance Method Summary collapse
-
#ask(statement, color = nil) ⇒ Object
Ask something to the user and receives a response.
-
#error(statement) ⇒ Object
Called if something goes wrong during the execution.
-
#file_collision(destination) ⇒ Object
Deals with file collision and returns true if the file should be overwriten and false otherwise.
-
#initialize ⇒ Basic
constructor
Initialize base and padding to nil.
-
#no?(statement, color = nil) ⇒ Boolean
Make a question the to user and returns true if the user replies “n” or “no”.
-
#print_list(list, mode = :rows) ⇒ Object
Prints a list of items.
-
#print_table(table, options = {}) ⇒ Object
Prints a table.
-
#say(message = "", color = nil, force_new_line = false) ⇒ Object
Say (print) something to the user.
-
#say_status(status, message, log_status = true) ⇒ Object
Say a status with the given color and appends the message.
-
#yes?(statement, color = nil) ⇒ Boolean
Make a question the to user and returns true if the user replies “y” or “yes”.
Constructor Details
#initialize ⇒ Basic
Initialize base and padding to nil.
10 11 12 |
# File 'lib/thor/shell/basic.rb', line 10 def initialize #:nodoc: @base, @padding = nil, 0 end |
Instance Attribute Details
#base ⇒ Object
Returns the value of attribute base.
6 7 8 |
# File 'lib/thor/shell/basic.rb', line 6 def base @base end |
#padding ⇒ Object
Returns the value of attribute padding.
6 7 8 |
# File 'lib/thor/shell/basic.rb', line 6 def padding @padding end |
Instance Method Details
#ask(statement, color = nil) ⇒ Object
Ask something to the user and receives a response.
Example
ask(“What is your name?”)
25 26 27 28 |
# File 'lib/thor/shell/basic.rb', line 25 def ask(statement, color=nil) say("#{statement} ", color) $stdin.gets.strip end |
#error(statement) ⇒ Object
Called if something goes wrong during the execution. This is used by Thor internally and should not be used inside your scripts. If someone went wrong, you can always raise an exception. If you raise a Thor::Error, it will be rescued and wrapped in the method below.
174 175 176 |
# File 'lib/thor/shell/basic.rb', line 174 def error(statement) #:nodoc: $stderr.puts statement end |
#file_collision(destination) ⇒ Object
Deals with file collision and returns true if the file should be overwriten 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 proc that returns the value to be used in diff
143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 |
# File 'lib/thor/shell/basic.rb', line 143 def file_collision(destination) return true if @always_force = block_given? ? "[Ynaqdh]" : "[Ynaqh]" while true answer = ask %[Overwrite #{destination}? (enter "h" for help) #{}] 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 |
#no?(statement, color = nil) ⇒ Boolean
Make a question the to user and returns true if the user replies “n” or “no”.
75 76 77 |
# File 'lib/thor/shell/basic.rb', line 75 def no?(statement, color=nil) !yes?(statement, color) end |
#print_list(list, mode = :rows) ⇒ Object
Prints a list of items.
Parameters
list<Array[String, String, …]>
- mode<Symbol>
-
Can be :rows or :inline. Defaults to :rows.
85 86 87 88 89 90 91 92 93 94 95 96 97 |
# File 'lib/thor/shell/basic.rb', line 85 def print_list(list, mode=:rows) return if list.empty? content = case mode when :inline last = list.pop "#{list.join(", ")}, and #{last}" else # rows list.join("\n") end $stdout.puts content end |
#print_table(table, options = {}) ⇒ Object
Prints a table.
Parameters
Array[Array[String, String, …]]
Options
- ident<Integer>
-
Ident the first column by ident value.
- emphasize_last<Boolean>
-
When true, add a different behavior to the last column.
108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 |
# File 'lib/thor/shell/basic.rb', line 108 def print_table(table, ={}) return if table.empty? formats = [] 0.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]) if [:ident] formats << "%s" if [:emphasize_last] table.each do |row| next if row[-1].empty? row[-1] = "# #{row[-1]}" end end table.each do |row| row.each_with_index do |column, i| $stdout.print formats[i] % column.to_s end $stdout.puts end end |
#say(message = "", color = nil, force_new_line = false) ⇒ Object
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.”)
37 38 39 40 41 42 43 44 45 46 47 48 |
# File 'lib/thor/shell/basic.rb', line 37 def say(="", color=nil, force_new_line=false) = .to_s new_line = force_new_line || !([-1, 1] == " " || [-1, 1] == "\t") = set_color(, color) if color if new_line $stdout.puts() else $stdout.print() $stdout.flush end end |
#say_status(status, message, log_status = true) ⇒ Object
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.
55 56 57 58 59 60 61 62 63 |
# File 'lib/thor/shell/basic.rb', line 55 def say_status(status, , log_status=true) #:nodoc: 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 say "#{status}#{spaces}#{}", nil, true end |
#yes?(statement, color = nil) ⇒ Boolean
Make a question the to user and returns true if the user replies “y” or “yes”.
68 69 70 |
# File 'lib/thor/shell/basic.rb', line 68 def yes?(statement, color=nil) ask(statement, color) =~ is?(:yes) end |