module Bundler::Molinillo::UI
Conveys information about the resolution process to a user.
Public Instance Methods
Called after resolution ends (either successfully or with an error). By default, prints a newline.
@return [void]
# File bundler/vendor/molinillo/lib/molinillo/modules/ui.rb, line 40 def after_resolution output.puts end
Called before resolution begins.
@return [void]
# File bundler/vendor/molinillo/lib/molinillo/modules/ui.rb, line 32 def before_resolution output.print 'Resolving dependencies...' end
Conveys debug information to the user.
@param [Integer] depth the current depth of the resolution process. @return [void]
# File bundler/vendor/molinillo/lib/molinillo/modules/ui.rb, line 48 def debug(depth = 0) if debug? debug_info = yield debug_info = debug_info.inspect unless debug_info.is_a?(String) debug_info = debug_info.split("\n").map { |s| ":#{depth.to_s.rjust 4}: #{s}" } output.puts debug_info end end
Whether or not debug messages should be printed. By default, whether or not the ‘MOLINILLO_DEBUG` environment variable is set.
@return [Boolean]
# File bundler/vendor/molinillo/lib/molinillo/modules/ui.rb, line 62 def debug? return @debug_mode if defined?(@debug_mode) @debug_mode = ENV['MOLINILLO_DEBUG'] end
Called roughly every {#progress_rate}, this method should convey progress to the user.
@return [void]
# File bundler/vendor/molinillo/lib/molinillo/modules/ui.rb, line 17 def indicate_progress output.print '.' unless debug? end
The {IO} object that should be used to print output. ‘STDOUT`, by default.
@return [IO]
# File bundler/vendor/molinillo/lib/molinillo/modules/ui.rb, line 9 def output STDOUT end
How often progress should be conveyed to the user via {#indicate_progress}, in seconds. A third of a second, by default.
@return [Float]
# File bundler/vendor/molinillo/lib/molinillo/modules/ui.rb, line 25 def progress_rate 0.33 end