Class: DDPlugin::Registry

Inherits:
Object
  • Object
show all
Defined in:
lib/ddplugin/registry.rb

Overview

The registry is responsible for keeping track of all loaded plugins.

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Registry

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Registry.



13
14
15
16
 
# File 'lib/ddplugin/registry.rb', line 13

def initialize
  @identifiers_to_classes = Hash.new { |h, k| h[k] = {}.dup }
  @classes_to_identifiers = Hash.new { |h, k| h[k] = {}.dup }
end

Class Method Details

.instance ⇒ DDPlugin::Registry

Returns the shared DDPlugin::Registry instance, creating it if none exists yet.

Returns:



8
9
10
 
# File 'lib/ddplugin/registry.rb', line 8

def self.instance
  @instance ||= new
end

Instance Method Details

#find(root_class, identifier) ⇒ Class?

Finds the class that is a descendant of the given class and has the given identifier.

Parameters:

  • root_class (Class) —

    The root class of the class to return

  • identifier (Symbol) —

    The identifier of the class to return

Returns:

  • (Class, nil) —

    The class with the given identifier



55
56
57
58
 
# File 'lib/ddplugin/registry.rb', line 55

def find(root_class, identifier)
  @identifiers_to_classes[root_class] ||= {}
  @identifiers_to_classes[root_class][identifier]
end

#find_all(root_class) ⇒ Enumerable<Class>

Returns all classes that are registered descendants of the given class.

Parameters:

  • root_class (Class) —

    The root class of the class to return

Returns:

  • (Enumerable<Class>) —

    A collection of registered classes



65
66
67
68
 
# File 'lib/ddplugin/registry.rb', line 65

def find_all(root_class)
  @identifiers_to_classes[root_class] ||= {}
  @identifiers_to_classes[root_class].values.uniq
end

#identifiers_of(root_class, klass) ⇒ Array<Symbol>

Returns The identifiers for the given class.

Parameters:

  • root_class (Class) —

    The root class of the class to find the identifiers for

  • klass (Class) —

    The class to get the identifiers for

Returns:

  • (Array<Symbol>) —

    The identifiers for the given class



42
43
44
45
 
# File 'lib/ddplugin/registry.rb', line 42

def identifiers_of(root_class, klass)
  @classes_to_identifiers[root_class] ||= {}
  @classes_to_identifiers[root_class].fetch(klass, [])
end

#register(root_class, klass, *identifiers) ⇒ void

This method returns an undefined value.

Registers the given class as a plugin.

Parameters:

  • root_class (Class) —

    The root class of the class to register

  • klass (Class) —

    The class to register

  • identifiers (Symbol) —

    One or more symbols identifying the class



27
28
29
30
31
32
33
34
 
# File 'lib/ddplugin/registry.rb', line 27

def register(root_class, klass, *identifiers)
  identifiers.each do |identifier|
    @classes_to_identifiers[root_class][klass] ||= []

    @identifiers_to_classes[root_class][identifier] = klass
    @classes_to_identifiers[root_class][klass] << identifier
  end
end