Class: Kennel::Models::Base

Inherits:
Object
  • Object
show all
Extended by:
SubclassTracking
Defined in:
lib/kennel/models/base.rb

Direct Known Subclasses

Dash, Monitor, Project, Screen, Team

Defined Under Namespace

Classes: ValidationError

Constant Summary collapse

LOCK = 
"\u{1F512}"
READONLY_ATTRIBUTES = 
[
  :deleted, :matching_downtimes, :id, :created, :created_at, :creator, :org_id, :modified,
  :overall_state_modified, :overall_state, :api_resource
].freeze
REQUEST_DEFAULTS = 
{
  style: { width: "normal", palette: "dog_classic", type: "solid" },
  conditional_formats: [],
  aggregator: "avg"
}.freeze

Class Method Summary collapse

Instance Method Summary collapse

Methods included from SubclassTracking

recursive_subclasses, subclasses

Constructor Details

#initialize(options = {}) ⇒ Base

Returns a new instance of Base.



90
91
92
93
94
95
96
97
98
99
100
 
# File 'lib/kennel/models/base.rb', line 90

def initialize(options = {})
  validate_options(options)

  options.each do |name, block|
    self.class.validate_setting_exists name
    define_singleton_method name, &block
  end

  # need expand_path so it works wih rake and when run individually
  @invocation_location = caller.detect { |l| File.expand_path(l).start_with?(Dir.pwd) }
end

Class Method Details

.defaults(options) ⇒ Object 



39
40
41
42
43
44
 
# File 'lib/kennel/models/base.rb', line 39

def defaults(options)
  options.each do |name, block|
    validate_setting_exists name
    define_method name, &block
  end
end

.inherited(child) ⇒ Object 



46
47
48
49
 
# File 'lib/kennel/models/base.rb', line 46

def inherited(child)
  super
  child.instance_variable_set(:@set, (@set || []).dup)
end

.settings(*names) ⇒ Object 



24
25
26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/kennel/models/base.rb', line 24

def settings(*names)
  duplicates = (@set & names)
  if duplicates.any?
    raise ArgumentError, "Settings #{duplicates.map(&:inspect).join(", ")} are already defined"
  end

  @set.concat names
  names.each do |name|
    next if method_defined?(name)
    define_method name do
      raise ArgumentError, "Trying to call #{name} for #{self.class} but it was never set or passed as option"
    end
  end
end

.validate_setting_exists(name) ⇒ Object

Raises:

  • (ArgumentError) 


51
52
53
54
55
 
# File 'lib/kennel/models/base.rb', line 51

def validate_setting_exists(name)
  return if !@set || @set.include?(name)
  supported = @set.map(&:inspect)
  raise ArgumentError, "Unsupported setting #{name.inspect}, supported settings are #{supported.join(", ")}"
end

Instance Method Details

#diff(actual) ⇒ Object 



117
118
119
120
121
122
123
124
 
# File 'lib/kennel/models/base.rb', line 117

def diff(actual)
  expected = as_json
  expected.delete(:id)

  self.class.send(:normalize, expected, actual)

  HashDiff.diff(actual, expected, use_lcs: false)
end

#kennel_id ⇒ Object 



102
103
104
105
106
107
108
109
110
111
 
# File 'lib/kennel/models/base.rb', line 102

def kennel_id
  name = self.class.name
  if name.start_with?("Kennel::")
    message = +"Set :kennel_id"
    message << " for project #{project.kennel_id}" if defined?(project)
    message << " on #{@invocation_location}" if @invocation_location
    raise ArgumentError, message
  end
  @kennel_id ||= Utils.snake_case name
end

#name ⇒ Object 



113
114
115
 
# File 'lib/kennel/models/base.rb', line 113

def name
  self.class.name
end

#resolve_linked_tracking_ids ⇒ Object 



134
135
 
# File 'lib/kennel/models/base.rb', line 134

def resolve_linked_tracking_ids(*)
end

#to_json ⇒ Object

Raises:

  • (NotImplementedError) 


130
131
132
 
# File 'lib/kennel/models/base.rb', line 130

def to_json
  raise NotImplementedError, "Use as_json"
end

#tracking_id ⇒ Object 



126
127
128
 
# File 'lib/kennel/models/base.rb', line 126

def tracking_id
  "#{project.kennel_id}:#{kennel_id}"
end