class Gem::CommandManager

命令管理器注册并安装 gem 命令支持的所有单独子命令。

额外的命令可以通过在已安装的 gem 中编写 rubygems_plugin.rb 文件来提供。你应该像这样针对 Gem::CommandManager 实例注册你的命令

# file rubygems_plugin.rb
require 'rubygems/command_manager'

Gem::CommandManager.instance.register_command :edit

你应该将你的命令的实现放在 rubygems/commands 中。

# file rubygems/commands/edit_command.rb
class Gem::Commands::EditCommand < Gem::Command
  # ...
end

有关编写 gem 命令的说明，请参阅 Gem::Command。

常量

ALIAS_COMMANDS

公共类方法

instance ()

源代码

# File lib/rubygems/command_manager.rb, line 87
def self.instance
  @instance ||= new
end

返回命令管理器的权威实例。

new ()

源代码

# File lib/rubygems/command_manager.rb, line 109
def initialize
  require_relative "vendored_timeout"
  @commands = {}

  BUILTIN_COMMANDS.each do |name|
    register_command name
  end
end

reset ()

源代码

# File lib/rubygems/command_manager.rb, line 102
def self.reset
  @instance = nil
end

重置命令管理器的权威实例。

公共实例方法

[] (command_name)

源代码

# File lib/rubygems/command_manager.rb, line 135
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_name 的 Command 实例

command_names ()

源代码

# File lib/rubygems/command_manager.rb, line 144
def command_names
  @commands.keys.collect(&:to_s).sort
end

返回所有命令名称的排序列表，作为字符串。

find_alias_command (cmd_name)

源代码

# File lib/rubygems/command_manager.rb, line 213
def find_alias_command(cmd_name)
  alias_name = ALIAS_COMMANDS[cmd_name]
  alias_name ? alias_name : cmd_name
end

find_command (cmd_name)

源代码

# File lib/rubygems/command_manager.rb, line 198
def find_command(cmd_name)
  cmd_name = find_alias_command cmd_name

  possibilities = find_command_possibilities cmd_name

  if possibilities.size > 1
    raise Gem::CommandLineError,
          "Ambiguous command #{cmd_name} matches [#{possibilities.join(", ")}]"
  elsif possibilities.empty?
    raise Gem::UnknownCommandError.new(cmd_name)
  end

  self[possibilities.first]
end

find_command_possibilities (cmd_name)

源代码

# File lib/rubygems/command_manager.rb, line 218
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 ()

源代码

# File lib/rubygems/command_manager.rb, line 95
def instance
  self
end

返回 self。允许 CommandManager 实例代替类本身。

process_args (args, build_args=nil)

源代码

# File lib/rubygems/command_manager.rb, line 168
def process_args(args, build_args=nil)
  if args.empty?
    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 "-C" then
    args.shift
    start_point = args.shift
    if Dir.exist?(start_point)
      Dir.chdir(start_point) { invoke_command(args, build_args) }
    else
      alert_error clean_text("#{start_point} isn't a directory.")
      terminate_interaction 1
    end
  when /^-/ then
    alert_error clean_text("Invalid option: #{args.first}. See 'gem --help'.")
    terminate_interaction 1
  else
    invoke_command(args, build_args)
  end
end

register_command (command, obj=false)

源代码

# File lib/rubygems/command_manager.rb, line 121
def register_command(command, obj=false)
  @commands[command] = obj
end

将 Symbol command 注册为 gem 命令。

run (args, build_args=nil)

源代码

# File lib/rubygems/command_manager.rb, line 151
def run(args, build_args=nil)
  process_args(args, build_args)
rescue StandardError, Gem::Timeout::Error => ex
  if ex.respond_to?(:detailed_message)
    msg = ex.detailed_message(highlight: false).sub(/\A(.*?)(?: \(.+?\))/) { $1 }
  else
    msg = ex.message
  end
  alert_error clean_text("While executing gem ... (#{ex.class})\n    #{msg}")
  ui.backtrace ex

  terminate_interaction(1)
rescue Interrupt
  alert_error clean_text("Interrupted")
  terminate_interaction(1)
end

运行由 args 指定的命令。

unregister_command (command)

源代码

# File lib/rubygems/command_manager.rb, line 128
def unregister_command(command)
  @commands.delete command
end

取消注册作为 gem 命令的 Symbol command。

私有实例方法

invoke_command (args, build_args)

源代码

# File lib/rubygems/command_manager.rb, line 248
def invoke_command(args, build_args)
  cmd_name = args.shift.downcase
  cmd = find_command cmd_name
  terminate_interaction 1 unless cmd
  cmd.deprecation_warning if cmd.deprecated?
  cmd.invoke_with_build_args args, build_args
end

load_and_instantiate (command_name)

源代码

# File lib/rubygems/command_manager.rb, line 230
def load_and_instantiate(command_name)
  command_name = command_name.to_s
  const_name = command_name.capitalize.gsub(/_(.)/) { $1.upcase } << "Command"

  begin
    begin
      require "rubygems/commands/#{command_name}_command"
    rescue LoadError
      # it may have been defined from a rubygems_plugin.rb file
    end

    Gem::Commands.const_get(const_name).new
  rescue StandardError => e
    alert_error clean_text("Loading command: #{command_name} (#{e.class})\n\t#{e}")
    ui.backtrace e
  end
end