@ai-ecoverse/wasix-ruby 3.4.11-1

package/lib/ruby/3.4.11/rubygems/command_manager.rb

@@ -0,0 +1,255 @@
+# 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

package/lib/ruby/3.4.11/rubygems/commands/build_command.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+require_relative "../command"
+require_relative "../gemspec_helpers"
+require_relative "../package"
+require_relative "../version_option"
+
+class Gem::Commands::BuildCommand < Gem::Command
+  include Gem::VersionOption
+  include Gem::GemspecHelpers
+
+  def initialize
+    super "build", "Build a gem from a gemspec"
+
+    add_platform_option
+
+    add_option "--force", "skip validation of the spec" do |_value, options|
+      options[:force] = true
+    end
+
+    add_option "--strict", "consider warnings as errors when validating the spec" do |_value, options|
+      options[:strict] = true
+    end
+
+    add_option "-o", "--output FILE", "output gem with the given filename" do |value, options|
+      options[:output] = value
+    end
+
+    add_option "-C PATH", "Run as if gem build was started in <PATH> instead of the current working directory." do |value, options|
+      options[:build_path] = value
+    end
+    deprecate_option "-C",
+                     version: "4.0",
+                     extra_msg: "-C is a global flag now. Use `gem -C PATH build GEMSPEC_FILE [options]` instead"
+  end
+
+  def arguments # :nodoc:
+    "GEMSPEC_FILE  gemspec file name to build a gem for"
+  end
+
+  def description # :nodoc:
+    <<-EOF
+The build command allows you to create a gem from a ruby gemspec.
+
+The best way to build a gem is to use a Rakefile and the Gem::PackageTask
+which ships with RubyGems.
+
+The gemspec can either be created by hand or extracted from an existing gem
+with gem spec:
+
+  $ gem unpack my_gem-1.0.gem
+  Unpacked gem: '.../my_gem-1.0'
+  $ gem spec my_gem-1.0.gem --ruby > my_gem-1.0/my_gem-1.0.gemspec
+  $ cd my_gem-1.0
+  [edit gem contents]
+  $ gem build my_gem-1.0.gemspec
+
+Gems can be saved to a specified filename with the output option:
+
+  $ gem build my_gem-1.0.gemspec --output=release.gem
+
+    EOF
+  end
+
+  def usage # :nodoc:
+    "#{program_name} GEMSPEC_FILE"
+  end
+
+  def execute
+    if build_path = options[:build_path]
+      Dir.chdir(build_path) { build_gem }
+      return
+    end
+
+    build_gem
+  end
+
+  private
+
+  def build_gem
+    gemspec = resolve_gem_name
+
+    if gemspec
+      build_package(gemspec)
+    else
+      alert_error error_message
+      terminate_interaction(1)
+    end
+  end
+
+  def build_package(gemspec)
+    spec = Gem::Specification.load(gemspec)
+    if spec
+      Gem::Package.build(
+        spec,
+        options[:force],
+        options[:strict],
+        options[:output]
+      )
+    else
+      alert_error "Error loading gemspec. Aborting."
+      terminate_interaction 1
+    end
+  end
+
+  def resolve_gem_name
+    return find_gemspec unless gem_name
+
+    if File.exist?(gem_name)
+      gem_name
+    else
+      find_gemspec("#{gem_name}.gemspec") || find_gemspec(gem_name)
+    end
+  end
+
+  def error_message
+    if gem_name
+      "Couldn't find a gemspec file matching '#{gem_name}' in #{Dir.pwd}"
+    else
+      "Couldn't find a gemspec file in #{Dir.pwd}"
+    end
+  end
+
+  def gem_name
+    get_one_optional_argument
+  end
+end

package/lib/ruby/3.4.11/rubygems/commands/cert_command.rb

@@ -0,0 +1,325 @@
+# frozen_string_literal: true
+
+require_relative "../command"
+require_relative "../security"
+
+class Gem::Commands::CertCommand < Gem::Command
+  def initialize
+    super "cert", "Manage RubyGems certificates and signing settings",
+          add: [], remove: [], list: [], build: [], sign: []
+
+    add_option("-a", "--add CERT",
+               "Add a trusted certificate.") do |cert_file, options|
+      options[:add] << open_cert(cert_file)
+    end
+
+    add_option("-l", "--list [FILTER]",
+               "List trusted certificates where the",
+               "subject contains FILTER") do |filter, options|
+      filter ||= ""
+
+      options[:list] << filter
+    end
+
+    add_option("-r", "--remove FILTER",
+               "Remove trusted certificates where the",
+               "subject contains FILTER") do |filter, options|
+      options[:remove] << filter
+    end
+
+    add_option("-b", "--build EMAIL_ADDR",
+               "Build private key and self-signed",
+               "certificate for EMAIL_ADDR") do |email_address, options|
+      options[:build] << email_address
+    end
+
+    add_option("-C", "--certificate CERT",
+               "Signing certificate for --sign") do |cert_file, options|
+      options[:issuer_cert] = open_cert(cert_file)
+      options[:issuer_cert_file] = cert_file
+    end
+
+    add_option("-K", "--private-key KEY",
+               "Key for --sign or --build") do |key_file, options|
+      options[:key] = open_private_key(key_file)
+    end
+
+    add_option("-A", "--key-algorithm ALGORITHM",
+               "Select which key algorithm to use for --build") do |algorithm, options|
+      options[:key_algorithm] = algorithm
+    end
+
+    add_option("-s", "--sign CERT",
+               "Signs CERT with the key from -K",
+               "and the certificate from -C") do |cert_file, options|
+      raise Gem::OptionParser::InvalidArgument, "#{cert_file}: does not exist" unless
+        File.file? cert_file
+
+      options[:sign] << cert_file
+    end
+
+    add_option("-d", "--days NUMBER_OF_DAYS",
+               "Days before the certificate expires") do |days, options|
+      options[:expiration_length_days] = days.to_i
+    end
+
+    add_option("-R", "--re-sign",
+               "Re-signs the certificate from -C with the key from -K") do |resign, options|
+      options[:resign] = resign
+    end
+  end
+
+  def add_certificate(certificate) # :nodoc:
+    Gem::Security.trust_dir.trust_cert certificate
+
+    say "Added '#{certificate.subject}'"
+  end
+
+  def check_openssl
+    return if Gem::HAVE_OPENSSL
+
+    alert_error "OpenSSL library is required for the cert command"
+    terminate_interaction 1
+  end
+
+  def open_cert(certificate_file)
+    check_openssl
+    OpenSSL::X509::Certificate.new File.read certificate_file
+  rescue Errno::ENOENT
+    raise Gem::OptionParser::InvalidArgument, "#{certificate_file}: does not exist"
+  rescue OpenSSL::X509::CertificateError
+    raise Gem::OptionParser::InvalidArgument,
+      "#{certificate_file}: invalid X509 certificate"
+  end
+
+  def open_private_key(key_file)
+    check_openssl
+    passphrase = ENV["GEM_PRIVATE_KEY_PASSPHRASE"]
+    key = OpenSSL::PKey.read File.read(key_file), passphrase
+    raise Gem::OptionParser::InvalidArgument,
+      "#{key_file}: private key not found" unless key.private?
+    key
+  rescue Errno::ENOENT
+    raise Gem::OptionParser::InvalidArgument, "#{key_file}: does not exist"
+  rescue OpenSSL::PKey::PKeyError, ArgumentError
+    raise Gem::OptionParser::InvalidArgument, "#{key_file}: invalid RSA, DSA, or EC key"
+  end
+
+  def execute
+    check_openssl
+
+    options[:add].each do |certificate|
+      add_certificate certificate
+    end
+
+    options[:remove].each do |filter|
+      remove_certificates_matching filter
+    end
+
+    options[:list].each do |filter|
+      list_certificates_matching filter
+    end
+
+    options[:build].each do |email|
+      build email
+    end
+
+    if options[:resign]
+      re_sign_cert(
+        options[:issuer_cert],
+        options[:issuer_cert_file],
+        options[:key]
+      )
+    end
+
+    sign_certificates unless options[:sign].empty?
+  end
+
+  def build(email)
+    unless valid_email?(email)
+      raise Gem::CommandLineError, "Invalid email address #{email}"
+    end
+
+    key, key_path = build_key
+    cert_path = build_cert email, key
+
+    say "Certificate: #{cert_path}"
+
+    if key_path
+      say "Private Key: #{key_path}"
+      say "Don't forget to move the key file to somewhere private!"
+    end
+  end
+
+  def build_cert(email, key) # :nodoc:
+    expiration_length_days = options[:expiration_length_days] ||
+                             Gem.configuration.cert_expiration_length_days
+
+    cert = Gem::Security.create_cert_email(
+      email,
+      key,
+      (Gem::Security::ONE_DAY * expiration_length_days)
+    )
+
+    Gem::Security.write cert, "gem-public_cert.pem"
+  end
+
+  def build_key # :nodoc:
+    return options[:key] if options[:key]
+
+    passphrase = ask_for_password "Passphrase for your Private Key:"
+    say "\n"
+
+    passphrase_confirmation = ask_for_password "Please repeat the passphrase for your Private Key:"
+    say "\n"
+
+    raise Gem::CommandLineError,
+          "Passphrase and passphrase confirmation don't match" unless passphrase == passphrase_confirmation
+
+    algorithm = options[:key_algorithm] || Gem::Security::DEFAULT_KEY_ALGORITHM
+    key = Gem::Security.create_key(algorithm)
+    key_path = Gem::Security.write key, "gem-private_key.pem", 0o600, passphrase
+
+    [key, key_path]
+  end
+
+  def certificates_matching(filter)
+    return enum_for __method__, filter unless block_given?
+
+    Gem::Security.trusted_certificates.select do |certificate, _|
+      subject = certificate.subject.to_s
+      subject.downcase.index filter
+    end.sort_by do |certificate, _|
+      certificate.subject.to_a.map {|name, data,| [name, data] }
+    end.each do |certificate, path|
+      yield certificate, path
+    end
+  end
+
+  def description # :nodoc:
+    <<-EOF
+The cert command manages signing keys and certificates for creating signed
+gems.  Your signing certificate and private key are typically stored in
+~/.gem/gem-public_cert.pem and ~/.gem/gem-private_key.pem respectively.
+
+To build a certificate for signing gems:
+
+  gem cert --build you@example
+
+If you already have an RSA key, or are creating a new certificate for an
+existing key:
+
+  gem cert --build you@example --private-key /path/to/key.pem
+
+If you wish to trust a certificate you can add it to the trust list with:
+
+  gem cert --add /path/to/cert.pem
+
+You can list trusted certificates with:
+
+  gem cert --list
+
+or:
+
+  gem cert --list cert_subject_substring
+
+If you wish to remove a previously trusted certificate:
+
+  gem cert --remove cert_subject_substring
+
+To sign another gem author's certificate:
+
+  gem cert --sign /path/to/other_cert.pem
+
+For further reading on signing gems see `ri Gem::Security`.
+    EOF
+  end
+
+  def list_certificates_matching(filter) # :nodoc:
+    certificates_matching filter do |certificate, _|
+      # this could probably be formatted more gracefully
+      say certificate.subject.to_s
+    end
+  end
+
+  def load_default_cert
+    cert_file = File.join Gem.default_cert_path
+    cert = File.read cert_file
+    options[:issuer_cert] = OpenSSL::X509::Certificate.new cert
+  rescue Errno::ENOENT
+    alert_error \
+      "--certificate not specified and ~/.gem/gem-public_cert.pem does not exist"
+
+    terminate_interaction 1
+  rescue OpenSSL::X509::CertificateError
+    alert_error \
+      "--certificate not specified and ~/.gem/gem-public_cert.pem is not valid"
+
+    terminate_interaction 1
+  end
+
+  def load_default_key
+    key_file = File.join Gem.default_key_path
+    key = File.read key_file
+    passphrase = ENV["GEM_PRIVATE_KEY_PASSPHRASE"]
+    options[:key] = OpenSSL::PKey.read key, passphrase
+  rescue Errno::ENOENT
+    alert_error \
+      "--private-key not specified and ~/.gem/gem-private_key.pem does not exist"
+
+    terminate_interaction 1
+  rescue OpenSSL::PKey::PKeyError
+    alert_error \
+      "--private-key not specified and ~/.gem/gem-private_key.pem is not valid"
+
+    terminate_interaction 1
+  end
+
+  def load_defaults # :nodoc:
+    load_default_cert unless options[:issuer_cert]
+    load_default_key  unless options[:key]
+  end
+
+  def remove_certificates_matching(filter) # :nodoc:
+    certificates_matching filter do |certificate, path|
+      FileUtils.rm path
+      say "Removed '#{certificate.subject}'"
+    end
+  end
+
+  def sign(cert_file)
+    cert = File.read cert_file
+    cert = OpenSSL::X509::Certificate.new cert
+
+    permissions = File.stat(cert_file).mode & 0o777
+
+    issuer_cert = options[:issuer_cert]
+    issuer_key = options[:key]
+
+    cert = Gem::Security.sign cert, issuer_key, issuer_cert
+
+    Gem::Security.write cert, cert_file, permissions
+  end
+
+  def sign_certificates # :nodoc:
+    load_defaults unless options[:sign].empty?
+
+    options[:sign].each do |cert_file|
+      sign cert_file
+    end
+  end
+
+  def re_sign_cert(cert, cert_path, private_key)
+    Gem::Security::Signer.re_sign_cert(cert, cert_path, private_key) do |expired_cert_path, new_expired_cert_path|
+      alert("Your certificate #{expired_cert_path} has been re-signed")
+      alert("Your expired certificate will be located at: #{new_expired_cert_path}")
+    end
+  end
+
+  private
+
+  def valid_email?(email)
+    # It's simple, but is all we need
+    email =~ /\A.+@.+\z/
+  end
+end