Class: Sfn::Lint::RuleSet

Inherits:
Object
  • Object
show all
Includes:
Bogo::Memoization
Defined in:
lib/sfn/lint/rule_set.rb

Overview

Named collection of rules

Defined Under Namespace

Classes: Creator

Constant Summary collapse

@@_rule_set_registry = 
Smash.new

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, provider = :aws, rules = []) ⇒ self

Create new rule set

Parameters:

  • name (String, Symbol) —

    name of rule set

  • provider (String, Symbol) (defaults to: :aws) —

    name of target provider

  • rules (Array<Rule>) (defaults to: []) —

    list of rules defining this set



105
106
107
108
109
110
 
# File 'lib/sfn/lint/rule_set.rb', line 105

def initialize(name, provider=:aws, rules=[])
  @name = name.to_sym
  @provider = Bogo::Utility.snake(provider).to_sym
  @rules = rules.dup.uniq.freeze
  validate_rules!
end

Instance Attribute Details

#name ⇒ Symbol (readonly)

Returns name.

Returns:

  • (Symbol) —

    name



93
94
95
 
# File 'lib/sfn/lint/rule_set.rb', line 93

def name
  @name
end

#provider ⇒ Symbol (readonly)

Returns target provider.

Returns:

  • (Symbol) —

    target provider



95
96
97
 
# File 'lib/sfn/lint/rule_set.rb', line 95

def provider
  @provider
end

#rules ⇒ Array<Rule> (readonly)

Returns rules of set.

Returns:

  • (Array<Rule>) —

    rules of set



97
98
99
 
# File 'lib/sfn/lint/rule_set.rb', line 97

def rules
  @rules
end

Class Method Details

.build(name, provider = :aws, &block) ⇒ Object

RuleSet generator helper for quickly building simple rule sets

Parameters:

  • name (String) —

    name of rule set

  • provider (String, Symbol) (defaults to: :aws) —

    target provider



54
55
56
57
58
59
 
# File 'lib/sfn/lint/rule_set.rb', line 54

def build(name, provider=:aws, &block)
  provider = Bogo::Utility.snake(provider).to_sym
  rs = Creator::RuleSet.new(provider)
  rs.instance_exec(&block)
  self.new(name, provider, rs.items)
end

.get(name, provider = :aws) ⇒ RuleSet, NilClass

Get registered rule set

Parameters:

  • name (String) —

    name of rule set

  • provider (String) (defaults to: :aws) —

    target provider

Returns:



75
76
77
78
 
# File 'lib/sfn/lint/rule_set.rb', line 75

def get(name, provider=:aws)
  provider = Bogo::Utility.snake(provider)
  @@_rule_set_registry.get(provider, name)
end

.get_all(provider = :aws) ⇒ Array<RuleSet>

Get all rule sets for specified provider

Parameters:

  • provider (String) (defaults to: :aws) —

    target provider

Returns:



84
85
86
 
# File 'lib/sfn/lint/rule_set.rb', line 84

def get_all(provider=:aws)
  @@_rule_set_registry.fetch(provider, {}).values
end

.register(rule_set) ⇒ TrueClass

Register a rule set

Parameters:

Returns:

  • (TrueClass) 


65
66
67
68
 
# File 'lib/sfn/lint/rule_set.rb', line 65

def register(rule_set)
  @@_rule_set_registry.set(rule_set.provider, rule_set.name, rule_set)
  true
end

Instance Method Details

#add_rule(rule) ⇒ self

Add a new rule to the collection

Parameters:

  • rule (Rule) —

    new rule to add

Returns:

  • (self) 


116
117
118
119
120
121
122
 
# File 'lib/sfn/lint/rule_set.rb', line 116

def add_rule(rule)
  new_rules = rules.dup
  new_rules << rule
  @rules = new_rules.uniq.freeze
  validate_rules!
  self
end

#apply(template) ⇒ TrueClass, Array<String>

Apply rule set to template.

Parameters:

  • template (Hash)

Returns:

  • (TrueClass, Array<String>) —

    true on success, list failure messages on failure



139
140
141
142
143
144
145
146
147
148
 
# File 'lib/sfn/lint/rule_set.rb', line 139

def apply(template)
  failures = collect_failures(template)
  if(failures.empty?)
    true
  else
    failures.map do |failure|
      failure[:rule].generate_fail_message(failure[:result])
    end
  end
end

#collect_failures(template) ⇒ Array<Rule>

Process template through rules defined in this set and store failure information

Parameters:

  • template (Hash)

Returns:

  • (Array<Rule>) —

    list of failures



155
156
157
158
159
160
161
162
 
# File 'lib/sfn/lint/rule_set.rb', line 155

def collect_failures(template)
  results = rules.map do |rule|
    result = rule.apply(template)
    result == true ? true : Smash.new(:rule => rule, :result => result)
  end
  results.delete_if{|i| i == true}
  results
end

#remove_rule(rule) ⇒ self

Remove a rule from the collection

Parameters:

  • rule (Rule) —

    rule to remove

Returns:

  • (self) 


128
129
130
131
132
133
 
# File 'lib/sfn/lint/rule_set.rb', line 128

def remove_rule(rule)
  new_rules = rules.dup
  new_rules.delete(rule)
  @rules = new_rules.uniq.freeze
  self
end

#validate_rules! ⇒ Object

Check that provided rules provider match rule set defined provider



165
166
167
168
169
170
171
172
173
 
# File 'lib/sfn/lint/rule_set.rb', line 165

def validate_rules!
  non_match = rules.find_all do |rule|
    rule.provider != provider
  end
  unless(non_match.empty?)
    raise ArgumentError.new "Rule set defines `#{provider}` as provider but includes rules for " \
      "non matching providers. (#{non_match.map(&:provider).map(&:to_s).uniq.sort.join(', ')})"
  end
end