Class: PluginRegistry::Plugin

Inherits:
Object
  • Object
show all
Defined in:
lib/utils/plugin_registry.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Attribute Details

#parentObject

Returns the value of attribute parent.



91
92
93
# File 'lib/utils/plugin_registry.rb', line 91

def parent
  @parent
end

#targetObject (readonly)

Returns the value of attribute target.



90
91
92
# File 'lib/utils/plugin_registry.rb', line 90

def target
  @target
end

Class Method Details

.name(name) ⇒ nil

Register a new plugin by name



49
50
51
52
53
# File 'lib/utils/plugin_registry.rb', line 49

def self.name(name)
  raise "Trying to register #{self} with name == nil" if name.nil?
  @name = name
  plugin_registry.registry[name] = self
end

.plugin_registryPluginRegistry

Retrieve the plugin registry associated with this plugin



41
42
43
# File 'lib/utils/plugin_registry.rb', line 41

def self.plugin_registry
  raise "Plugin #{self} does not implement `self.plugin_registry()`. This method is required"
end

.priority(x = nil) ⇒ Numeric

This plugin’s priority. Set it by providing the priority as an argument. Higher numbers ensure that the plugin is called early to check if a target belongs to it. When called without an argument, it retrieves this plugin’s priority. Defaults to 0.



62
63
64
65
# File 'lib/utils/plugin_registry.rb', line 62

def self.priority(x = nil)
  @priority = x unless x.nil?
  @priority || 0
end

.resolve(_target) ⇒ Plugin

Try to resolve the target. If this plugin cannot handle it, the result will be nil. If, however, the plugin can resolve it, the resulting object will be an instance of this plugin. This means, that the interface that this base class provides, is the basis for the returned type.



74
75
76
# File 'lib/utils/plugin_registry.rb', line 74

def self.resolve(_target)
  raise "Plugin #{self} does not implement `self.resolve(target)`. This method is required"
end

.resolve_next(target, parent) ⇒ Plugin

When a plugin’s resolve doesn’t lead to the final state, it can use this method to hand it back for another resolver to handle.



84
85
86
87
88
# File 'lib/utils/plugin_registry.rb', line 84

def self.resolve_next(target, parent)
  res = plugin_registry.resolve(target)
  res.parent = parent
  res
end