serega 0.21.0 → 0.30.0

data/lib/serega/validations/initiate/check_modifiers.rb

@@ -71,7 +71,7 @@ class Serega
 
         def build_full_attribute_name(*names)
           head, *nested = *names
-          result = head.to_s # names are symbols, we need not frozen string
+          result = +head.to_s # names are symbols, we need not frozen string
           nested.each { |nested_name| result << "(" << nested_name.to_s }
           nested.each { result << ")" }
           result

data/lib/serega.rb

@@ -17,15 +17,22 @@ require_relative "serega/errors"
 require_relative "serega/helpers/serializer_class_helper"
 require_relative "serega/utils/enum_deep_dup"
 require_relative "serega/utils/enum_deep_freeze"
-require_relative "serega/utils/params_count"
+require_relative "serega/utils/format_user_preloads"
+require_relative "serega/utils/method_signature"
+require_relative "serega/utils/preload_paths"
+require_relative "serega/utils/preloads_constructor"
 require_relative "serega/utils/symbol_name"
 require_relative "serega/utils/to_hash"
 require_relative "serega/json/adapter"
 
 require_relative "serega/attribute"
 require_relative "serega/attribute_normalizer"
+require_relative "serega/batch/attribute_loader"
+require_relative "serega/batch/attribute_loaders"
+require_relative "serega/batch/auto_resolver"
+require_relative "serega/batch/auto_resolver_factory"
+require_relative "serega/batch/loader"
 require_relative "serega/validations/utils/check_allowed_keys"
-require_relative "serega/validations/utils/check_extra_keyword_arg"
 require_relative "serega/validations/utils/check_opt_is_bool"
 require_relative "serega/validations/utils/check_opt_is_hash"
 require_relative "serega/validations/utils/check_opt_is_string_or_symbol"
@@ -34,13 +41,17 @@ require_relative "serega/validations/attribute/check_name"
 require_relative "serega/validations/attribute/check_opt_const"
 require_relative "serega/validations/attribute/check_opt_hide"
 require_relative "serega/validations/attribute/check_opt_delegate"
+require_relative "serega/validations/attribute/check_opt_batch"
 require_relative "serega/validations/attribute/check_opt_many"
 require_relative "serega/validations/attribute/check_opt_method"
+require_relative "serega/validations/attribute/check_opt_preload"
+require_relative "serega/validations/attribute/check_opt_preload_path"
 require_relative "serega/validations/attribute/check_opt_serializer"
 require_relative "serega/validations/attribute/check_opt_value"
 require_relative "serega/validations/initiate/check_modifiers"
 require_relative "serega/validations/check_attribute_params"
 require_relative "serega/validations/check_initiate_params"
+require_relative "serega/validations/check_batch_loader_params"
 require_relative "serega/validations/check_serialize_params"
 
 require_relative "serega/config"
@@ -67,6 +78,21 @@ class Serega
   check_serialize_params_class.serializer_class = self
   const_set(:CheckSerializeParams, check_serialize_params_class)
 
+  # Validates `Serializer.batch_loader` params
+  check_batch_loader_params_class = Class.new(SeregaValidations::CheckBatchLoaderParams)
+  check_batch_loader_params_class.serializer_class = self
+  const_set(:CheckBatchLoaderParams, check_batch_loader_params_class)
+
+  # Assigns `SeregaBatchLoader` constant to current class
+  batch_loader_class = Class.new(SeregaBatch::Loader)
+  batch_loader_class.serializer_class = self
+  const_set(:SeregaBatchLoader, batch_loader_class)
+
+  # Assigns `SeregaBatchAttributeLoader` constant to current class
+  batch_attribute_loader_class = Class.new(SeregaBatch::AttributeLoader)
+  batch_attribute_loader_class.serializer_class = self
+  const_set(:SeregaBatchAttributeLoader, batch_attribute_loader_class)
+
   #
   # Serializers class methods
   #
@@ -128,6 +154,15 @@ class Serega
       @attributes ||= {}
     end
 
+    #
+    # Lists batch loaders
+    #
+    # @return [Hash] batch loaders list
+    #
+    def batch_loaders
+      @batch_loaders ||= {}
+    end
+
     #
     # Adds attribute
     #
@@ -145,6 +180,41 @@ class Serega
       attributes[attribute.name] = attribute
     end
 
+    #
+    # Defines a batch loader
+    #
+    # @example
+    #   batch_loader :tags, PostTagsLoader
+    #
+    # @example with block
+    #   batch_loader(:tags) do |posts|
+    #     Tags.where(post: posts).group(:post_id).pluck(:post_id, Arel.sql('ARRAY_AGG(tags.tag ORDER BY tag)')).to_h
+    #   end
+    #
+    #   attribute :tags, batch: :tags, value: { |post, batch:| batch[:tags][post.id] }
+    #
+    # @example with context
+    #   batch_loader(:tags) do |posts, ctx:|
+    #     next {} if ctx[:bot]
+    #
+    #     Tags.where(post: posts).group(:post_id).pluck(:post_id, Arel.sql('ARRAY_AGG(tags.tag ORDER BY tag)')).to_h
+    #   end
+    #
+    #   attribute :tags, batch: :tags, value: { |post, batch:| batch[:tags][post.id] }
+    #
+    # @param name [Symbol] A batch loader name
+    # @param value [#call] Batch loader
+    # @param block [Proc] Batch loader
+    #
+    # @return [#call] Batch loader
+    #
+    def batch_loader(name, value = nil, &block)
+      raise SeregaError, "Batch loader must be defined with a callable value or block" if (value && block) || (!value && !block)
+
+      batch_loader = self::SeregaBatchLoader.new(name: name, block: value || block)
+      batch_loaders[batch_loader.name] = batch_loader
+    end
+
     #
     # Serializes provided object to Hash
     #
@@ -232,7 +302,6 @@ class Serega
     private
 
     # Patched in:
-    # - plugin :batch (defines SeregaBatchLoaders, SeregaBatchLoader)
     # - plugin :metadata (defines MetaAttribute and copies meta_attributes to subclasses)
     # - plugin :presenter (defines Presenter)
     def inherited(subclass)
@@ -257,6 +326,14 @@ class Serega
       plan_point_class.serializer_class = subclass
       subclass.const_set(:SeregaPlanPoint, plan_point_class)
 
+      batch_loader_class = Class.new(self::SeregaBatchLoader)
+      batch_loader_class.serializer_class = subclass
+      subclass.const_set(:SeregaBatchLoader, batch_loader_class)
+
+      batch_attribute_loader_class = Class.new(self::SeregaBatchAttributeLoader)
+      batch_attribute_loader_class.serializer_class = subclass
+      subclass.const_set(:SeregaBatchAttributeLoader, batch_attribute_loader_class)
+
       object_serializer_class = Class.new(self::SeregaObjectSerializer)
       object_serializer_class.serializer_class = subclass
       subclass.const_set(:SeregaObjectSerializer, object_serializer_class)
@@ -273,12 +350,21 @@ class Serega
       check_serialize_params_class.serializer_class = subclass
       subclass.const_set(:CheckSerializeParams, check_serialize_params_class)
 
+      check_batch_loader_params_class = Class.new(self::CheckBatchLoaderParams)
+      check_batch_loader_params_class.serializer_class = self
+      subclass.const_set(:CheckBatchLoaderParams, check_batch_loader_params_class)
+
       # Assign same attributes
       attributes.each_value do |attr|
         params = attr.initials
         subclass.attribute(params[:name], **params[:opts], &params[:block])
       end
 
+      # Assign same batch loaders
+      batch_loaders.each_value do |loader|
+        subclass.batch_loader(loader.name, loader.block)
+      end
+
       super
     end
   end
@@ -340,6 +426,11 @@ class Serega
       call(object, opts)
     end
 
+    # @return [Hash] merged preloads of all serialized attributes
+    def preloads
+      @preloads ||= SeregaUtils::PreloadsConstructor.call(plan)
+    end
+
     #
     # Serializes provided object to JSON string
     #
@@ -397,14 +488,14 @@ class Serega
 
     # Patched in:
     # - plugin :activerecord_preloads (loads defined :preloads to object)
-    # - plugin :batch (runs serialization of collected batches)
     # - plugin :root (wraps result `{ root => result }`)
     # - plugin :context_metadata (adds context metadata to final result)
     # - plugin :metadata (adds metadata to final result)
     def serialize(object, opts)
-      self.class::SeregaObjectSerializer
-        .new(**opts, plan: plan)
-        .serialize(object)
+      batch_loaders = plan.has_batch_points ? SeregaBatch::AttributeLoaders.new : nil
+      result = self.class::SeregaObjectSerializer.new(**opts, batch_loaders: batch_loaders, plan: plan).serialize(object)
+      batch_loaders&.load_all(opts[:context])
+      result
     end
   end
 

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: serega
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.30.0
 platform: ruby
 authors:
 - Andrey Glushkov
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-18 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: |
   JSON Serializer
@@ -30,6 +29,11 @@ files:
 - lib/serega.rb
 - lib/serega/attribute.rb
 - lib/serega/attribute_normalizer.rb
+- lib/serega/batch/attribute_loader.rb
+- lib/serega/batch/attribute_loaders.rb
+- lib/serega/batch/auto_resolver.rb
+- lib/serega/batch/auto_resolver_factory.rb
+- lib/serega/batch/loader.rb
 - lib/serega/config.rb
 - lib/serega/errors.rb
 - lib/serega/helpers/serializer_class_helper.rb
@@ -41,24 +45,8 @@ files:
 - lib/serega/plan_point.rb
 - lib/serega/plugins.rb
 - lib/serega/plugins/activerecord_preloads/activerecord_preloads.rb
+- lib/serega/plugins/activerecord_preloads/lib/active_record_objects.rb
 - lib/serega/plugins/activerecord_preloads/lib/preloader.rb
-- lib/serega/plugins/batch/batch.rb
-- lib/serega/plugins/batch/lib/batch_config.rb
-- lib/serega/plugins/batch/lib/loader.rb
-- lib/serega/plugins/batch/lib/loaders.rb
-- lib/serega/plugins/batch/lib/modules/attribute.rb
-- lib/serega/plugins/batch/lib/modules/attribute_normalizer.rb
-- lib/serega/plugins/batch/lib/modules/check_attribute_params.rb
-- lib/serega/plugins/batch/lib/modules/config.rb
-- lib/serega/plugins/batch/lib/modules/object_serializer.rb
-- lib/serega/plugins/batch/lib/modules/plan_point.rb
-- lib/serega/plugins/batch/lib/plugins_extensions/activerecord_preloads.rb
-- lib/serega/plugins/batch/lib/plugins_extensions/formatters.rb
-- lib/serega/plugins/batch/lib/plugins_extensions/if.rb
-- lib/serega/plugins/batch/lib/plugins_extensions/preloads.rb
-- lib/serega/plugins/batch/lib/validations/check_batch_opt_id_method.rb
-- lib/serega/plugins/batch/lib/validations/check_batch_opt_loader.rb
-- lib/serega/plugins/batch/lib/validations/check_opt_batch.rb
 - lib/serega/plugins/camel_case/camel_case.rb
 - lib/serega/plugins/context_metadata/context_metadata.rb
 - lib/serega/plugins/depth_limit/depth_limit.rb
@@ -79,42 +67,36 @@ files:
 - lib/serega/plugins/metadata/validations/check_opt_value.rb
 - lib/serega/plugins/metadata/validations/check_opts.rb
 - lib/serega/plugins/metadata/validations/check_path.rb
-- lib/serega/plugins/preloads/lib/format_user_preloads.rb
-- lib/serega/plugins/preloads/lib/modules/attribute.rb
-- lib/serega/plugins/preloads/lib/modules/attribute_normalizer.rb
-- lib/serega/plugins/preloads/lib/modules/check_attribute_params.rb
-- lib/serega/plugins/preloads/lib/modules/config.rb
-- lib/serega/plugins/preloads/lib/modules/plan_point.rb
-- lib/serega/plugins/preloads/lib/preload_paths.rb
-- lib/serega/plugins/preloads/lib/preloads_config.rb
-- lib/serega/plugins/preloads/lib/preloads_constructor.rb
-- lib/serega/plugins/preloads/preloads.rb
-- lib/serega/plugins/preloads/validations/check_opt_preload.rb
-- lib/serega/plugins/preloads/validations/check_opt_preload_path.rb
 - lib/serega/plugins/presenter/presenter.rb
 - lib/serega/plugins/root/root.rb
 - lib/serega/plugins/string_modifiers/parse_string_modifiers.rb
 - lib/serega/plugins/string_modifiers/string_modifiers.rb
 - lib/serega/utils/enum_deep_dup.rb
 - lib/serega/utils/enum_deep_freeze.rb
-- lib/serega/utils/params_count.rb
+- lib/serega/utils/format_user_preloads.rb
+- lib/serega/utils/method_signature.rb
+- lib/serega/utils/preload_paths.rb
+- lib/serega/utils/preloads_constructor.rb
 - lib/serega/utils/symbol_name.rb
 - lib/serega/utils/to_hash.rb
 - lib/serega/validations/attribute/check_block.rb
 - lib/serega/validations/attribute/check_name.rb
+- lib/serega/validations/attribute/check_opt_batch.rb
 - lib/serega/validations/attribute/check_opt_const.rb
 - lib/serega/validations/attribute/check_opt_delegate.rb
 - lib/serega/validations/attribute/check_opt_hide.rb
 - lib/serega/validations/attribute/check_opt_many.rb
 - lib/serega/validations/attribute/check_opt_method.rb
+- lib/serega/validations/attribute/check_opt_preload.rb
+- lib/serega/validations/attribute/check_opt_preload_path.rb
 - lib/serega/validations/attribute/check_opt_serializer.rb
 - lib/serega/validations/attribute/check_opt_value.rb
 - lib/serega/validations/check_attribute_params.rb
+- lib/serega/validations/check_batch_loader_params.rb
 - lib/serega/validations/check_initiate_params.rb
 - lib/serega/validations/check_serialize_params.rb
 - lib/serega/validations/initiate/check_modifiers.rb
 - lib/serega/validations/utils/check_allowed_keys.rb
-- lib/serega/validations/utils/check_extra_keyword_arg.rb
 - lib/serega/validations/utils/check_opt_is_bool.rb
 - lib/serega/validations/utils/check_opt_is_hash.rb
 - lib/serega/validations/utils/check_opt_is_string_or_symbol.rb
@@ -126,7 +108,6 @@ metadata:
   source_code_uri: https://github.com/aglushkov/serega
   documentation_uri: https://www.rubydoc.info/gems/serega
   changelog_uri: https://github.com/aglushkov/serega/blob/master/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -141,8 +122,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
-signing_key:
+rubygems_version: 3.7.1
 specification_version: 4
 summary: JSON Serializer
 test_files: []

data/lib/serega/plugins/batch/batch.rb

@@ -1,168 +0,0 @@
-# frozen_string_literal: true
-
-class Serega
-  module SeregaPlugins
-    #
-    # Plugin `:batch`
-    #
-    # Must be used to omit N+1 when loading attributes values.
-    #
-    # @example Quick example
-    #
-    #   class AppSerializer
-    #     plugin :batch, id_method: :id
-    #   end
-    #
-    #   class UserSerializer < AppSerializer
-    #     attribute :comments_count, batch: { loader: CommentsCountBatchLoader }, default: 0
-    #     attribute :company, serializer: CompanySerializer, batch: { loader: UserCompanyBatchLoader }
-    #   end
-    #
-    module Batch
-      # Returns plugin name
-      # @return [Symbol] Plugin name
-      def self.plugin_name
-        :batch
-      end
-
-      # Checks requirements to load plugin
-      #
-      # @param serializer_class [Class<Serega>] Current serializer class
-      # @param opts [Hash] plugin options
-      #
-      # @return [void]
-      #
-      def self.before_load_plugin(serializer_class, **opts)
-        allowed_keys = %i[auto_hide id_method]
-        opts.each_key do |key|
-          next if allowed_keys.include?(key)
-
-          raise SeregaError,
-            "Plugin #{plugin_name.inspect} does not accept the #{key.inspect} option. Allowed options:\n" \
-            "  - :auto_hide [Boolean] - Marks attribute as hidden when it has :batch loader specified\n" \
-            "  - :id_method [Symbol, #call] - Specified the default method to use to find object identifier"
-        end
-      end
-
-      #
-      # Applies plugin code to specific serializer
-      #
-      # @param serializer_class [Class<Serega>] Current serializer class
-      # @param _opts [Hash] Plugin options
-      #
-      # @return [void]
-      #
-      def self.load_plugin(serializer_class, **_opts)
-        require_relative "lib/batch_config"
-        require_relative "lib/loader"
-        require_relative "lib/loaders"
-        require_relative "lib/modules/attribute"
-        require_relative "lib/modules/attribute_normalizer"
-        require_relative "lib/modules/check_attribute_params"
-        require_relative "lib/modules/config"
-        require_relative "lib/modules/object_serializer"
-        require_relative "lib/modules/plan_point"
-        require_relative "lib/validations/check_batch_opt_id_method"
-        require_relative "lib/validations/check_batch_opt_loader"
-        require_relative "lib/validations/check_opt_batch"
-
-        serializer_class.extend(ClassMethods)
-        serializer_class.include(InstanceMethods)
-        serializer_class::CheckAttributeParams.include(CheckAttributeParamsInstanceMethods)
-        serializer_class::SeregaAttribute.include(AttributeInstanceMethods)
-        serializer_class::SeregaAttributeNormalizer.include(AttributeNormalizerInstanceMethods)
-        serializer_class::SeregaPlanPoint.include(PlanPointInstanceMethods)
-        serializer_class::SeregaObjectSerializer.include(SeregaObjectSerializerInstanceMethods)
-      end
-
-      #
-      # Runs callbacks after plugin was attached
-      #
-      # @param serializer_class [Class<Serega>] Current serializer class
-      # @param opts [Hash] Plugin options
-      #
-      # @return [void]
-      #
-      def self.after_load_plugin(serializer_class, **opts)
-        serializer_class::SeregaConfig.include(ConfigInstanceMethods)
-
-        batch_loaders_class = Class.new(SeregaBatchLoaders)
-        batch_loaders_class.serializer_class = serializer_class
-        serializer_class.const_set(:SeregaBatchLoaders, batch_loaders_class)
-
-        batch_loader_class = Class.new(SeregaBatchLoader)
-        batch_loader_class.serializer_class = serializer_class
-        serializer_class.const_set(:SeregaBatchLoader, batch_loader_class)
-
-        if serializer_class.plugin_used?(:activerecord_preloads)
-          require_relative "lib/plugins_extensions/activerecord_preloads"
-          serializer_class::SeregaBatchLoader.include(PluginsExtensions::ActiveRecordPreloads::BatchLoaderInstanceMethods)
-        end
-
-        if serializer_class.plugin_used?(:formatters)
-          require_relative "lib/plugins_extensions/formatters"
-          serializer_class::SeregaBatchLoader.include(PluginsExtensions::Formatters::BatchLoaderInstanceMethods)
-          serializer_class::SeregaAttribute.include(PluginsExtensions::Formatters::SeregaAttributeInstanceMethods)
-        end
-
-        if serializer_class.plugin_used?(:if)
-          require_relative "lib/plugins_extensions/if"
-          serializer_class::SeregaObjectSerializer.include(PluginsExtensions::If::ObjectSerializerInstanceMethods123)
-        end
-
-        if serializer_class.plugin_used?(:preloads)
-          require_relative "lib/plugins_extensions/preloads"
-          serializer_class::SeregaAttributeNormalizer.include(PluginsExtensions::Preloads::AttributeNormalizerInstanceMethods)
-        end
-
-        config = serializer_class.config
-        config.attribute_keys << :batch
-        config.opts[:batch] = {loaders: {}, id_method: nil, auto_hide: false}
-        config.batch.auto_hide = opts[:auto_hide] if opts.key?(:auto_hide)
-        config.batch.id_method = opts[:id_method] if opts.key?(:id_method)
-      end
-
-      #
-      # Serega class additional/patched class methods
-      #
-      # @see Serega::SeregaConfig
-      #
-      module ClassMethods
-        private
-
-        def inherited(subclass)
-          super
-
-          batch_loaders_class = Class.new(self::SeregaBatchLoaders)
-          batch_loaders_class.serializer_class = subclass
-          subclass.const_set(:SeregaBatchLoaders, batch_loaders_class)
-
-          batch_loader_class = Class.new(self::SeregaBatchLoader)
-          batch_loader_class.serializer_class = subclass
-          subclass.const_set(:SeregaBatchLoader, batch_loader_class)
-        end
-      end
-
-      #
-      # Serega additional/patched instance methods
-      #
-      # @see Serega::InstanceMethods
-      #
-      module InstanceMethods
-        private
-
-        #
-        # Loads batch loaded attributes after serialization
-        #
-        def serialize(object, opts)
-          batch_loaders = opts[:batch_loaders] = self.class::SeregaBatchLoaders.new
-          result = super
-          batch_loaders.load_all
-          result
-        end
-      end
-    end
-
-    register_plugin(Batch.plugin_name, Batch)
-  end
-end

data/lib/serega/plugins/batch/lib/batch_config.rb

@@ -1,77 +0,0 @@
-# frozen_string_literal: true
-
-class Serega
-  module SeregaPlugins
-    module Batch
-      #
-      # Batch plugin config
-      #
-      class BatchConfig
-        attr_reader :opts
-
-        def initialize(opts)
-          @opts = opts
-        end
-
-        #
-        # Defines batch loader
-        #
-        # @param loader_name [Symbol] Batch loader name, that is used when defining attribute with batch loader.
-        # @param block [Proc] Block that can accept 3 parameters - ids, context, plan_point
-        #   and returns hash with ids as keys and values are batch loaded objects
-        #
-        # @return [void]
-        #
-        def define(loader_name, callable = nil, &block)
-          if (!callable && !block) || (callable && block)
-            raise SeregaError, "Batch loader can be specified with one of arguments - callable value or &block"
-          end
-
-          callable ||= block
-          SeregaValidations::Utils::CheckExtraKeywordArg.call(callable, "batch loader `#{loader_name}`")
-          params_count = SeregaUtils::ParamsCount.call(callable, max_count: 3)
-
-          if params_count > 3
-            raise SeregaError, "Batch loader can have maximum 3 parameters (ids, context, plan)"
-          end
-
-          loaders[loader_name] = callable
-        end
-
-        # Shows defined loaders
-        # @return [Hash] defined loaders
-        def loaders
-          opts[:loaders]
-        end
-
-        # Shows option to auto hide attributes with :batch specified
-        # @return [Boolean, nil] option value
-        def auto_hide
-          opts[:auto_hide]
-        end
-
-        # @param value [Boolean] New :auto_hide option value
-        # @return [Boolean] New option value
-        def auto_hide=(value)
-          raise SeregaError, "Must have boolean value, #{value.inspect} provided" if (value != true) && (value != false)
-          opts[:auto_hide] = value
-        end
-
-        # Shows method name or callable object needed to get object identifier for batch load
-        # @return [Symbol, #call, nil] Default method name or callable object to get identifier
-        def id_method
-          opts[:id_method]
-        end
-
-        # Sets new identifier method name or callable value needed for batch loading
-        #
-        # @param value [Symbol, #call] New :id_method value
-        # @return [Boolean] New option value
-        def id_method=(value)
-          CheckBatchOptIdMethod.call(value)
-          opts[:id_method] = value
-        end
-      end
-    end
-  end
-end

data/lib/serega/plugins/batch/lib/loader.rb

@@ -1,113 +0,0 @@
-# frozen_string_literal: true
-
-class Serega
-  module SeregaPlugins
-    module Batch
-      #
-      # Encapsulates point and according object_serializer
-      #   so we can put batch loaded values to this serializer response
-      #
-      class SeregaBatchLoader
-        #
-        # Batch Loader instance methods
-        #
-        module InstanceMethods
-          # @return [Serega::SeregaPlanPoint]
-          attr_reader :point
-
-          # @return [Serega::SeregaObjectSerializer]
-          attr_reader :object_serializer
-
-          #
-          # Initializes new SeregaBatchLoader
-          #
-          # @param object_serializer [Serega::SeregaObjectSerializer]
-          # @param point [Serega::SeregaPlanPoint]
-          #
-          # @return [Serega::SeregaPlugins::Batch::SeregaBatchLoader]
-          #
-          def initialize(object_serializer, point)
-            @object_serializer = object_serializer
-            @point = point
-          end
-
-          #
-          # Remembers key and hash container where value for this key must be inserted
-          #
-          # @param key [Object] key that identifies batch loaded objects
-          # @param container [Hash] container where batch loaded objects must be attached
-          #
-          # @return [void]
-          #
-          def remember(key, container)
-            (keys[key] ||= []) << container
-          end
-
-          #
-          # Loads this batch and assigns values to remembered containers
-          #
-          # @return [void]
-          #
-          def load
-            keys_values = keys_values()
-
-            each_key do |key, container|
-              value = keys_values.fetch(key) { point.batch[:default] }
-              final_value = object_serializer.__send__(:final_value, value, point)
-              object_serializer.__send__(:attach_final_value, final_value, point, container)
-            end
-          end
-
-          private
-
-          def keys
-            @keys ||= {}
-          end
-
-          def each_key
-            keys.each do |key, containers|
-              containers.each do |container|
-                yield(key, container)
-              end
-            end
-          end
-
-          # Patched in:
-          # - plugin batch (extension :activerecord_preloads - preloads data to found values)
-          # - plugin batch (extension :formatters - formats values)
-          def keys_values
-            ids = keys.keys
-
-            keys_values = load_keys_values(ids)
-            validate(keys_values)
-
-            keys_values
-          end
-
-          def load_keys_values(ids)
-            point.batch[:loader].call(ids, object_serializer.context, point)
-          rescue => error
-            raise reraise_with_serialized_attribute_details(error, point)
-          end
-
-          def validate(keys_values)
-            return if keys_values.is_a?(Hash)
-
-            attribute_name = "#{point.class.serializer_class}.#{point.name}"
-            raise SeregaError, "Batch loader for `#{attribute_name}` must return Hash, but #{keys_values.inspect} was returned"
-          end
-
-          def reraise_with_serialized_attribute_details(error, point)
-            raise error.exception(<<~MESSAGE.strip)
-              #{error.message}
-              (when serializing '#{point.name}' attribute in #{self.class.serializer_class})
-            MESSAGE
-          end
-        end
-
-        include InstanceMethods
-        extend Serega::SeregaHelpers::SerializerClassHelper
-      end
-    end
-  end
-end