Exception: Vagrant::Errors::VagrantError

Inherits:
StandardError
  • Object
show all
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

ActiveMachineWithDifferentProvider, AnsiblePlaybookAppNotFound, BaseVMNotFound, BatchMultiError, BoxAlreadyExists, BoxConfigChangingBox, BoxMetadataFileNotFound, BoxNotFound, BoxNotSpecified, BoxProviderDoesntMatch, BoxSpecifiedDoesntExist, BoxUnpackageFailure, BoxUpgradeRequired, BoxVerificationFailed, CFEngineBootstrapFailed, CFEngineCantAutodetectIP, CFEngineInstallFailed, CFEngineNotInstalled, CLIInvalidOptions, CLIInvalidUsage, ConfigInvalid, ConfigUpgradeErrors, CopyPrivateKeyFailed, DestroyRequiresForce, DotfileIsDirectory, DotfileUpgradeJSONError, DownloaderError, DownloaderFileDoesntExist, DownloaderHTTPConnectReset, DownloaderHTTPConnectTimeout, DownloaderHTTPSocketError, DownloaderHTTPStatusError, EnvironmentLockedError, EnvironmentNonExistentCWD, ForwardPortAdapterNotFound, ForwardPortAutolistEmpty, ForwardPortCollision, ForwardPortCollisionResume, GemCommandInBundler, GuestCapabilityInvalid, GuestCapabilityNotFound, GuestNotDetected, HomeDirectoryMigrationFailed, HomeDirectoryNotAccessible, LinuxMountFailed, LinuxNFSMountFailed, LinuxShellExpandFailed, LocalDataDirectoryNotAccessible, MachineGuestNotReady, MachineNotFound, MachineStateInvalid, MultiVMEnvironmentRequired, MultiVMTargetRequired, NFSNoGuestIP, NFSNoHostIP, NFSNoHostonlyNetwork, NetworkAdapterCollision, NetworkCollision, NetworkDHCPAlreadyAttached, NetworkNoAdapters, NetworkNotFound, NoEnvironmentError, PackageIncludeMissing, PackageOutputDirectory, PackageOutputExists, PackageRequiresDirectory, PersistDotfileExists, PluginGemError, PluginInstallBadEntryPoint, PluginInstallLicenseNotFound, PluginInstallNotFound, PluginLoadError, PluginLoadFailed, PluginLoadFailedWithOutput, PluginNotFound, ProviderNotFound, SCPPermissionDenied, SCPUnavailable, SSHAuthenticationFailed, SSHConnectEACCES, SSHConnectionRefused, SSHConnectionReset, SSHConnectionTimeout, SSHDisconnected, SSHHostDown, SSHIsPuttyLink, SSHKeyBadOwner, SSHKeyBadPermissions, SSHKeyTypeNotSupported, SSHNotReady, SSHPortNotDetected, SSHUnavailable, SSHUnavailableWindows, SharedFolderCreateFailed, UIExpectsTTY, UnimplementedProviderAction, VBoxManageError, VBoxManageNotFoundError, VMBaseMacNotSpecified, VMCustomizationFailed, VMFailedToBoot, VMFailedToRun, VMGuestError, VMImportFailure, VMInaccessible, VMNameExists, VMNoMatchError, VMNotCreatedError, VMNotFoundError, VMNotRunningError, VMPowerOffToPackage, VagrantInterrupt, VagrantfileExistsError, VagrantfileLoadError, VagrantfileSyntaxError, VirtualBoxInstallIncomplete, VirtualBoxInvalidVersion, VirtualBoxKernelModuleNotLoaded, VirtualBoxNoRoomForHighLevelNetwork, VirtualBoxNotDetected, Plugin::V1::Guest::BaseError

Class Method Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (VagrantError) initialize(message = nil, *args)

A new instance of VagrantError



55
56
57
58
59
60
61
 
# File 'lib/vagrant/errors.rb', line 55

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

+ (Object) error_key(key = nil, namespace = nil) 



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

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

+ (Object) error_namespace(namespace) 



51
52
53
 
# File 'lib/vagrant/errors.rb', line 51

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

Instance Method Details

- (Object) error_key

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



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

def error_key; nil; end

- (Object) error_namespace

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



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

def error_namespace; "vagrant.errors"; end

- (Integer) status_code

This is the exit code that should be used when exiting from this exception.

Returns:

  • (Integer) 


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

def status_code; 1; end