PHP 8.2.31
Preview: command_manager.rb Size: 5.64 KB
//proc/thread-self/root/opt/alt/ruby34/share/rubygems/rubygems/command_manager.rb

# frozen_string_literal: true

#--
# Copyright 2006 by Chad Fowler, Rich Kilmer, Jim Weirich and others.
# All rights reserved.
# See LICENSE.txt for permissions.
#++

require_relative "command"
require_relative "user_interaction"
require_relative "text"

##
# 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.

class Gem::CommandManager
  include Gem::Text
  include Gem::UserInteraction

  BUILTIN_COMMANDS = [ # :nodoc:
    :build,
    :cert,
    :check,
    :cleanup,
    :contents,
    :dependency,
    :environment,
    :exec,
    :fetch,
    :generate_index,
    :help,
    :info,
    :install,
    :list,
    :lock,
    :mirror,
    :open,
    :outdated,
    :owner,
    :pristine,
    :push,
    :query,
    :rdoc,
    :rebuild,
    :search,
    :server,
    :signin,
    :signout,
    :sources,
    :specification,
    :stale,
    :uninstall,
    :unpack,
    :update,
    :which,
    :yank,
  ].freeze

  ALIAS_COMMANDS = {
    "i" => "install",
    "login" => "signin",
    "logout" => "signout",
  }.freeze

  ##
  # Return the authoritative instance of the command manager.

  def self.instance
    @instance ||= new
  end

  ##
  # Returns self. Allows a CommandManager instance to stand
  # in for the class itself.

  def instance
    self
  end

  ##
  # Reset the authoritative instance of the command manager.

  def self.reset
    @instance = nil
  end

  ##
  # Register all the subcommands supported by the gem command.

  def initialize
    require_relative "vendored_timeout"
    @commands = {}

    BUILTIN_COMMANDS.each do |name|
      register_command name
    end
  end

  ##
  # Register the Symbol +command+ as a gem command.

  def register_command(command, obj=false)
    @commands[command] = obj
  end

  ##
  # Unregister the Symbol +command+ as a gem command.

  def unregister_command(command)
    @commands.delete command
  end

  ##
  # Returns a Command instance for +command_name+

  def [](command_name)
    command_name = command_name.intern
    return nil if @commands[command_name].nil?
    @commands[command_name] ||= load_and_instantiate(command_name)
  end

  ##
  # Return a sorted list of all command names as strings.

  def command_names
    @commands.keys.collect(&:to_s).sort
  end

  ##
  # Run the command specified by +args+.

  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

  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

  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

  def find_alias_command(cmd_name)
    alias_name = ALIAS_COMMANDS[cmd_name]
    alias_name ? alias_name : cmd_name
  end

  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

  private

  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

  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
end

Directory Contents

Dirs: 15 × Files: 71

Name Size Perms Modified Actions
commands DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
core_ext DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
defaults DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
ext DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
package DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
request DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
resolver DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
security DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
source DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
ssl_certs DIR
- drwxr-xr-x 2026-04-20 12:16:07
Edit Download
util DIR
- drwxr-xr-x 2026-05-14 20:42:26
Edit Download
vendor DIR
- drwxr-xr-x 2026-04-20 12:16:04
Edit Download
3.00 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
8.13 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1.96 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
3.71 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
15.80 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
5.64 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1022 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
16.31 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
7.38 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
8.45 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
9.91 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
5.55 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
5.04 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
3.13 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
4.53 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
7.13 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
498 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
11.29 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
394 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.14 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
27.74 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
771 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
349 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
323 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
6.56 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
3.59 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
2.38 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
125 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
18.83 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
3.79 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
1.77 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
8.41 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
855 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
8.50 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
660 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
9.38 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
8.70 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
11.29 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
7.13 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
9.43 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
5.96 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1.92 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1.04 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
21.69 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1.06 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
5.78 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.42 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
69.03 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
15.59 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
5.21 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
7.68 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
4.96 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
1.24 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.06 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
10.92 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
411 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
1.85 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.38 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
784 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
13.10 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.46 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
3.63 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
81 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
233 B lrw-r--r-- 2026-04-20 12:16:24
Edit Download
79 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
87 B lrw-r--r-- 2026-04-20 12:16:24
Edit Download
228 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
73 B lrw-r--r-- 2026-04-20 12:16:25
Edit Download
13.35 KB lrw-r--r-- 2026-04-20 12:16:25
Edit Download
2.17 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download
2.42 KB lrw-r--r-- 2026-04-20 12:16:24
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).