Class: LibGems::StreamUI
- Inherits:
-
Object
- Object
- LibGems::StreamUI
- Defined in:
- lib/libgems/user_interaction.rb
Overview
LibGems::StreamUI implements a simple stream based user interface.
Defined Under Namespace
Classes: SilentDownloadReporter, SilentProgressReporter, SimpleProgressReporter, VerboseDownloadReporter, VerboseProgressReporter
Instance Attribute Summary collapse
-
#errs ⇒ Object
readonly
Returns the value of attribute errs.
-
#ins ⇒ Object
readonly
Returns the value of attribute ins.
-
#outs ⇒ Object
readonly
Returns the value of attribute outs.
Instance Method Summary collapse
-
#alert(statement, question = nil) ⇒ Object
Display an informational alert.
-
#alert_error(statement, question = nil) ⇒ Object
Display an error message in a location expected to get error messages.
-
#alert_warning(statement, question = nil) ⇒ Object
Display a warning in a location expected to get error messages.
-
#ask(question) ⇒ Object
Ask a question.
-
#ask_for_password(question) ⇒ Object
Ask for a password.
-
#ask_for_password_on_unix ⇒ Object
Asks for a password that works on unix.
-
#ask_for_password_on_windows ⇒ Object
Asks for a password that works on windows.
-
#ask_yes_no(question, default = nil) ⇒ Object
Ask a question.
-
#choose_from_list(question, list) ⇒ Object
Choose from a list of options.
-
#debug(statement) ⇒ Object
Display a debug message on the same location as error messages.
-
#download_reporter(*args) ⇒ Object
Return a download reporter object chosen from the current verbosity.
-
#initialize(in_stream, out_stream, err_stream = STDERR) ⇒ StreamUI
constructor
A new instance of StreamUI.
-
#progress_reporter(*args) ⇒ Object
Return a progress reporter object chosen from the current verbosity.
-
#say(statement = "") ⇒ Object
Display a statement.
-
#terminate_interaction(status = 0) ⇒ Object
Terminate the application with exit code
status
, running any exit handlers that might have been defined.
Constructor Details
#initialize(in_stream, out_stream, err_stream = STDERR) ⇒ StreamUI
Returns a new instance of StreamUI.
135 136 137 138 139 |
# File 'lib/libgems/user_interaction.rb', line 135 def initialize(in_stream, out_stream, err_stream=STDERR) @ins = in_stream @outs = out_stream @errs = err_stream end |
Instance Attribute Details
#errs ⇒ Object (readonly)
Returns the value of attribute errs.
133 134 135 |
# File 'lib/libgems/user_interaction.rb', line 133 def errs @errs end |
#ins ⇒ Object (readonly)
Returns the value of attribute ins.
133 134 135 |
# File 'lib/libgems/user_interaction.rb', line 133 def ins @ins end |
#outs ⇒ Object (readonly)
Returns the value of attribute outs.
133 134 135 |
# File 'lib/libgems/user_interaction.rb', line 133 def outs @outs end |
Instance Method Details
#alert(statement, question = nil) ⇒ Object
Display an informational alert. Will ask question
if it is not nil.
275 276 277 278 |
# File 'lib/libgems/user_interaction.rb', line 275 def alert(statement, question=nil) @outs.puts "INFO: #{statement}" ask(question) if question end |
#alert_error(statement, question = nil) ⇒ Object
Display an error message in a location expected to get error messages. Will ask question
if it is not nil.
293 294 295 296 |
# File 'lib/libgems/user_interaction.rb', line 293 def alert_error(statement, question=nil) @errs.puts "ERROR: #{statement}" ask(question) if question end |
#alert_warning(statement, question = nil) ⇒ Object
Display a warning in a location expected to get error messages. Will ask question
if it is not nil.
284 285 286 287 |
# File 'lib/libgems/user_interaction.rb', line 284 def alert_warning(statement, question=nil) @errs.puts "WARNING: #{statement}" ask(question) if question end |
#ask(question) ⇒ Object
Ask a question. Returns an answer if connected to a tty, nil otherwise.
210 211 212 213 214 215 216 217 218 219 |
# File 'lib/libgems/user_interaction.rb', line 210 def ask(question) return nil if not @ins.tty? @outs.print(question + " ") @outs.flush result = @ins.gets result.chomp! if result result end |
#ask_for_password(question) ⇒ Object
Ask for a password. Does not echo response to terminal.
224 225 226 227 228 229 230 231 |
# File 'lib/libgems/user_interaction.rb', line 224 def ask_for_password(question) return nil if not @ins.tty? @outs.print(question + " ") @outs.flush LibGems.win_platform? ? ask_for_password_on_windows : ask_for_password_on_unix end |
#ask_for_password_on_unix ⇒ Object
Asks for a password that works on unix
257 258 259 260 261 262 263 |
# File 'lib/libgems/user_interaction.rb', line 257 def ask_for_password_on_unix system "stty -echo" password = @ins.gets password.chomp! if password system "stty echo" password end |
#ask_for_password_on_windows ⇒ Object
Asks for a password that works on windows. Ripped from the Heroku gem.
236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 |
# File 'lib/libgems/user_interaction.rb', line 236 def ask_for_password_on_windows require "Win32API" char = nil password = '' while char = Win32API.new("crtdll", "_getch", [ ], "L").Call do break if char == 10 || char == 13 # received carriage return or newline if char == 127 || char == 8 # backspace and delete password.slice!(-1, 1) else password << char.chr end end puts password end |
#ask_yes_no(question, default = nil) ⇒ Object
Ask a question. Returns a true for yes, false for no. If not connected to a tty, raises an exception if default is nil, otherwise returns default.
169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 |
# File 'lib/libgems/user_interaction.rb', line 169 def ask_yes_no(question, default=nil) unless @ins.tty? then if default.nil? then raise LibGems::OperationNotSupportedError, "Not connected to a tty and no default specified" else return default end end qstr = case default when nil 'yn' when true 'Yn' else 'yN' end result = nil while result.nil? result = ask("#{question} [#{qstr}]") result = case result when /^[Yy].*/ true when /^[Nn].*/ false when /^$/ default else nil end end return result end |
#choose_from_list(question, list) ⇒ Object
Choose from a list of options. question
is a prompt displayed above the list. list
is a list of option strings. Returns the pair [option_name, option_index].
146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 |
# File 'lib/libgems/user_interaction.rb', line 146 def choose_from_list(question, list) @outs.puts question list.each_with_index do |item, index| @outs.puts " #{index+1}. #{item}" end @outs.print "> " @outs.flush result = @ins.gets return nil, nil unless result result = result.strip.to_i - 1 return list[result], result end |
#debug(statement) ⇒ Object
Display a debug message on the same location as error messages.
301 302 303 |
# File 'lib/libgems/user_interaction.rb', line 301 def debug(statement) @errs.puts statement end |
#download_reporter(*args) ⇒ Object
Return a download reporter object chosen from the current verbosity
418 419 420 421 422 423 424 425 |
# File 'lib/libgems/user_interaction.rb', line 418 def download_reporter(*args) case LibGems.configuration.verbose when nil, false SilentDownloadReporter.new(@outs, *args) else VerboseDownloadReporter.new(@outs, *args) end end |
#progress_reporter(*args) ⇒ Object
Return a progress reporter object chosen from the current verbosity.
316 317 318 319 320 321 322 323 324 325 |
# File 'lib/libgems/user_interaction.rb', line 316 def progress_reporter(*args) case LibGems.configuration.verbose when nil, false SilentProgressReporter.new(@outs, *args) when true SimpleProgressReporter.new(@outs, *args) else VerboseProgressReporter.new(@outs, *args) end end |
#say(statement = "") ⇒ Object
Display a statement.
268 269 270 |
# File 'lib/libgems/user_interaction.rb', line 268 def say(statement="") @outs.puts statement end |
#terminate_interaction(status = 0) ⇒ Object
Terminate the application with exit code status
, running any exit handlers that might have been defined.
309 310 311 |
# File 'lib/libgems/user_interaction.rb', line 309 def terminate_interaction(status = 0) raise LibGems::SystemExitException, status end |