Exception: Vagrant::Errors::VagrantError

Inherits:

StandardError

• Object
• StandardError
• Vagrant::Errors::VagrantError

Defined in:

lib/vagrant/errors.rb

Overview

Main superclass of any errors in Vagrant. This provides some convenience methods for setting the status code and error key. The status code is used by the vagrant executable as the error code, and the error key is used as a default message from I18n.

Direct Known Subclasses

BaseVMNotFound, BoxAlreadyExists, BoxDownloadUnknownType, BoxNotFound, BoxNotSpecified, BoxSpecifiedDoesntExist, BoxVerificationFailed, CLIMissingEnvironment, ConfigValidationFailed, DotfileIsDirectory, DownloaderFileDoesntExist, DownloaderHTTPSocketError, ForwardPortAutolistEmpty, ForwardPortBelowThreshold, ForwardPortCollision, MultiVMEnvironmentRequired, MultiVMTargetRequired, NFSHostRequired, NFSNoHostNetwork, NFSNotSupported, NetworkCollision, NetworkNotFound, NetworkNotImplemented, NoEnvironmentError, PackageIncludeMissing, PackageOutputExists, PackageRequiresDirectory, PersistDotfileExists, SSHAuthenticationFailed, SSHConnectionRefused, SSHKeyBadPermissions, SSHPortNotDetected, SSHUnavailable, SSHUnavailableWindows, VMBaseMacNotSpecified, VMFailedToBoot, VMImportFailure, VMNotCreatedError, VMNotFoundError, VMNotRunningError, VMPowerOffToPackage, VMSystemError, VagrantInterrupt, VagrantfileSyntaxError, VirtualBoxInvalidVersion, VirtualBoxNotDetected, Provisioners::Chef::ChefError, Provisioners::PuppetError, Provisioners::PuppetServerError, Systems::Base::BaseError, Systems::FreeBSD::FreeBSDError, Systems::Linux::LinuxError, Systems::Solaris::SolarisError

Constant Summary

@@used_codes =

[]

Class Method Summary

• .error_key(key = nil, namespace = nil) ⇒ Object
• .error_namespace(namespace) ⇒ Object
• .status_code(code = nil) ⇒ Object

Instance Method Summary

• #error_key ⇒ Object

  The key for the error message.

• #error_namespace ⇒ Object

  The default error namespace which is used for the error key.

• #initialize(message = nil, *args) ⇒ VagrantError constructor

  A new instance of VagrantError.

Constructor Details

#initialize(message = nil, *args) ⇒ VagrantError

Returns a new instance of VagrantError.

# File 'lib/vagrant/errors.rb', line 66

def initialize(message=nil, *args)
  message = { :_key => message } if message && !message.is_a?(Hash)
  message = { :_key => error_key, :_namespace => error_namespace }.merge(message || {})
  message = translate_error(message)

  super
end

Class Method Details

.error_key(key = nil, namespace = nil) ⇒ Object

# File 'lib/vagrant/errors.rb', line 57

def self.error_key(key=nil, namespace=nil)
  define_method(:error_key) { key }
  error_namespace(namespace) if namespace
end

.error_namespace(namespace) ⇒ Object

# File 'lib/vagrant/errors.rb', line 62

def self.error_namespace(namespace)
  define_method(:error_namespace) { namespace }
end

.status_code(code = nil) ⇒ Object

# File 'lib/vagrant/errors.rb', line 48

def self.status_code(code = nil)
  if code
    raise "Status code already in use: #{code}"  if @@used_codes.include?(code)
    @@used_codes << code
  end

  define_method(:status_code) { code }
end

Instance Method Details

#error_key ⇒ Object

The key for the error message. This should be set using the error_key method but can be overridden here if needed.

# File 'lib/vagrant/errors.rb', line 81

def error_key; nil; end

#error_namespace ⇒ Object

The default error namespace which is used for the error key. This can be overridden here or by calling the "error_namespace" class method.

# File 'lib/vagrant/errors.rb', line 77

def error_namespace; "vagrant.errors"; end