Class: Gem::CommandManager
- Inherits:
-
Object
- Object
- Gem::CommandManager
- Includes:
- UserInteraction
- Defined in:
- lib/rubygems/command_manager.rb
Overview
The command manager registers and installs all the individual sub-commands supported by the gem command.
Extra commands can be provided by writing a rubygems_plugin.rb file in an installed gem. You should register your command against the Gem::CommandManager instance, like this:
# file rubygems_plugin.rb
require 'rubygems/command_manager'
Gem::CommandManager.instance.register_command :edit
You should put the implementation of your command in rubygems/commands.
# file rubygems/commands/edit_command.rb
class Gem::Commands::EditCommand < Gem::Command
# ...
end
See Gem::Command for instructions on writing gem commands.
Constant Summary collapse
- BUILTIN_COMMANDS =
:nodoc:
[ # :nodoc: :build, :cert, :check, :cleanup, :contents, :dependency, :environment, :fetch, :generate_index, :help, :install, :list, :lock, :mirror, :outdated, :owner, :pristine, :push, :query, :rdoc, :search, :server, :sources, :specification, :stale, :uninstall, :unpack, :update, :which, :yank, ]
Class Method Summary collapse
-
.instance ⇒ Object
Return the authoritative instance of the command manager.
-
.reset ⇒ Object
Reset the authoritative instance of the command manager.
Instance Method Summary collapse
-
#[](command_name) ⇒ Object
Returns a Command instance for
command_name
. -
#command_names ⇒ Object
Return a sorted list of all command names as strings.
- #find_command(cmd_name) ⇒ Object
- #find_command_possibilities(cmd_name) ⇒ Object
-
#initialize ⇒ CommandManager
constructor
Register all the subcommands supported by the gem command.
-
#instance ⇒ Object
Returns self.
- #process_args(args, build_args = nil) ⇒ Object
-
#register_command(command, obj = false) ⇒ Object
Register the Symbol
command
as a gem command. -
#run(args, build_args = nil) ⇒ Object
Run the command specified by
args
. -
#unregister_command(command) ⇒ Object
Unregister the Symbol
command
as a gem command.
Methods included from UserInteraction
#alert, #alert_error, #alert_warning, #ask, #ask_for_password, #ask_yes_no, #choose_from_list, #say, #terminate_interaction
Methods included from DefaultUserInteraction
ui, #ui, ui=, #ui=, use_ui, #use_ui
Constructor Details
#initialize ⇒ CommandManager
Register all the subcommands supported by the gem command.
94 95 96 97 98 99 100 101 |
# File 'lib/rubygems/command_manager.rb', line 94 def initialize require 'timeout' @commands = {} BUILTIN_COMMANDS.each do |name| register_command name end end |
Class Method Details
.instance ⇒ Object
Return the authoritative instance of the command manager.
72 73 74 |
# File 'lib/rubygems/command_manager.rb', line 72 def self.instance @command_manager ||= new end |
.reset ⇒ Object
Reset the authoritative instance of the command manager.
87 88 89 |
# File 'lib/rubygems/command_manager.rb', line 87 def self.reset @command_manager = nil end |
Instance Method Details
#[](command_name) ⇒ Object
Returns a Command instance for command_name
120 121 122 123 124 |
# File 'lib/rubygems/command_manager.rb', line 120 def [](command_name) command_name = command_name.intern return nil if @commands[command_name].nil? @commands[command_name] ||= load_and_instantiate(command_name) end |
#command_names ⇒ Object
Return a sorted list of all command names as strings.
129 130 131 |
# File 'lib/rubygems/command_manager.rb', line 129 def command_names @commands.keys.collect {|key| key.to_s}.sort end |
#find_command(cmd_name) ⇒ Object
171 172 173 174 175 176 177 178 179 180 181 182 |
# File 'lib/rubygems/command_manager.rb', line 171 def find_command(cmd_name) possibilities = find_command_possibilities cmd_name if possibilities.size > 1 then raise Gem::CommandLineError, "Ambiguous command #{cmd_name} matches [#{possibilities.join(', ')}]" elsif possibilities.empty? then raise Gem::CommandLineError, "Unknown command #{cmd_name}" end self[possibilities.first] end |
#find_command_possibilities(cmd_name) ⇒ Object
184 185 186 187 188 189 190 191 192 |
# File 'lib/rubygems/command_manager.rb', line 184 def find_command_possibilities(cmd_name) len = cmd_name.length found = command_names.select { |name| cmd_name == name[0, len] } exact = found.find { |name| name == cmd_name } exact ? [exact] : found end |
#instance ⇒ Object
Returns self. Allows a CommandManager instance to stand in for the class itself.
80 81 82 |
# File 'lib/rubygems/command_manager.rb', line 80 def instance self end |
#process_args(args, build_args = nil) ⇒ Object
148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 |
# File 'lib/rubygems/command_manager.rb', line 148 def process_args(args, build_args=nil) if args.empty? then say Gem::Command::HELP terminate_interaction 1 end case args.first when '-h', '--help' then say Gem::Command::HELP terminate_interaction 0 when '-v', '--version' then say Gem::VERSION terminate_interaction 0 when /^-/ then alert_error "Invalid option: #{args.first}. See 'gem --help'." terminate_interaction 1 else cmd_name = args.shift.downcase cmd = find_command cmd_name cmd.invoke_with_build_args args, build_args end end |
#register_command(command, obj = false) ⇒ Object
Register the Symbol command
as a gem command.
106 107 108 |
# File 'lib/rubygems/command_manager.rb', line 106 def register_command(command, obj=false) @commands[command] = obj end |
#run(args, build_args = nil) ⇒ Object
Run the command specified by args
.
136 137 138 139 140 141 142 143 144 145 146 |
# File 'lib/rubygems/command_manager.rb', line 136 def run(args, build_args=nil) process_args(args, build_args) rescue StandardError, Timeout::Error => ex alert_error "While executing gem ... (#{ex.class})\n #{ex.to_s}" ui.backtrace ex terminate_interaction(1) rescue Interrupt alert_error "Interrupted" terminate_interaction(1) end |
#unregister_command(command) ⇒ Object
Unregister the Symbol command
as a gem command.
113 114 115 |
# File 'lib/rubygems/command_manager.rb', line 113 def unregister_command(command) @commands.delete command end |