Class: Vagrant::Plugin::V2::Plugin
- Inherits:
-
Object
- Object
- Vagrant::Plugin::V2::Plugin
- Defined in:
- lib/vagrant/plugin/v2/plugin.rb
Overview
This is the superclass for all V2 plugins.
Constant Summary collapse
- ALL_ACTIONS =
Special marker that can be used for action hooks that matches all action sequences.
:__all_actions__
- LOGGER =
The logger for this class.
Log4r::Logger.new("vagrant::plugin::v2::plugin")
- ROOT_CLASS =
Set the root class up to be ourself, so that we can reference this from within methods which are probably in subclasses.
self
Class Method Summary collapse
-
.action_hook(name, hook_name = nil, &block) ⇒ Array
Registers a callback to be called when a specific action sequence is run.
-
.command(name, **opts, &block) ⇒ Object
Defines additional command line commands available by key.
-
.communicator(name = UNSET_VALUE, &block) ⇒ Object
Defines additional communicators to be available.
-
.components ⇒ Components
Returns the Components for this plugin.
-
.config(name, scope = nil, &block) ⇒ Object
Defines additional configuration keys to be available in the Vagrantfile.
-
.data ⇒ Hash
Returns the internal data associated with this plugin.
-
.description(value = UNSET_VALUE) ⇒ String
Sets a human-friendly description of the plugin.
-
.guest(name, parent = nil, &block) ⇒ Object
Defines an additionally available guest implementation with the given key.
-
.guest_capability(guest, cap, &block) ⇒ Object
Defines a capability for the given guest.
-
.host(name, parent = nil, &block) ⇒ Object
Defines an additionally available host implementation with the given key.
-
.host_capability(host, cap, &block) ⇒ Object
Defines a capability for the given host.
-
.manager ⇒ V2::Manager
This returns the manager for all V2 plugins.
-
.name(name = UNSET_VALUE) ⇒ String
Set the name of the plugin.
-
.provider(name = UNSET_VALUE, options = nil, &block) ⇒ Object
Registers additional providers to be available.
-
.provider_capability(provider, cap, &block) ⇒ Object
Defines a capability for the given provider.
-
.provisioner(name = UNSET_VALUE, &block) ⇒ Object
Registers additional provisioners to be available.
-
.push(name, options = nil, &block) ⇒ Object
Registers additional pushes to be available.
-
.synced_folder(name, priority = 10, &block) ⇒ Object
Registers additional synced folder implementations.
-
.synced_folder_capability(synced_folder, cap, &block) ⇒ Object
Defines a capability for the given synced folder.
Class Method Details
.action_hook(name, hook_name = nil, &block) ⇒ Array
Registers a callback to be called when a specific action sequence is run. This allows plugin authors to hook into things like VM bootup, VM provisioning, etc.
72 73 74 75 76 77 78 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 72 def self.action_hook(name, hook_name=nil, &block) # The name is currently not used but we want it for the future. hook_name = hook_name.to_s if hook_name hook_name ||= ALL_ACTIONS components.action_hooks[hook_name.to_sym] << block end |
.command(name, **opts, &block) ⇒ Object
Defines additional command line commands available by key. The key becomes the subcommand, so if you register a command "foo" then "vagrant foo" becomes available.
85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 85 def self.command(name, **opts, &block) # Validate the name of the command if name.to_s !~ /^[-a-z0-9]+$/i raise InvalidCommandName, "Commands can only contain letters, numbers, and hyphens" end # By default, the command is primary opts[:primary] = true if !opts.key?(:primary) # Register the command components.commands.register(name.to_sym) do [block, opts] end nil end |
.communicator(name = UNSET_VALUE, &block) ⇒ Object
Defines additional communicators to be available. Communicators should be returned by a block passed to this method. This is done to ensure that the class is lazy loaded, so if your class inherits from or uses any Vagrant internals specific to Vagrant 1.0, then the plugin can still be defined without breaking anything in future versions of Vagrant.
110 111 112 113 114 115 116 117 118 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 110 def self.communicator(name=UNSET_VALUE, &block) data[:communicator] ||= Registry.new # Register a new communicator class only if a name was given. data[:communicator].register(name.to_sym, &block) if name != UNSET_VALUE # Return the registry data[:communicator] end |
.components ⇒ Components
Returns the Components for this plugin.
33 34 35 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 33 def self.components @components ||= Components.new end |
.config(name, scope = nil, &block) ⇒ Object
Defines additional configuration keys to be available in the Vagrantfile. The configuration class should be returned by a block passed to this method. This is done to ensure that the class is lazy loaded, so if your class inherits from any classes that are specific to Vagrant 1.0, then the plugin can still be defined without breaking anything in future versions of Vagrant.
128 129 130 131 132 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 128 def self.config(name, scope=nil, &block) scope ||= :top components.configs[scope].register(name.to_sym, &block) nil end |
.data ⇒ Hash
Returns the internal data associated with this plugin. This should NOT be called by the general public.
266 267 268 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 266 def self.data @data ||= {} end |
.description(value = UNSET_VALUE) ⇒ String
Sets a human-friendly description of the plugin.
60 61 62 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 60 def self.description(value=UNSET_VALUE) get_or_set(:description, value) end |
.guest(name, parent = nil, &block) ⇒ Object
Defines an additionally available guest implementation with the given key.
139 140 141 142 143 144 145 146 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 139 def self.guest(name, parent=nil, &block) components.guests.register(name.to_sym) do parent = parent.to_sym if parent [block.call, parent] end nil end |
.guest_capability(guest, cap, &block) ⇒ Object
Defines a capability for the given guest. The block should return a class/module that has a method with the capability name, ready to be executed. This means that if it is an instance method, the block should return an instance of the class.
155 156 157 158 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 155 def self.guest_capability(guest, cap, &block) components.guest_capabilities[guest.to_sym].register(cap.to_sym, &block) nil end |
.host(name, parent = nil, &block) ⇒ Object
Defines an additionally available host implementation with the given key.
165 166 167 168 169 170 171 172 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 165 def self.host(name, parent=nil, &block) components.hosts.register(name.to_sym) do parent = parent.to_sym if parent [block.call, parent] end nil end |
.host_capability(host, cap, &block) ⇒ Object
Defines a capability for the given host. The block should return a class/module that has a method with the capability name, ready to be executed. This means that if it is an instance method, the block should return an instance of the class.
181 182 183 184 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 181 def self.host_capability(host, cap, &block) components.host_capabilities[host.to_sym].register(cap.to_sym, &block) nil end |
.manager ⇒ V2::Manager
This returns the manager for all V2 plugins.
26 27 28 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 26 def self.manager @manager ||= Manager.new end |
.name(name = UNSET_VALUE) ⇒ String
Set the name of the plugin. The moment that this is called, the plugin will be registered and available. Before this is called, a plugin does not exist. The name must be unique among all installed plugins.
44 45 46 47 48 49 50 51 52 53 54 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 44 def self.name(name=UNSET_VALUE) # Get or set the value first, so we have a name for logging when # we register. result = get_or_set(:name, name) # The plugin should be registered if we're setting a real name on it Plugin.manager.register(self) if name != UNSET_VALUE # Return the result result end |
.provider(name = UNSET_VALUE, options = nil, &block) ⇒ Object
Registers additional providers to be available.
189 190 191 192 193 194 195 196 197 198 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 189 def self.provider(name=UNSET_VALUE, =nil, &block) ||= {} [:priority] ||= 5 components.providers.register(name.to_sym) do [block.call, ] end nil end |
.provider_capability(provider, cap, &block) ⇒ Object
Defines a capability for the given provider. The block should return a class/module that has a method with the capability name, ready to be executed. This means that if it is an instance method, the block should return an instance of the class.
207 208 209 210 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 207 def self.provider_capability(provider, cap, &block) components.provider_capabilities[provider.to_sym].register(cap.to_sym, &block) nil end |
.provisioner(name = UNSET_VALUE, &block) ⇒ Object
Registers additional provisioners to be available.
215 216 217 218 219 220 221 222 223 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 215 def self.provisioner(name=UNSET_VALUE, &block) data[:provisioners] ||= Registry.new # Register a new provisioner class only if a name was given data[:provisioners].register(name.to_sym, &block) if name != UNSET_VALUE # Return the registry data[:provisioners] end |
.push(name, options = nil, &block) ⇒ Object
Registers additional pushes to be available.
229 230 231 232 233 234 235 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 229 def self.push(name, =nil, &block) components.pushes.register(name.to_sym) do [block.call, ] end nil end |
.synced_folder(name, priority = 10, &block) ⇒ Object
Registers additional synced folder implementations.
higher (big) numbers are tried before lower (small) numbers.
242 243 244 245 246 247 248 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 242 def self.synced_folder(name, priority=10, &block) components.synced_folders.register(name.to_sym) do [block.call, priority] end nil end |
.synced_folder_capability(synced_folder, cap, &block) ⇒ Object
Defines a capability for the given synced folder. The block should return a class/module that has a method with the capability name, ready to be executed. This means that if it is an instance method, the block should return an instance of the class.
257 258 259 260 |
# File 'lib/vagrant/plugin/v2/plugin.rb', line 257 def self.synced_folder_capability(synced_folder, cap, &block) components.synced_folder_capabilities[synced_folder.to_sym].register(cap.to_sym, &block) nil end |