Class: Gem::Commands::ContentsCommand

# File 'lib/rubygems/commands/contents_command.rb', line 50

def defaults_str # :nodoc:
  "--no-lib-only --prefix"
end

# File 'lib/rubygems/commands/contents_command.rb', line 54

def description # :nodoc:
  <<-EOF
The contents command lists the files in an installed gem.  The listing can
be given as full file names, file names without the installed directory
prefix or only the files that are requireable.
  EOF
end

# File 'lib/rubygems/commands/contents_command.rb', line 66

def execute
  @version   = options[:version] || Gem::Requirement.default
  @spec_dirs = specification_directories
  @path_kind = path_description @spec_dirs

  names = gem_names

  names.each do |name|
    found =
      if options[:show_install_dir]
        gem_install_dir name
      else
        gem_contents name
      end

    terminate_interaction 1 unless found || names.length > 1
  end
end

# File 'lib/rubygems/commands/contents_command.rb', line 85

def files_in(spec)
  if spec.default_gem?
    files_in_default_gem spec
  else
    files_in_gem spec
  end
end

# File 'lib/rubygems/commands/contents_command.rb', line 104

def files_in_default_gem(spec)
  spec.files.filter_map do |file|
    if file.start_with?("#{spec.bindir}/")
      [RbConfig::CONFIG["bindir"], file.delete_prefix("#{spec.bindir}/")]
    else
      gem spec.name, spec.version

      require_path = spec.require_paths.find do |path|
        file.start_with?("#{path}/")
      end

      requirable_part = file.delete_prefix("#{require_path}/")

      resolve = $LOAD_PATH.resolve_feature_path(requirable_part)&.last
      next unless resolve

      [resolve.delete_suffix(requirable_part), requirable_part]
    end
  end
end

# File 'lib/rubygems/commands/contents_command.rb', line 93

def files_in_gem(spec)
  gem_path  = spec.full_gem_path
  extra     = "/{#{spec.require_paths.join ","}}" if options[:lib_only]
  glob      = "#{gem_path}#{extra}/**/*"
  prefix_re = %r{#{Regexp.escape(gem_path)}/}

  Dir[glob].map do |file|
    [gem_path, file.sub(prefix_re, "")]
  end
end

# File 'lib/rubygems/commands/contents_command.rb', line 125

def gem_contents(name)
  spec = spec_for name

  return false unless spec

  files = files_in spec

  show_files files

  true
end

# File 'lib/rubygems/commands/contents_command.rb', line 137

def gem_install_dir(name)
  spec = spec_for name

  return false unless spec

  say spec.gem_dir

  true
end

# File 'lib/rubygems/commands/contents_command.rb', line 147

def gem_names # :nodoc:
  if options[:all]
    Gem::Specification.map(&:name)
  else
    get_all_gem_names
  end
end

# File 'lib/rubygems/commands/contents_command.rb', line 155

def path_description(spec_dirs) # :nodoc:
  if spec_dirs.empty?
    "default gem paths"
  else
    "specified path"
  end
end

# File 'lib/rubygems/commands/contents_command.rb', line 163

def show_files(files)
  files.sort.each do |prefix, basename|
    absolute_path = File.join(prefix, basename)
    next if File.directory? absolute_path

    if options[:prefix]
      say absolute_path
    else
      say basename
    end
  end
end

# File 'lib/rubygems/commands/contents_command.rb', line 176

def spec_for(name)
  spec = Gem::Specification.find_all_by_name(name, @version).first

  return spec if spec

  say "Unable to find gem '#{name}' in #{@path_kind}"

  if Gem.configuration.verbose
    say "\nDirectories searched:"
    @spec_dirs.sort.each {|dir| say dir }
  end

  nil
end

# File 'lib/rubygems/commands/contents_command.rb', line 191

def specification_directories # :nodoc:
  options[:specdirs].flat_map do |i|
    [i, File.join(i, "specifications")]
  end
end

# File 'lib/rubygems/commands/contents_command.rb', line 62

def usage # :nodoc:
  "#{program_name} GEMNAME [GEMNAME ...]"
end