Class: Gem::Commands::DependencyCommand
- Inherits:
-
Gem::Command
- Object
- Gem::Command
- Gem::Commands::DependencyCommand
- Includes:
- LocalRemoteOptions, VersionOption
- Defined in:
- lib/rubygems/commands/dependency_command.rb
Instance Attribute Summary
Attributes inherited from Gem::Command
#command, #defaults, #options, #program_name, #summary
Instance Method Summary collapse
-
#arguments ⇒ Object
:nodoc:.
-
#defaults_str ⇒ Object
:nodoc:.
-
#description ⇒ Object
:nodoc:.
-
#display_pipe(specs) ⇒ Object
:nodoc:.
-
#display_readable(specs, reverse) ⇒ Object
:nodoc:.
-
#ensure_local_only_reverse_dependencies ⇒ Object
:nodoc:.
-
#ensure_specs(specs) ⇒ Object
:nodoc:.
- #execute ⇒ Object
-
#fetch_remote_specs(dependency) ⇒ Object
:nodoc:.
-
#fetch_specs(dependency) ⇒ Object
:nodoc:.
-
#find_reverse_dependencies(spec) ⇒ Object
Returns an Array of [specification, dep] that are satisfied by
spec
. -
#gem_dependency(args, version, prerelease) ⇒ Object
:nodoc:.
-
#initialize ⇒ DependencyCommand
constructor
A new instance of DependencyCommand.
-
#print_dependencies(spec, level = 0) ⇒ Object
:nodoc:.
-
#remote_specs(dependency) ⇒ Object
:nodoc:.
-
#reverse_dependencies(specs) ⇒ Object
:nodoc:.
-
#usage ⇒ Object
:nodoc:.
Methods included from VersionOption
#add_platform_option, #add_prerelease_option, #add_version_option
Methods included from LocalRemoteOptions
#accept_uri_http, #add_bulk_threshold_option, #add_clear_sources_option, #add_local_remote_options, #add_proxy_option, #add_source_option, #add_update_sources_option, #both?, #local?, #remote?
Methods inherited from Gem::Command
add_common_option, #add_extra_args, #add_option, add_specific_extra_args, #begins?, build_args, build_args=, common_options, extra_args, extra_args=, #get_all_gem_names, #get_all_gem_names_and_versions, #get_one_gem_name, #get_one_optional_argument, #handle_options, #handles?, #invoke, #invoke_with_build_args, #merge_options, #remove_option, #show_help, #show_lookup_failure, specific_extra_args, specific_extra_args_hash, #when_invoked
Methods included from UserInteraction
#alert, #alert_error, #alert_warning, #ask, #ask_for_password, #ask_yes_no, #choose_from_list, #say, #terminate_interaction, #verbose
Methods included from DefaultUserInteraction
ui, #ui, ui=, #ui=, use_ui, #use_ui
Constructor Details
#initialize ⇒ DependencyCommand
Returns a new instance of DependencyCommand.
10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
# File 'lib/rubygems/commands/dependency_command.rb', line 10 def initialize super 'dependency', 'Show the dependencies of an installed gem', :version => Gem::Requirement.default, :domain => :local add_version_option add_platform_option add_prerelease_option add_option('-R', '--[no-]reverse-dependencies', 'Include reverse dependencies in the output') do |value, | [:reverse_dependencies] = value end add_option('-p', '--pipe', "Pipe Format (name --version ver)") do |value, | [:pipe_format] = value end end |
Instance Method Details
#arguments ⇒ Object
:nodoc:
33 34 35 |
# File 'lib/rubygems/commands/dependency_command.rb', line 33 def arguments # :nodoc: "REGEXP show dependencies for gems whose names start with REGEXP" end |
#defaults_str ⇒ Object
:nodoc:
37 38 39 |
# File 'lib/rubygems/commands/dependency_command.rb', line 37 def defaults_str # :nodoc: "--local --version '#{Gem::Requirement.default}' --no-reverse-dependencies" end |
#description ⇒ Object
:nodoc:
41 42 43 44 45 46 47 48 49 50 |
# File 'lib/rubygems/commands/dependency_command.rb', line 41 def description # :nodoc: <<-EOF The dependency commands lists which other gems a given gem depends on. For local gems only the reverse dependencies can be shown (which gems depend on the named gem). The dependency list can be displayed in a format suitable for piping for use with other commands. EOF end |
#display_pipe(specs) ⇒ Object
:nodoc:
94 95 96 97 98 99 100 101 102 |
# File 'lib/rubygems/commands/dependency_command.rb', line 94 def display_pipe specs # :nodoc: specs.each do |spec| unless spec.dependencies.empty? then spec.dependencies.sort_by { |dep| dep.name }.each do |dep| say "#{dep.name} --version '#{dep.requirement}'" end end end end |
#display_readable(specs, reverse) ⇒ Object
:nodoc:
104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 |
# File 'lib/rubygems/commands/dependency_command.rb', line 104 def display_readable specs, reverse # :nodoc: response = '' specs.each do |spec| response << print_dependencies(spec) unless reverse[spec.full_name].empty? then response << " Used by\n" reverse[spec.full_name].each do |sp, dep| response << " #{sp} (#{dep})\n" end end response << "\n" end say response end |
#ensure_local_only_reverse_dependencies ⇒ Object
:nodoc:
138 139 140 141 142 143 |
# File 'lib/rubygems/commands/dependency_command.rb', line 138 def ensure_local_only_reverse_dependencies # :nodoc: if [:reverse_dependencies] and remote? and not local? then alert_error 'Only reverse dependencies for local gems are supported.' terminate_interaction 1 end end |
#ensure_specs(specs) ⇒ Object
:nodoc:
145 146 147 148 149 150 151 152 153 |
# File 'lib/rubygems/commands/dependency_command.rb', line 145 def ensure_specs specs # :nodoc: return unless specs.empty? patterns = [:args].join ',' say "No gems found matching #{patterns} (#{[:version]})" if Gem.configuration.verbose terminate_interaction 1 end |
#execute ⇒ Object
121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 |
# File 'lib/rubygems/commands/dependency_command.rb', line 121 def execute ensure_local_only_reverse_dependencies dependency = gem_dependency [:args], [:version], [:prerelease] specs = fetch_specs dependency reverse = reverse_dependencies specs if [:pipe_format] then display_pipe specs else display_readable specs, reverse end end |
#fetch_remote_specs(dependency) ⇒ Object
:nodoc:
56 57 58 59 60 61 62 |
# File 'lib/rubygems/commands/dependency_command.rb', line 56 def fetch_remote_specs dependency # :nodoc: fetcher = Gem::SpecFetcher.fetcher ss, = fetcher.spec_for_dependency dependency ss.map { |spec, _| spec } end |
#fetch_specs(dependency) ⇒ Object
:nodoc:
64 65 66 67 68 69 70 71 72 73 |
# File 'lib/rubygems/commands/dependency_command.rb', line 64 def fetch_specs dependency # :nodoc: specs = [] specs.concat dependency.matching_specs if local? specs.concat fetch_remote_specs dependency if remote? ensure_specs specs specs.uniq.sort end |
#find_reverse_dependencies(spec) ⇒ Object
Returns an Array of [specification, dep] that are satisfied by spec
.
189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 |
# File 'lib/rubygems/commands/dependency_command.rb', line 189 def find_reverse_dependencies spec # :nodoc: result = [] Gem::Specification.each do |sp| sp.dependencies.each do |dep| dep = Gem::Dependency.new(*dep) unless Gem::Dependency === dep if spec.name == dep.name and dep.requirement.satisfied_by?(spec.version) then result << [sp.full_name, dep] end end end result end |
#gem_dependency(args, version, prerelease) ⇒ Object
:nodoc:
75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 |
# File 'lib/rubygems/commands/dependency_command.rb', line 75 def gem_dependency args, version, prerelease # :nodoc: args << '' if args.empty? pattern = if args.length == 1 and args.first =~ /\A\/(.*)\/(i)?\z/m then flags = $2 ? Regexp::IGNORECASE : nil Regexp.new $1, flags else /\A#{Regexp.union(*args)}/ end dependency = Gem::Deprecate.skip_during { Gem::Dependency.new pattern, version } dependency.prerelease = prerelease dependency end |
#print_dependencies(spec, level = 0) ⇒ Object
:nodoc:
155 156 157 158 159 160 161 162 163 164 |
# File 'lib/rubygems/commands/dependency_command.rb', line 155 def print_dependencies(spec, level = 0) # :nodoc: response = '' response << ' ' * level + "Gem #{spec.full_name}\n" unless spec.dependencies.empty? then spec.dependencies.sort_by { |dep| dep.name }.each do |dep| response << ' ' * level + " #{dep}\n" end end response end |
#remote_specs(dependency) ⇒ Object
:nodoc:
166 167 168 169 170 171 172 |
# File 'lib/rubygems/commands/dependency_command.rb', line 166 def remote_specs dependency # :nodoc: fetcher = Gem::SpecFetcher.fetcher ss, _ = fetcher.spec_for_dependency dependency ss.map { |s,o| s } end |
#reverse_dependencies(specs) ⇒ Object
:nodoc:
174 175 176 177 178 179 180 181 182 183 184 |
# File 'lib/rubygems/commands/dependency_command.rb', line 174 def reverse_dependencies specs # :nodoc: reverse = Hash.new { |h, k| h[k] = [] } return reverse unless [:reverse_dependencies] specs.each do |spec| reverse[spec.full_name] = find_reverse_dependencies spec end reverse end |
#usage ⇒ Object
:nodoc:
52 53 54 |
# File 'lib/rubygems/commands/dependency_command.rb', line 52 def usage # :nodoc: "#{program_name} REGEXP" end |