123456789_123456789_123456789_123456789_123456789_

Module: Gem::Resolver::Molinillo::UI

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
Defined in: lib/rubygems/resolver/molinillo/lib/molinillo/modules/ui.rb

Overview

Conveys information about the resolution process to a user.

Instance Attribute Summary

Instance Method Summary

Instance Attribute Details

#debug?Boolean (readonly)

Whether or not debug messages should be printed. By default, whether or not the MOLINILLO_DEBUG environment variable is set.

[ GitHub ]

  
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/ui.rb', line 60

def debug?
  @debug_mode ||= ENV['MOLINILLO_DEBUG']
end

Instance Method Details

#after_resolutionvoid

This method returns an undefined value.

Called after resolution ends (either successfully or with an error). By default, prints a newline.

[ GitHub ]

  
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/ui.rb', line 39

def after_resolution
  output.puts
end

#before_resolutionvoid

This method returns an undefined value.

Called before resolution begins.

[ GitHub ]

  
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/ui.rb', line 31

def before_resolution
  output.print 'Resolving dependencies...'
end

#debug(depth = 0) ⇒ void (readonly)

This method returns an undefined value.

Conveys debug information to the user.

Parameters:

  • depth (Integer) (defaults to: 0)

    the current depth of the resolution process.

[ GitHub ]

  
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/ui.rb', line 47

def debug(depth = 0)
  if debug?
    debug_info = yield
    debug_info = debug_info.inspect unless debug_info.is_a?(String)
    output.puts debug_info.split("\n").map { |s| '  ' * depth + s }
  end
end

#indicate_progressvoid

This method returns an undefined value.

Called roughly every #progress_rate, this method should convey progress to the user.

[ GitHub ]

  
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/ui.rb', line 16

def indicate_progress
  output.print '.' unless debug?
end

#outputIO

The IO object that should be used to print output. STDOUT, by default.

[ GitHub ]

  
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/ui.rb', line 8

def output
  STDOUT
end

#progress_rateFloat

How often progress should be conveyed to the user via #indicate_progress, in seconds. A third of a second, by default.

[ GitHub ]

  
# File 'lib/rubygems/resolver/molinillo/lib/molinillo/modules/ui.rb', line 24

def progress_rate
  0.33
end