Class: Admission::Arbitration

Inherits:
Object
  • Object
show all
Defined in:
lib/admission/arbitration.rb

Direct Known Subclasses

ResourceArbitration

Defined Under Namespace

Classes: RulesBuilder

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(person, rules_index, request) ⇒ Arbitration

Returns a new instance of Arbitration.



4
5
6
7
8
9
 
# File 'lib/admission/arbitration.rb', line 4

def initialize person, rules_index, request
  @person = person
  @rules_index = rules_index
  @request = request.to_sym
  @decisions = {}
end

Class Method Details

.define_rules(privilege_order, &block) ⇒ Object 



63
64
65
66
67
 
# File 'lib/admission/arbitration.rb', line 63

def self.define_rules privilege_order, &block
  builder = self::RulesBuilder.new privilege_order
  builder.instance_exec &block
  builder.create_index
end

Instance Method Details

#decide(privilege) ⇒ Object 



53
54
55
56
57
58
59
60
61
 
# File 'lib/admission/arbitration.rb', line 53

def decide privilege
  decision = make_decision @rules_index[@request], privilege
  return decision if decision.eql?(:forbidden) || decision.eql?(true)

  decision = decide_per_inheritance privilege
  return decision if decision.eql?(:forbidden) || decision.eql?(true)

  make_decision @rules_index[Admission::ALL_ACTION], privilege
end

#decide_per_inheritance(privilege) ⇒ Object 



40
41
42
43
44
45
46
47
48
49
50
51
 
# File 'lib/admission/arbitration.rb', line 40

def decide_per_inheritance privilege
  inherited = privilege.inherited
  return nil if inherited.nil? || inherited.empty?

  explicit_allowance = false
  inherited.each do |p|
    rule = rule_per_privilege p
    return rule if rule == :forbidden
    explicit_allowance ||= rule
  end
  explicit_allowance
end

#make_decision(from_rules, privilege) ⇒ Object 



27
28
29
30
31
32
33
34
35
36
37
38
 
# File 'lib/admission/arbitration.rb', line 27

def make_decision from_rules, privilege
  if from_rules
    decision = from_rules[privilege]
    decision = @person.instance_exec @context, &decision if Proc === decision

    unless Admission::VALID_DECISION.include? decision
      raise "invalid decision: #{decision}"
    end

    decision
  end
end

#prepare_sitting(context = nil) ⇒ Object 



11
12
13
14
15
 
# File 'lib/admission/arbitration.rb', line 11

def prepare_sitting context=nil
  return if context == @context
  @context = context
  @decisions = {}
end

#rule_per_privilege(privilege) ⇒ Object 



17
18
19
20
21
22
23
24
25
 
# File 'lib/admission/arbitration.rb', line 17

def rule_per_privilege privilege
  decision = @decisions[privilege]
  return decision unless decision.nil?

  decision = decide privilege

  decision = false if decision.nil?
  @decisions[privilege] = decision
end