class MrDarcy::Context

Attributes

deferred[RW]
driver[RW]

Public Class Methods

action(action_name, &block) click to toggle source

Defines an action that can be performed in this context.

  • action_name: essentially the name of the method defined in this class.

Takes a block with which to define the action.

# File lib/mr_darcy/context.rb, line 26
def action action_name, &block
  define_method action_name do |*args|
    self.then do |value|
      self.instance_exec(*args, &block)
    end
    self
  end
end
new(role_players={}) click to toggle source

Create an instance of the context. You must pass in role-players for all roles defined in this context using a single hash argument of role names (as symbols) to objects.

eg:

BankTransfer.new money_source: account1, money_destination: account2
# File lib/mr_darcy/context.rb, line 48
def initialize role_players={}
  @driver   = role_players.delete(:driver) || MrDarcy.driver
  @deferred = Deferred.new(driver: driver)
  deferred.resolve nil

  roles = self.class.roles
  roles.each do |role_name, role|
    player = role_players[role_name]
    Kernel::raise ArgumentError, "No role player for #{role_name} supplied" unless player

    role.pollute(player)

    self.singleton_class.send :define_method, role_name do
      player
    end
  end
end
role(role_name, options={}) click to toggle source

Defines a role to be mixed into the roll-player when this context is initialized.

See MrDarcy::Role#initialize for argument definitions.

# File lib/mr_darcy/context.rb, line 16
def role role_name, options={}, &block
  self.roles[role_name] = Role.new(role_name, options, &block)
end
roles() click to toggle source

A list of available roles in this context.

# File lib/mr_darcy/context.rb, line 36
def roles
  @roles ||= {}
end

Public Instance Methods

fail(&block) click to toggle source

See MrDarcy::Promise::Base#fail

# File lib/mr_darcy/context.rb, line 75
def fail &block
  deferred.fail do |value|
    self.instance_exec(value, &block)
  end
  self
end
final() click to toggle source

See MrDarcy::Promise::Base#final

# File lib/mr_darcy/context.rb, line 83
def final
  deferred.final
  self
end
then(&block) click to toggle source

See MrDarcy::Promise::Base#then

# File lib/mr_darcy/context.rb, line 67
def then &block
  deferred.then do |value|
    self.instance_exec(value, &block)
  end
  self
end