class Gem::CommandManager
Der Befehlsmanager registriert und installiert alle einzelnen Unterbefehle, die vom Gem-Befehl unterstützt werden.
Zusätzliche Befehle können bereitgestellt werden, indem eine Datei rubygems_plugin.rb in einem installierten Gem geschrieben wird. Sie sollten Ihren Befehl gegen die Instanz von Gem::CommandManager registrieren, wie hier gezeigt
# file rubygems_plugin.rb require 'rubygems/command_manager' Gem::CommandManager.instance.register_command :edit
Sie sollten die Implementierung Ihres Befehls in rubygems/commands ablegen.
# file rubygems/commands/edit_command.rb class Gem::Commands::EditCommand < Gem::Command # ... end
Siehe Gem::Command für Anweisungen zum Schreiben von Gem-Befehlen.
Constants
- ALIAS_COMMANDS
Öffentliche Klassenmethoden
Source
# File lib/rubygems/command_manager.rb, line 86 def self.instance @instance ||= new end
Gibt die maßgebliche Instanz des Befehlsmanagers zurück.
Source
# File lib/rubygems/command_manager.rb, line 108 def initialize require_relative "vendored_timeout" @commands = {} BUILTIN_COMMANDS.each do |name| register_command name end end
Registriert alle vom Gem-Befehl unterstützten Unterbefehle.
Source
# File lib/rubygems/command_manager.rb, line 101 def self.reset @instance = nil end
Setzt die maßgebliche Instanz des Befehlsmanagers zurück.
Öffentliche Instanzmethoden
Source
# File lib/rubygems/command_manager.rb, line 134 def [](command_name) command_name = command_name.intern return nil if @commands[command_name].nil? @commands[command_name] ||= load_and_instantiate(command_name) end
Gibt eine Command-Instanz für command_name zurück.
Source
# File lib/rubygems/command_manager.rb, line 143 def command_names @commands.keys.collect(&:to_s).sort end
Gibt eine sortierte Liste aller Befehlsnamen als Strings zurück.
Source
# File lib/rubygems/command_manager.rb, line 212 def find_alias_command(cmd_name) alias_name = ALIAS_COMMANDS[cmd_name] alias_name ? alias_name : cmd_name end
Source
# File lib/rubygems/command_manager.rb, line 197 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
Source
# File lib/rubygems/command_manager.rb, line 217 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
Source
# File lib/rubygems/command_manager.rb, line 94 def instance self end
Gibt self zurück. Ermöglicht einer CommandManager-Instanz, anstelle der Klasse selbst zu stehen.
Source
# File lib/rubygems/command_manager.rb, line 167 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
Source
# File lib/rubygems/command_manager.rb, line 120 def register_command(command, obj = false) @commands[command] = obj end
Registriert das Symbol command als Gem-Befehl.
Source
# File lib/rubygems/command_manager.rb, line 150 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
Führt den Befehl aus, der durch args angegeben wird.
Source
# File lib/rubygems/command_manager.rb, line 127 def unregister_command(command) @commands.delete command end
Hebt die Registrierung des Symbol command als Gem-Befehl auf.
Private Instanzmethoden
Source
# File lib/rubygems/command_manager.rb, line 247 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
Source
# File lib/rubygems/command_manager.rb, line 229 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