denormalize_fields 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1338ef6e15d6240ad603ee387f23ce8c38057c7055fda8f96a8f1d401ecc0484
-  data.tar.gz: 6ba5dd3b2aaf5bee15865a408a8d15d916c3fc92debec736e0cf1489649ef9bb
+  metadata.gz: f75e3e551412d74ece84cd1369cf35350d9bf089fe1fecb2a635983dae2c8aaf
+  data.tar.gz: 4bb30e1378174f374fddbd41e48857236a1991ee828f7c440b518f910273f870
 SHA512:
-  metadata.gz: 51d0a02e5c2e59f50ac9e5c4a7901ce1d1325d4fba321e1ac23454401e144f8ad0c085f4f54da2ca73a7270db462eeb14225b48b177b5c537a4a64667539922f
-  data.tar.gz: 62a8d6a3a388f560a31bbddcd9e8864901af60efd1ee29a2535c98669006c020890652dca78324a8c5a1795d734e82a36e57995bc341845ac3f3aca02cc970da
+  metadata.gz: d4987aec2cf44f282450b8a6a6aaf2bc80af4ca362c31fcf05320328a9b4cda4db0f3ffda7e2744ce0352bb08b533285d705a2c29a327ac6a499580c58b9d034
+  data.tar.gz: e5460b437851d87fd9be891f10c921e1160e93184a186a97435bc059d32b5a07ce0fe8d9ee50e1724282fe6c0a2e66764bcb250cb79df5f900fb1a11c6516775

data/lib/denormalize_fields/association_extension.rb

@@ -12,10 +12,9 @@ module DenormalizeFields
       return unless options = association.options[OPTION]
 
       DenormalizeFields.denormalize(
-        fields: options[:fields],
-        from:   association.active_record,
-        onto:   association.name,
-        prefix: options[:prefix],
+        from: association.active_record,
+        onto: association.name,
+        **options,
       )
     end
   end

data/lib/denormalize_fields/version.rb

@@ -1,3 +1,3 @@
 module DenormalizeFields
-  VERSION = '1.1.2'
+  VERSION = '1.2.0'
 end

data/lib/denormalize_fields.rb

@@ -4,14 +4,36 @@ require 'denormalize_fields/version'
 module DenormalizeFields
   module_function
 
-  def denormalize(fields:, from:, onto:, prefix: nil)
+  def denormalize(fields:, from:, onto:, prefix: nil, **options)
     mapping = cast_to_mapping(fields, prefix: prefix)
+    validate_options(**options)
 
     from.after_save do
-      DenormalizeFields.call(record: self, relation_name: onto, mapping: mapping)
+      DenormalizeFields.call(
+        record:        self,
+        relation_name: onto,
+        mapping:       mapping,
+        **options,
+      )
     end
   end
 
+  def validate_options(**options)
+    validate_conditional(options[:if])
+    validate_conditional(options[:unless])
+    unsupported = (options.keys - %i[if unless]).empty? ||
+      raise(ArgumentError, "unsupported denormalize options: #{unsupported}")
+  end
+
+  CONDITIONAL_CLASSES = [NilClass, TrueClass, FalseClass, Symbol, Proc]
+
+  def validate_conditional(arg)
+    CONDITIONAL_CLASSES.include?(arg.class) || raise(
+      ArgumentError,
+      "`if:` option must be a #{CONDITIONAL_CLASSES.join('/')}, got: #{arg.class}"
+    )
+  end
+
   def cast_to_mapping(fields, prefix: nil)
     if fields.is_a?(Hash)
       prefix && raise(ArgumentError, 'pass EITHER a fields Hash OR a prefix')
@@ -21,7 +43,10 @@ module DenormalizeFields
     end
   end
 
-  def call(record:, relation_name:, mapping:)
+  def call(record:, relation_name:, mapping:, **options)
+    return unless conditional_passes?(options[:if],     record, false)
+    return unless conditional_passes?(options[:unless], record, true)
+
     changeset = DenormalizeFields.changeset(record: record, mapping: mapping)
     return if changeset.empty?
 
@@ -32,6 +57,21 @@ module DenormalizeFields
     end
   end
 
+  def conditional_passes?(conditional, record, inverted)
+    return true if conditional.nil?
+
+    result =
+      if conditional.respond_to?(:call)
+        record.instance_exec(&conditional)
+      elsif conditional.class == Symbol
+        record.send(conditional)
+      else # true, false
+        conditional
+      end
+
+    inverted ? !result : !!result
+  end
+
   def changeset(record:, mapping:)
     mapping.each.with_object({}) do |(source, dest), hash|
       if source.is_a?(Array)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: denormalize_fields
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.2.0
 platform: ruby
 authors:
 - Janosch Müller
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-12-12 00:00:00.000000000 Z
+date: 2021-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -136,7 +136,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.0
+rubygems_version: 3.2.3
 signing_key:
 specification_version: 4
 summary: Simplify denormalizing fields from one record to another.