Na}{

File Content: `exceptions.rb`

# TODO: the documentation in here is terrible.
#
# Each exception needs a brief description and the scenarios where it is
# likely to be raised

##
# Base exception class for RubyGems.  All exception raised by RubyGems are a
# subclass of this one.
class Gem::Exception < RuntimeError

  ##
  #--
  # TODO: remove in RubyGems 3, nobody sets this

  attr_accessor :source_exception # :nodoc:

end

class Gem::CommandLineError < Gem::Exception; end

class Gem::DependencyError < Gem::Exception; end

class Gem::DependencyRemovalException < Gem::Exception; end

##
# Raised by Gem::Resolver when a Gem::Dependency::Conflict reaches the
# toplevel.  Indicates which dependencies were incompatible through #conflict
# and #conflicting_dependencies

class Gem::DependencyResolutionError < Gem::Exception

  attr_reader :conflict

  def initialize conflict
    @conflict = conflict
    a, b = conflicting_dependencies

    super "conflicting dependencies #{a} and #{b}\n#{@conflict.explanation}"
  end

  def conflicting_dependencies
    @conflict.conflicting_dependencies
  end

end

##
# Raised when attempting to uninstall a gem that isn't in GEM_HOME.

class Gem::GemNotInHomeException < Gem::Exception
  attr_accessor :spec
end

class Gem::DocumentError < Gem::Exception; end

##
# Potentially raised when a specification is validated.
class Gem::EndOfYAMLException < Gem::Exception; end

##
# Signals that a file permission error is preventing the user from
# operating on the given directory.

class Gem::FilePermissionError < Gem::Exception

  attr_reader :directory

  def initialize directory
    @directory = directory

    super "You don't have write permissions for the #{directory} directory."
  end

end

##
# Used to raise parsing and loading errors
class Gem::FormatException < Gem::Exception
  attr_accessor :file_path
end

class Gem::GemNotFoundException < Gem::Exception; end

##
# Raised by the DependencyInstaller when a specific gem cannot be found

class Gem::SpecificGemNotFoundException < Gem::GemNotFoundException

  ##
  # Creates a new SpecificGemNotFoundException for a gem with the given +name+
  # and +version+.  Any +errors+ encountered when attempting to find the gem
  # are also stored.

  def initialize(name, version, errors=nil)
    super "Could not find a valid gem '#{name}' (#{version}) locally or in a repository"

    @name = name
    @version = version
    @errors = errors
  end

  ##
  # The name of the gem that could not be found.

  attr_reader :name

  ##
  # The version of the gem that could not be found.

  attr_reader :version

  ##
  # Errors encountered attempting to find the gem.

  attr_reader :errors

end

##
# Raised by Gem::Resolver when dependencies conflict and create the
# inability to find a valid possible spec for a request.

class Gem::ImpossibleDependenciesError < Gem::Exception

  attr_reader :conflicts
  attr_reader :request

  def initialize request, conflicts
    @request   = request
    @conflicts = conflicts

    super build_message
  end

  def build_message # :nodoc:
    requester  = @request.requester
    requester  = requester ? requester.spec.full_name : 'The user'
    dependency = @request.dependency

    message = "#{requester} requires #{dependency} but it conflicted:\n"

    @conflicts.each do |_, conflict|
      message << conflict.explanation
    end

    message
  end

  def dependency
    @request.dependency
  end

end

class Gem::InstallError < Gem::Exception; end

##
# Potentially raised when a specification is validated.
class Gem::InvalidSpecificationException < Gem::Exception; end

class Gem::OperationNotSupportedError < Gem::Exception; end

##
# Signals that a remote operation cannot be conducted, probably due to not
# being connected (or just not finding host).
#--
# TODO: create a method that tests connection to the preferred gems server.
# All code dealing with remote operations will want this.  Failure in that
# method should raise this error.
class Gem::RemoteError < Gem::Exception; end

class Gem::RemoteInstallationCancelled < Gem::Exception; end

class Gem::RemoteInstallationSkipped < Gem::Exception; end

##
# Represents an error communicating via HTTP.
class Gem::RemoteSourceException < Gem::Exception; end

##
# Raised when a gem dependencies file specifies a ruby version that does not
# match the current version.

class Gem::RubyVersionMismatch < Gem::Exception; end

##
# Raised by Gem::Validator when something is not right in a gem.

class Gem::VerificationError < Gem::Exception; end

##
# Raised to indicate that a system exit should occur with the specified
# exit_code

class Gem::SystemExitException < SystemExit

  ##
  # The exit code for the process

  attr_accessor :exit_code

  ##
  # Creates a new SystemExitException with the given +exit_code+

  def initialize(exit_code)
    @exit_code = exit_code

    super "Exiting RubyGems with exit_code #{exit_code}"
  end

end

##
# Raised by Resolver when a dependency requests a gem for which
# there is no spec.

class Gem::UnsatisfiableDependencyError < Gem::Exception

  ##
  # The unsatisfiable dependency.  This is a
  # Gem::Resolver::DependencyRequest, not a Gem::Dependency

  attr_reader :dependency

  ##
  # Creates a new UnsatisfiableDependencyError for the unsatisfiable
  # Gem::Resolver::DependencyRequest +dep+

  def initialize dep, platform_mismatch=nil
    if platform_mismatch and !platform_mismatch.empty?
      plats = platform_mismatch.map { |x| x.platform.to_s }.sort.uniq
      super "Unable to resolve dependency: No match for '#{dep}' on this platform. Found: #{plats.join(', ')}"
    else
      if dep.explicit?
        super "Unable to resolve dependency: user requested '#{dep}'"
      else
        super "Unable to resolve dependency: '#{dep.request_context}' requires '#{dep}'"
      end
    end

    @dependency = dep
  end

end

##
# Backwards compatible typo'd exception class for early RubyGems 2.0.x

Gem::UnsatisfiableDepedencyError = Gem::UnsatisfiableDependencyError # :nodoc:

Name	Size	Permission
commands	---	0755
core_ext	---	0755
ext	---	0755
package	---	0755
request_set	---	0755
resolver	---	0755
security	---	0755
source	---	0755
ssl_certs	---	0755
util	---	0755
available_set.rb	3069 bytes	0644
basic_specification.rb	5790 bytes	0644
command.rb	13755 bytes	0644
command_manager.rb	4734 bytes	0644
compatibility.rb	1705 bytes	0644
config_file.rb	12526 bytes	0644
defaults.rb	3729 bytes	0644
dependency.rb	7958 bytes	0644
dependency_installer.rb	12946 bytes	0644
dependency_list.rb	5659 bytes	0644
deprecate.rb	1742 bytes	0644
doctor.rb	3109 bytes	0644
errors.rb	2479 bytes	0644
exceptions.rb	6010 bytes	0644
ext.rb	431 bytes	0644
gem_runner.rb	2004 bytes	0644
gemcutter_utilities.rb	4065 bytes	0644
indexer.rb	13343 bytes	0644
install_default_message.rb	307 bytes	0644
install_message.rb	281 bytes	0644
install_update_options.rb	5337 bytes	0644
installer.rb	21936 bytes	0644
installer_test_case.rb	4294 bytes	0644
local_remote_options.rb	3439 bytes	0644
mock_gem_ui.rb	1379 bytes	0644
name_tuple.rb	2288 bytes	0644
package.rb	14588 bytes	0644
package_task.rb	3859 bytes	0644
path_support.rb	1864 bytes	0644
platform.rb	6191 bytes	0644
psych_additions.rb	269 bytes	0644
psych_tree.rb	763 bytes	0644
rdoc.rb	7931 bytes	0644
remote_fetcher.rb	9684 bytes	0644
request.rb	7715 bytes	0644
request_set.rb	7105 bytes	0644
requirement.rb	6246 bytes	0644
resolver.rb	12756 bytes	0644
safe_yaml.rb	1135 bytes	0644
security.rb	21460 bytes	0644
server.rb	22215 bytes	0644
source.rb	5014 bytes	0644
source_list.rb	2529 bytes	0644
source_local.rb	111 bytes	0644
source_specific_file.rb	93 bytes	0644
spec_fetcher.rb	6554 bytes	0644
specification.rb	72504 bytes	0644
stub_specification.rb	3173 bytes	0644
syck_hack.rb	2138 bytes	0644
test_case.rb	36474 bytes	0644
test_utilities.rb	8566 bytes	0644
text.rb	1255 bytes	0644
uninstaller.rb	8897 bytes	0644
uri_formatter.rb	762 bytes	0644
user_interaction.rb	14742 bytes	0644
util.rb	2313 bytes	0644
validator.rb	4285 bytes	0644
version.rb	11036 bytes	0644
version_option.rb	1871 bytes	0644

File Content: exceptions.rb

File Content: `exceptions.rb`