Class: Kennel::Models::Record
- Includes:
- OptionalValidations
- Defined in:
- lib/kennel/models/record.rb
Direct Known Subclasses
Constant Summary collapse
- MARKER_TEXT =
Apart from if you just don’t like the default for some reason, overriding MARKER_TEXT allows for namespacing within the same Datadog account. If you run one Kennel setup with marker text A and another with marker text B (assuming that A isn’t a substring of B and vice versa), then the two Kennel setups will operate independently of each other, not trampling over each other’s objects.
This could be useful for allowing multiple products / projects / teams to share a Datadog account but otherwise largely operate independently of each other. In particular, it can be useful for running a “dev” or “staging” instance of Kennel in the same account as, but mostly isolated from, a “production” instance.
ENV.fetch("KENNEL_MARKER_TEXT", "Managed by kennel")
- LOCK =
"\u{1F512}"
- TRACKING_FIELDS =
[:message, :description].freeze
- READONLY_ATTRIBUTES =
[ :deleted, :id, :created, :created_at, :creator, :org_id, :modified, :modified_at, :klass, :tracking_id # added by syncer.rb ].freeze
- ALLOWED_KENNEL_ID_CHARS =
"a-zA-Z_\\d.-"
- ALLOWED_KENNEL_ID_SEGMENT =
/[#{ALLOWED_KENNEL_ID_CHARS}]+/
- ALLOWED_KENNEL_ID_FULL =
"#{ALLOWED_KENNEL_ID_SEGMENT}:#{ALLOWED_KENNEL_ID_SEGMENT}".freeze
- ALLOWED_KENNEL_ID_REGEX =
/\A#{ALLOWED_KENNEL_ID_FULL}\z/
Constants included from OptionalValidations
OptionalValidations::UNIGNORABLE, OptionalValidations::UNUSED_IGNORES
Constants inherited from Base
Base::SETTING_OVERRIDABLE_METHODS
Constants included from SettingsAsMethods
SettingsAsMethods::AS_PROCS, SettingsAsMethods::SETTING_OVERRIDABLE_METHODS
Instance Attribute Summary collapse
-
#as_json ⇒ Object
readonly
Returns the value of attribute as_json.
-
#project ⇒ Object
readonly
Returns the value of attribute project.
Class Method Summary collapse
- .api_resource_map ⇒ Object
- .parse_any_url(url) ⇒ Object
- .parse_tracking_id(a) ⇒ Object
-
.remove_tracking_id(a) ⇒ Object
TODO: combine with parse into a single method or a single regex.
Instance Method Summary collapse
- #add_tracking_id ⇒ Object
- #build ⇒ Object
- #build_json ⇒ Object
- #diff(actual) ⇒ Object
-
#initialize(project) ⇒ Record
constructor
A new instance of Record.
- #invalid_update!(field, old_value, new_value) ⇒ Object
- #remove_tracking_id ⇒ Object
- #resolve_linked_tracking_ids! ⇒ Object
-
#safe_tracking_id ⇒ Object
For use during error handling.
- #tracking_id ⇒ Object
-
#validate_update!(_diffs) ⇒ Object
Can raise DisallowedUpdateError.
Methods included from OptionalValidations
filter_validation_errors, included, #invalid!, valid?
Methods inherited from Base
Methods included from SubclassTracking
#recursive_subclasses, #subclasses
Methods included from SettingsAsMethods
Constructor Details
Instance Attribute Details
#as_json ⇒ Object (readonly)
Returns the value of attribute as_json.
80 81 82 |
# File 'lib/kennel/models/record.rb', line 80 def as_json @as_json end |
#project ⇒ Object (readonly)
Returns the value of attribute project.
80 81 82 |
# File 'lib/kennel/models/record.rb', line 80 def project @project end |
Class Method Details
.api_resource_map ⇒ Object
47 48 49 |
# File 'lib/kennel/models/record.rb', line 47 def api_resource_map subclasses.to_h { |s| [s.api_resource, s] } end |
.parse_any_url(url) ⇒ Object
39 40 41 42 43 44 45 |
# File 'lib/kennel/models/record.rb', line 39 def parse_any_url(url) subclasses.detect do |s| if id = s.parse_url(url) break s.api_resource, id end end end |
.parse_tracking_id(a) ⇒ Object
51 52 53 |
# File 'lib/kennel/models/record.rb', line 51 def parse_tracking_id(a) a[self::TRACKING_FIELD].to_s[/-- #{Regexp.escape(MARKER_TEXT)} (#{ALLOWED_KENNEL_ID_FULL})/, 1] end |
.remove_tracking_id(a) ⇒ Object
TODO: combine with parse into a single method or a single regex
56 57 58 59 60 61 |
# File 'lib/kennel/models/record.rb', line 56 def remove_tracking_id(a) value = a[self::TRACKING_FIELD] a[self::TRACKING_FIELD] = value.dup.sub!(/\n?-- #{Regexp.escape(MARKER_TEXT)} .*/, "") || raise("did not find tracking id in #{value}") end |
Instance Method Details
#add_tracking_id ⇒ Object
115 116 117 118 119 120 121 122 123 |
# File 'lib/kennel/models/record.rb', line 115 def add_tracking_id json = as_json if self.class.parse_tracking_id(json) raise "#{safe_tracking_id} Remove \"-- #{MARKER_TEXT}\" line from #{self.class::TRACKING_FIELD} to copy a resource" end json[self.class::TRACKING_FIELD] = "#{json[self.class::TRACKING_FIELD]}\n" \ "-- #{MARKER_TEXT} #{tracking_id} in #{project.class.file_location}, do not modify manually".lstrip end |
#build ⇒ Object
135 136 137 138 139 140 |
# File 'lib/kennel/models/record.rb', line 135 def build @as_json = build_json (id = @as_json.delete(:id)) && @as_json[:id] = id validate_json(@as_json) @as_json end |
#build_json ⇒ Object
129 130 131 132 133 |
# File 'lib/kennel/models/record.rb', line 129 def build_json { id: id }.compact end |
#diff(actual) ⇒ Object
88 89 90 91 92 93 94 95 96 97 98 99 100 |
# File 'lib/kennel/models/record.rb', line 88 def diff(actual) expected = as_json expected.delete(:id) self.class.send(:normalize, expected, actual) return [] if actual == expected # Hashdiff is slow, this is fast # strict: ignore Integer vs Float # similarity: show diff when not 100% similar # use_lcs: saner output Hashdiff.diff(actual, expected, use_lcs: false, strict: false, similarity: 1) end |
#invalid_update!(field, old_value, new_value) ⇒ Object
146 147 148 |
# File 'lib/kennel/models/record.rb', line 146 def invalid_update!(field, old_value, new_value) raise DisallowedUpdateError, "#{safe_tracking_id} Datadog does not allow update of #{field} (#{old_value.inspect} -> #{new_value.inspect})" end |
#remove_tracking_id ⇒ Object
125 126 127 |
# File 'lib/kennel/models/record.rb', line 125 def remove_tracking_id self.class.remove_tracking_id(as_json) end |
#resolve_linked_tracking_ids! ⇒ Object
112 113 |
# File 'lib/kennel/models/record.rb', line 112 def resolve_linked_tracking_ids!(*) end |
#safe_tracking_id ⇒ Object
For use during error handling
151 152 153 154 155 |
# File 'lib/kennel/models/record.rb', line 151 def safe_tracking_id tracking_id rescue StandardError "<unknown; #tracking_id crashed>" end |
#tracking_id ⇒ Object
102 103 104 105 106 107 108 109 110 |
# File 'lib/kennel/models/record.rb', line 102 def tracking_id @tracking_id ||= begin id = "#{project.kennel_id}:#{kennel_id}" unless id.match?(ALLOWED_KENNEL_ID_REGEX) # <-> parse_tracking_id raise "Bad kennel/tracking id: #{id.inspect} must match #{ALLOWED_KENNEL_ID_REGEX}" end id end end |
#validate_update!(_diffs) ⇒ Object
Can raise DisallowedUpdateError
143 144 |
# File 'lib/kennel/models/record.rb', line 143 def validate_update!(_diffs) end |