serega 0.37.0 → 0.37.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf4c5f1a34256084ebedcba18d08dcdc30f9a3090ca3b555a7ee91fc8e0dfc44
-  data.tar.gz: 05022337ad49d098c50f25c267f33a2db6c210b169f3243b88c010a5f9bc519e
+  metadata.gz: ca01b1c5668c5ce5963e5f2b71540dae1d023eed44c6e9e026d43e63fcead4c6
+  data.tar.gz: f526d737921efe1789751b51ff15b503b0febe2d5aafbb1a57666625a14b2228
 SHA512:
-  metadata.gz: a9b5a2797086500903904617124810a4401f0a223ea75ba88d78c6cf3cba90157e9ff666f54fd76183fbbed4ab54d7be33704fd7c45665537e825f5f0f67222c
-  data.tar.gz: 150fcf62d92d01076c61d38a4189a31d789904fc643c2ce06c569280099d598582e3e07b7ff32a3482e0754d47045123dcf7f01baf7f7f65afebe2c1465e3c93
+  metadata.gz: 643c12f65a16dbce5d05a8262df0f85fc6a5055436a65d2590f0615ccba5a9cb2d1287d4ec1262b9d0f252432262e88799b55d13ca7ce5fed252c58faf9b7a1a
+  data.tar.gz: fa8ad847f04617c8ea70cf227aca9bf9ede02c1b1449afb6547b821f09cd8a27638cb5d8904ddc576dfe12c01d5cd6991a99e7cb9fa1cf28d46d2053c7650978

data/README.md

@@ -530,12 +530,12 @@ attribute is serialized:
 
 ```ruby
 class UserSerializer < Serega
+  attribute :name
+  attribute :posts, serializer: PostSerializer, preload: :posts
+
   # `objects` is the gathered users; `preloads` is this attribute's
   # `:preload` value (`:posts`). `MyORM.preload` does the eager loading.
   preload_with { |objects, preloads| MyORM.preload(objects, preloads) }
-
-  attribute :name
-  attribute :posts, serializer: PostSerializer, preload: :posts
 end
 ```
 
@@ -547,6 +547,33 @@ objects can be plain Ruby objects too: the handler decides where the data comes
 from (another ORM, an HTTP API, a cache) and how to attach it to the objects,
 by whatever rules you define.
 
+The handler runs **once per preloaded attribute**, not once per distinct
+`:preload` value. If the same `:preload` is declared on several attributes, the
+handler is invoked once for each of them over the same objects, so it should
+check whether the data is already loaded before loading it again. (The
+`:activerecord_preloads` handler relies on `ActiveRecord::Associations::Preloader`,
+which already skips associations that are loaded.)
+
+Because you choose the `:preload` value, it doubles as a **discriminator**: give
+two attributes different `:preload` values and branch on `preloads` inside the
+handler — no need for the value to be a real association name.
+
+```ruby
+class PostSerializer < Serega
+  attribute :owner,  serializer: UserSerializer, preload: :owner
+  attribute :author, serializer: UserSerializer, preload: :author
+
+  # Both attributes load the same person, but from different sources.
+  preload_with do |objects, preloads|
+    case preloads
+    when :owner  then load_owners(objects)   # e.g. from the DB
+    when :author then load_authors(objects)  # e.g. from an external API
+    else MyORM.preload(objects, preloads)
+    end
+  end
+end
+```
+
 ---
 
 ## Plugins

data/VERSION

@@ -1 +1 @@
-0.37.0
+0.37.1

data/lib/serega/plugins/if/if.rb

@@ -275,8 +275,11 @@ class Serega
           super
         end
 
-        def attach_final_value(value, point, _container)
-          return KEY_SKIPPED unless point.satisfy_if_value_conditions?(value, context)
+        def attach_final_value(value, point, container)
+          unless point.satisfy_if_value_conditions?(value, context)
+            container.delete(point.name) # remove reserved placeholder
+            return KEY_SKIPPED
+          end
 
           super
         end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: serega
 version: !ruby/object:Gem::Version
-  version: 0.37.0
+  version: 0.37.1
 platform: ruby
 authors:
 - Andrey Glushkov