Class: Blueprints::Dependency

Inherits:
Object
  • Object
show all
Defined in:
lib/blueprints/dependency.rb

Overview

Class for defining blueprint dependencies. Accepts up to 3 params:

  • name - pass the name of blueprint to build when trying to access value of this dependency.

  • iv_name (optional) - pass the name of instance variable to use for value. Defaults to same name as blueprint name.

  • options (optional) - pass options that are then passed to blueprint when building.

Examples:

Blueprints::Dependency.new(:blueprint).value # Builds blueprint 'blueprint' and returns value of @blueprint instance variable
Blueprints::Dependency.new(:blueprint, value).value # Builds blueprint 'blueprint' and returns value of @value instance variable
Blueprints::Dependency.new(:blueprint, :option => true).value # Builds blueprint 'blueprint' with options and returns value of @value instance variable

Blueprints::Dependency objects also catch all missing methods. They are later replayed on instance variable when getting value. Example:

d = Blueprints::Dependency.new(:blueprint).name.size
d.value # => 4 when @blueprint.name == 'John'

Instance Method Summary collapse

Constructor Details

#initialize(name, *args) ⇒ Dependency

Initializes new copy of Blueprints::Dependency with name, iv_name and options.



17
18
19
20
21
22
 
# File 'lib/blueprints/dependency.rb', line 17

def initialize(name, *args)
  @name = name
  @options = args.extract_options!
  @iv_name = args.first || @name
  @registry = []
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method, *args, &block) ⇒ Object

Catches all missing methods to later replay when asking for value.



33
34
35
36
 
# File 'lib/blueprints/dependency.rb', line 33

def method_missing(method, *args, &block)
  @registry << [method, args, block]
  self
end

Instance Method Details

#blueprint_value ⇒ Object

Builds blueprint (if necessary) and returns the value of instance variable.



25
26
27
28
29
30
 
# File 'lib/blueprints/dependency.rb', line 25

def blueprint_value
  Blueprints::RootNamespace.root.build @name => @options
  @registry.inject(Blueprints::RootNamespace.root.context.instance_variable_get(:"@#{@iv_name}")) do |value, (method, args, block)|
    value.send(method, *args, &block)
  end
end