serega 0.34.0 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bbda67f020296ab580f7cde1b9f867c5ab68b84f3c4cfa9c7f7517d87367640b
-  data.tar.gz: bfea118712593fc12ea96bdea8dd3d8245bf01239474b6a034d408f1fdf04342
+  metadata.gz: a32fcd6506959b5498ef6357c27110bd7623d0bf16e28d0485703016704e6cf4
+  data.tar.gz: 4e2bf60aba2c1db746587b1135a3d852e34858606ac30c6947c960d4e2dba726
 SHA512:
-  metadata.gz: 29d6e54cd973362751eda5533765cb44d8dac8621b77f335956de25d85e436e8c71889c72d4bb599a2114f98b9e2bc459c66f3a24f1e3e44441230ca32f923e3
-  data.tar.gz: bf4ea013fbd1a69e8c742964116834ae3bd4d5c4dc8dd62dd864acfcc53268277fb187a3b4f0b9a6cfb077464e6f24e4fd6222d54e6a54c53054775fe2c1707f
+  metadata.gz: 8cb7d76c325320e144dd7de3dcfc376a03386a7742f7eea68cae1bbb421b0cbe969e2c858fbae253114bbb3ed86e63d4c689395976ac94463813a8229ae66f9e
+  data.tar.gz: e4595313b09bb2fcb7f37c6e26ebe9376a5caf86c66ed2ab4a19091aae854f1c51fafd0adea54cae0ac97eeb69e770e74f7e66d1aee44a8714d50ae225b8683a

data/README.md

@@ -761,27 +761,50 @@ end
 
 ### Plugin :presenter
 
-Helps to write clean code by using a Presenter class.
+Moves computed attribute logic out of blocks and into a dedicated `Presenter` class,
+keeping serializers readable as schemas rather than bags of lambdas.
+
+Without the plugin, computed attributes live as inline blocks:
+
+```ruby
+class UserSerializer < Serega
+  attribute :name, value: proc { |u| [u.first_name, u.last_name].compact.join(' ') }
+  attribute :role, value: proc { |u, ctx| u == ctx[:current_user] ? :self : :other }
+end
+```
+
+With the plugin, they move into a clean class:
 
 ```ruby
 class UserSerializer < Serega
   plugin :presenter
 
   attribute :name
-  attribute :address
+  attribute :role
 
   class Presenter
     def name
-      [first_name, last_name].compact_blank.join(' ')
+      [first_name, last_name].compact.join(' ')
     end
 
-    def address
-      [country, city, address].join("\n")
+    def role
+      id == __ctx__[:current_user_id] ? :self : :other
     end
   end
 end
 ```
 
+`Presenter` inherits from `SimpleDelegator`, so every method of the serialized
+object is available directly inside presenter methods. Any method not explicitly
+defined on `Presenter` is resolved via `method_missing` on the first call, which
+also defines a real delegator method — so all subsequent serializations call it
+directly, without going through `method_missing` again.
+
+The original wrapped object is accessible via `__getobj__` (standard
+`SimpleDelegator` API) when you need an unambiguous reference to it.
+
+The serialization context is accessible via the private method `__ctx__`.
+
 ### Plugin :string_modifiers
 
 Allows to specify modifiers as strings.

data/VERSION

@@ -1 +1 @@
-0.34.0
+0.35.0

data/lib/serega/plugins/presenter/presenter.rb

@@ -6,16 +6,28 @@ require "forwardable"
 class Serega
   module SeregaPlugins
     #
-    # Plugin Presenter adds possibility to use declare Presenter for your objects inside serializer
+    # Plugin :presenter — moves computed attribute logic into a dedicated Presenter class.
     #
-    #   class User < Serega
+    # Presenter inherits from SimpleDelegator:
+    # - All methods of the serialized object are available directly inside presenter methods.
+    # - Methods not defined on Presenter are resolved via method_missing on the first call
+    #   and then defined as real delegators, so subsequent calls skip method_missing entirely.
+    # - The original object is accessible via __getobj__ (standard SimpleDelegator API).
+    # - The serialization context is accessible via the private method __ctx__.
+    #
+    #   class UserSerializer < Serega
     #     plugin :presenter
     #
     #     attribute :name
+    #     attribute :role
     #
     #     class Presenter
     #       def name
-    #         [first_name, last_name].compact_blank.join(' ')
+    #         [first_name, last_name].compact.join(' ') # first_name/last_name delegated to object
+    #       end
+    #
+    #       def role
+    #         id == __ctx__[:current_user_id] ? :self : :other
     #       end
     #     end
     #   end
@@ -56,6 +68,19 @@ class Serega
       class Presenter < SimpleDelegator
         # Presenter instance methods
         module InstanceMethods
+          #
+          # @param object [Object] Serialized object to wrap
+          # @param ctx [Hash, nil] Serialization context
+          #
+          def initialize(object, ctx = nil)
+            super(object)
+            @__ctx__ = ctx
+          end
+
+          private
+
+          attr_reader :__ctx__
+
           #
           # Delegates all missing methods to serialized object.
           #
@@ -100,10 +125,10 @@ class Serega
         private
 
         #
-        # Replaces serialized object with Presenter.new(object)
+        # Replaces serialized object with Presenter.new(object, ctx)
         #
         def serialize_object(object)
-          object = self.class.serializer_class::Presenter.new(object)
+          object = self.class.serializer_class::Presenter.new(object, context)
           super
         end
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: serega
 version: !ruby/object:Gem::Version
-  version: 0.34.0
+  version: 0.35.0
 platform: ruby
 authors:
 - Andrey Glushkov
@@ -121,7 +121,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.9
+rubygems_version: 4.0.11
 specification_version: 4
 summary: JSON Serializer
 test_files: []