Class: Gem::Commands::FetchCommand

Inherits:
Gem::Command show all
Includes:
LocalRemoteOptions, VersionOption
Defined in:
lib/rubygems/commands/fetch_command.rb

Instance Attribute Summary

Attributes inherited from Gem::Command

#command, #defaults, #options, #program_name, #summary

Instance Method Summary collapse

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=, #check_deprecated_options, common_options, #deprecate_option, #deprecated?, 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, 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

Methods included from Text

#clean_text, #format_text, #levenshtein_distance, #min3, #truncate_text

Constructor Details

#initializeFetchCommand

Returns a new instance of FetchCommand.


10
11
12
13
14
15
16
17
18
19
20
21
# File 'lib/rubygems/commands/fetch_command.rb', line 10

def initialize
  super 'fetch', 'Download a gem and place it in the current directory'

  add_bulk_threshold_option
  add_proxy_option
  add_source_option
  add_clear_sources_option

  add_version_option
  add_platform_option
  add_prerelease_option
end

Instance Method Details

#argumentsObject

:nodoc:


23
24
25
# File 'lib/rubygems/commands/fetch_command.rb', line 23

def arguments # :nodoc:
  'GEMNAME       name of gem to download'
end

#defaults_strObject

:nodoc:


27
28
29
# File 'lib/rubygems/commands/fetch_command.rb', line 27

def defaults_str # :nodoc:
  "--version '#{Gem::Requirement.default}'"
end

#descriptionObject

:nodoc:


31
32
33
34
35
36
37
38
39
# File 'lib/rubygems/commands/fetch_command.rb', line 31

def description # :nodoc:
  <<-EOF
The fetch command fetches gem files that can be stored for later use or
unpacked to examine their contents.

See the build command help for an example of unpacking a gem, modifying it,
then repackaging it.
  EOF
end

#executeObject


45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
# File 'lib/rubygems/commands/fetch_command.rb', line 45

def execute
  version = options[:version] || Gem::Requirement.default

  platform  = Gem.platforms.last
  gem_names = get_all_gem_names

  gem_names.each do |gem_name|
    dep = Gem::Dependency.new gem_name, version
    dep.prerelease = options[:prerelease]

    specs_and_sources, errors =
      Gem::SpecFetcher.fetcher.spec_for_dependency dep

    if platform
      filtered = specs_and_sources.select {|s,| s.platform == platform }
      specs_and_sources = filtered unless filtered.empty?
    end

    spec, source = specs_and_sources.max_by {|s,| s.version }

    if spec.nil?
      show_lookup_failure gem_name, version, errors, options[:domain]
      next
    end

    source.download spec

    say "Downloaded #{spec.full_name}"
  end
end

#usageObject

:nodoc:


41
42
43
# File 'lib/rubygems/commands/fetch_command.rb', line 41

def usage # :nodoc:
  "#{program_name} GEMNAME [GEMNAME ...]"
end