vorpal 0.1.0.rc3 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 824912a10087771cda48b9ad66dac75861e80bb1
-  data.tar.gz: 67ff5e87b3e45c8308866036e79cfb83ae5959d8
+SHA256:
+  metadata.gz: 2fdca5b34f5a1ac2b9b228849c53b8322e542ab9bc75a5c15a0c8003f1f1fd94
+  data.tar.gz: aebdb05efdfd853644afa49bf101d845082a7d627e47c50bf609830be46901f0
 SHA512:
-  metadata.gz: 3db514381c185a0dc4b9b4a408ca35b34a244bb1fe97e899ff1b89ebb84d14cd20d5159c2a459316d77c1e3b4d81e4529e0ff110d02dfdece3f06817531653b1
-  data.tar.gz: 5437e2611a1ae1e75b1143cd1f9732429fa9acb0fb5e11fc105e60bb7d0330fe4e23021ca7c63b676758977fedeafaed2b39f26be24f83b1f431fc5c7ab1a0b2
+  metadata.gz: 1416691727efd279769865a4725949ff41965d120d6431a3737880936838e6760d857c3a5546b5b73774a1ea24cb1ef742d6f7cce6dfa0497de34739ba67b22a
+  data.tar.gz: 117da60ac019fa9b373d7f45ad6893b24de5611533d348034ef4f4d978adc81468d3228d55adf8107482084b219c47509cb8fef69516ae0ccdea31f73e3a0390

data/README.md

@@ -45,8 +45,6 @@ Or install it yourself as:
 
 ## Usage
 
-**Warning! API still in flux! Expect it to change with every release until 0.1.0. After this point, semantic versioning will be used.**
-
 Start with a domain model of POROs and AR::Base objects that form an aggregate:
 
 ```ruby

data/lib/vorpal/db_loader.rb

@@ -1,6 +1,5 @@
 require 'vorpal/loaded_objects'
 require 'vorpal/util/array_hash'
-require 'vorpal/db_driver'
 
 module Vorpal
   # Handles loading of objects from the database.
@@ -13,7 +12,7 @@ module Vorpal
     end
 
     def load_from_db(ids, config)
-      db_roots = @db_driver.load_by_id(config, ids)
+      db_roots = @db_driver.load_by_id(config.db_class, ids)
       load_from_db_objects(db_roots, config)
     end
 
@@ -123,7 +122,7 @@ module Vorpal
 
     def load_all(db_driver)
       return [] if @ids.empty?
-      db_driver.load_by_id(@config, @ids)
+      db_driver.load_by_id(@config.db_class, @ids)
     end
   end
 
@@ -138,7 +137,7 @@ module Vorpal
 
     def load_all(db_driver)
       return [] if @fk_values.empty?
-      db_driver.load_by_foreign_key(@config, @fk_values, @fk_info)
+      db_driver.load_by_foreign_key(@config.db_class, @fk_values, @fk_info)
     end
   end
 end

data/lib/vorpal/driver/postgresql.rb

@@ -0,0 +1,145 @@
+require 'vorpal/util/string_utils.rb'
+
+module Vorpal
+  module Driver
+    # Interface between the database and Vorpal for PostgreSQL using ActiveRecord.
+    class Postgresql
+      def initialize
+        @sequence_names = {}
+      end
+
+      def insert(db_class, db_objects)
+        if defined? ActiveRecord::Import
+          db_class.import(db_objects, validate: false)
+        else
+          db_objects.each do |db_object|
+            db_object.save!(validate: false)
+          end
+        end
+      end
+
+      def update(db_class, db_objects)
+        db_objects.each do |db_object|
+          db_object.save!(validate: false)
+        end
+      end
+
+      def destroy(db_class, ids)
+        db_class.delete_all(id: ids)
+      end
+
+      # Loads instances of the given class by primary key.
+      #
+      # @param db_class [Class] A subclass of ActiveRecord::Base
+      # @return [[Object]] An array of entities.
+      def load_by_id(db_class, ids)
+        db_class.where(id: ids).to_a
+      end
+
+      # Loads instances of the given class whose foreign key has the given value.
+      #
+      # @param db_class [Class] A subclass of ActiveRecord::Base
+      # @param id [Integer] The value of the foreign key to find by. (Can also be an array of ids.)
+      # @param foreign_key_info [ForeignKeyInfo] Meta data for the foreign key.
+      # @return [[Object]] An array of entities.
+      def load_by_foreign_key(db_class, id, foreign_key_info)
+        arel = db_class.where(foreign_key_info.fk_column => id)
+        arel = arel.where(foreign_key_info.fk_type_column => foreign_key_info.fk_type) if foreign_key_info.polymorphic?
+        arel.to_a
+      end
+
+      # Fetches primary key values to be used for new entities.
+      #
+      # @param db_class [Class] A subclass of ActiveRecord::Base
+      # @return [[Integer]] An array of unused primary keys.
+      def get_primary_keys(db_class, count)
+        result = execute("select nextval($1) from generate_series(1,$2);", [sequence_name(db_class), count])
+        result.rows.map(&:first).map(&:to_i)
+      end
+
+      # Builds an ORM Class for accessing data in the given DB table.
+      #
+      # @param model_class [Class] The PORO class that we are creating a DB interface class for.
+      # @param table_name [String] Name of the DB table the DB class should interface with.
+      # @return [Class] ActiveRecord::Base Class
+      def build_db_class(model_class, table_name)
+        db_class = Class.new(ActiveRecord::Base) do
+          class << self
+            # This is overridden for two reasons:
+            # 1) For anonymous classes, #name normally returns nil. Class names in Ruby come from the
+            #   name of the constant they are assigned to.
+            # 2) Because the default implementation for Class#name for anonymous classes is very, very
+            #   slow. https://bugs.ruby-lang.org/issues/11119
+            # Remove this override once #2 has been fixed!
+            def name
+              @name ||= "Vorpal_generated_ActiveRecord__Base_class_for_#{vorpal_model_class_name}"
+            end
+
+            # Overridden because, like #name, the default implementation for anonymous classes is very,
+            # very slow.
+            def to_s
+              name
+            end
+
+            attr_accessor :vorpal_model_class_name
+          end
+        end
+
+        db_class.vorpal_model_class_name = Util::StringUtils.escape_class_name(model_class.name)
+        db_class.table_name = table_name
+        db_class
+      end
+
+      # Builds a composable query object (e.g. ActiveRecord::Relation) with Vorpal methods mixed in
+      # for querying for instances of the given AR::Base class.
+      #
+      # @param db_class [Class] A subclass of ActiveRecord::Base
+      def query(db_class, aggregate_mapper)
+        db_class.unscoped.extending(ArelQueryMethods.new(aggregate_mapper))
+      end
+
+      private
+
+      def sequence_name(db_class)
+        @sequence_names[db_class] ||= execute(
+          "SELECT substring(column_default from '''(.*)''') FROM INFORMATION_SCHEMA.COLUMNS WHERE table_name = $1 AND column_name = 'id' LIMIT 1",
+          [db_class.table_name]
+        ).rows.first.first
+      end
+
+      def execute(sql, binds)
+        binds = binds.map { |row| [nil, row] }
+        ActiveRecord::Base.connection.exec_query(sql, 'SQL', binds)
+      end
+    end
+
+    class ArelQueryMethods < Module
+      def initialize(mapper)
+        @mapper = mapper
+      end
+
+      def extended(descendant)
+        super
+        descendant.extend(Methods)
+        descendant.vorpal_aggregate_mapper = @mapper
+      end
+
+      # Methods in this module will appear on any composable
+      module Methods
+        attr_writer :vorpal_aggregate_mapper
+
+        # See {AggregateMapper#load_many}.
+        def load_many
+          db_roots = self.to_a
+          @vorpal_aggregate_mapper.load_many(db_roots)
+        end
+
+        # See {AggregateMapper#load_one}.
+        def load_one
+          db_root = self.first
+          @vorpal_aggregate_mapper.load_one(db_root)
+        end
+      end
+    end
+  end
+end

data/lib/vorpal/dsl/configuration.rb

@@ -1,5 +1,6 @@
 require 'vorpal/engine'
 require 'vorpal/dsl/config_builder'
+require 'vorpal/driver/postgresql'
 
 module Vorpal
   module Dsl
@@ -9,12 +10,12 @@ module Vorpal
     #
     # @param options [Hash] Global configuration options for the engine instance.
     # @option options [Object] :db_driver (Object that will be used to interact with the DB.)
-    #  Must be duck-type compatible with {DbDriver}.
+    #  Must be duck-type compatible with {Postgresql}.
     #
     # @return [Engine] Instance of the mapping engine.
     def define(options={}, &block)
       master_config = build_config(&block)
-      db_driver = options.fetch(:db_driver, DbDriver.new)
+      db_driver = options.fetch(:db_driver, Driver::Postgresql.new)
       Engine.new(db_driver, master_config)
     end
 
@@ -40,7 +41,7 @@ module Vorpal
 
     # @private
     def build_class_config(domain_class, options={}, &block)
-      builder = ConfigBuilder.new(domain_class, options, DbDriver.new)
+      builder = ConfigBuilder.new(domain_class, options, Driver::Postgresql.new)
       builder.instance_exec(&block) if block_given?
       builder.build
     end
@@ -53,4 +54,4 @@ module Vorpal
     end
   end
   end
-end
+end

data/lib/vorpal/engine.rb

@@ -1,7 +1,6 @@
 require 'vorpal/identity_map'
 require 'vorpal/aggregate_utils'
 require 'vorpal/db_loader'
-require 'vorpal/db_driver'
 require 'vorpal/aggregate_mapper'
 require 'vorpal/exceptions'
 
@@ -80,7 +79,7 @@ module Vorpal
 
       loaded_db_objects = load_owned_from_db(ids, domain_class)
       loaded_db_objects.each do |config, db_objects|
-        @db_driver.destroy(config, db_objects.map(&:id))
+        @db_driver.destroy(config.db_class, db_objects.map(&:id))
       end
       ids
     end
@@ -91,7 +90,7 @@ module Vorpal
     end
 
     def query(domain_class)
-      @db_driver.query(@configs.config_for(domain_class), mapper_for(domain_class))
+      @db_driver.query(@configs.config_for(domain_class).db_class, mapper_for(domain_class))
     end
 
     private
@@ -166,7 +165,7 @@ module Vorpal
     def set_primary_keys(owned_objects, mapping)
       owned_objects.each do |config, objects|
         in_need_of_primary_keys = objects.find_all { |obj| obj.id.nil? }
-        primary_keys = @db_driver.get_primary_keys(config, in_need_of_primary_keys.length)
+        primary_keys = @db_driver.get_primary_keys(config.db_class, in_need_of_primary_keys.length)
         in_need_of_primary_keys.zip(primary_keys).each do |object, primary_key|
           mapping[object].id = primary_key
           object.id = primary_key
@@ -207,11 +206,11 @@ module Vorpal
       owned_objects.each do |config, objects|
         objects_to_insert = grouped_new_objects[config] || []
         db_objects_to_insert = objects_to_insert.map { |obj| mapping[obj] }
-        @db_driver.insert(config, db_objects_to_insert)
+        @db_driver.insert(config.db_class, db_objects_to_insert)
 
         objects_to_update = objects - objects_to_insert
         db_objects_to_update = objects_to_update.map { |obj| mapping[obj] }
-        @db_driver.update(config, db_objects_to_update)
+        @db_driver.update(config.db_class, db_objects_to_update)
       end
     end
 
@@ -221,7 +220,7 @@ module Vorpal
       all_orphans = db_objects_in_db - db_objects_in_aggregate
       grouped_orphans = all_orphans.group_by { |o| @configs.config_for_db_object(o) }
       grouped_orphans.each do |config, orphans|
-        @db_driver.destroy(config, orphans)
+        @db_driver.destroy(config.db_class, orphans)
       end
     end
 
@@ -234,4 +233,4 @@ module Vorpal
       objects.each { |object| object.id = nil }
     end
   end
-end
+end

data/lib/vorpal/version.rb

@@ -1,3 +1,3 @@
 module Vorpal
-  VERSION = "0.1.0.rc3"
+  VERSION = "1.0.0"
 end

data/spec/vorpal/acceptance/aggregate_mapper_spec.rb

@@ -95,7 +95,7 @@ describe 'AggregateMapper' do
 
   describe 'on error' do
     it 'nils ids of new objects' do
-      db_driver = Vorpal::DbDriver.new
+      db_driver = Vorpal::Driver::Postgresql.new
       test_mapper = configure(db_driver: db_driver)
 
       tree_db = db_class_for(Tree, test_mapper).create!

data/spec/vorpal/integration/{db_driver_spec.rb → driver/postgresql_spec.rb}

@@ -1,9 +1,9 @@
 require 'integration_spec_helper'
 require 'vorpal'
 
-describe Vorpal::DbDriver do
+describe Vorpal::Driver::Postgresql do
   describe '#build_db_class' do
-    let(:db_class) { subject.build_db_class(DbDriverSpec::Foo, 'example') }
+    let(:db_class) { subject.build_db_class(PostgresDriverSpec::Foo, 'example') }
 
     it 'generates a valid class name so that rails auto-reloading works' do
       expect { Vorpal.const_defined?(db_class.name) }.to_not raise_error
@@ -14,29 +14,29 @@ describe Vorpal::DbDriver do
     end
 
     it 'isolates two POROs that map to the same db table' do
-      db_class1 = build_db_class(DbDriverSpec::Foo)
-      db_class2 = build_db_class(DbDriverSpec::Bar)
+      db_class1 = build_db_class(PostgresDriverSpec::Foo)
+      db_class2 = build_db_class(PostgresDriverSpec::Bar)
 
       expect(db_class1).to_not eq(db_class2)
       expect(db_class1.name).to_not eq(db_class2.name)
     end
 
     it 'uses the model class name to make the generated AR::Base class name unique' do
-      db_class = build_db_class(DbDriverSpec::Foo)
+      db_class = build_db_class(PostgresDriverSpec::Foo)
 
-      expect(db_class.name).to match("DbDriverSpec__Foo")
+      expect(db_class.name).to match("PostgresDriverSpec__Foo")
     end
   end
 
   private
 
-  module DbDriverSpec
+  module PostgresDriverSpec
     class Foo; end
     class Bar; end
   end
 
   def build_db_class(clazz)
-    db_driver = Vorpal::DbDriver.new
+    db_driver = Vorpal::Driver::Postgresql.new
     db_driver.build_db_class(clazz, 'example')
   end
 end

data/spec/vorpal/unit/db_loader_spec.rb

@@ -54,7 +54,7 @@ describe Vorpal::DbLoader do
   #
   #   master_config = Vorpal::MasterConfig.new([post_config, comment_config])
   #
-  #   driver = Vorpal::DbDriver.new
+  #   driver = Vorpal::Postgresql.new
   #
   #   best_comment_db = CommentDB.create!
   #   post_db = PostDB.create!(best_comment_id: best_comment_db.id)
@@ -90,9 +90,9 @@ describe Vorpal::DbLoader do
     post_db.id = 100
     best_comment_db.post_id = post_db.id
 
-    driver = instance_double("Vorpal::DbDriver")
-    expect(driver).to receive(:load_by_id).with(post_config, [post_db.id]).and_return([post_db])
-    expect(driver).to receive(:load_by_id).with(comment_config, [best_comment_db.id]).and_return([best_comment_db])
+    driver = instance_double("Vorpal::Driver::Postgresql")
+    expect(driver).to receive(:load_by_id).with(PostDB, [post_db.id]).and_return([post_db])
+    expect(driver).to receive(:load_by_id).with(CommentDB, [best_comment_db.id]).and_return([best_comment_db])
     expect(driver).to receive(:load_by_foreign_key).and_return([best_comment_db])
 
     loader = Vorpal::DbLoader.new(false, driver)
@@ -100,4 +100,4 @@ describe Vorpal::DbLoader do
 
     expect(loaded_objects.all_objects).to contain_exactly(post_db, best_comment_db)
   end
-end
+end

data/spec/vorpal/unit/dsl/config_builder_spec.rb

@@ -1,7 +1,6 @@
 require 'unit_spec_helper'
 
 require 'vorpal/dsl/config_builder'
-require 'vorpal/db_driver'
 
 describe Vorpal::Dsl::ConfigBuilder do
   class Tester; end

data/spec/vorpal/unit/dsl/defaults_generator_spec.rb

@@ -1,7 +1,7 @@
 require 'unit_spec_helper'
 
 require 'vorpal/dsl/defaults_generator'
-require 'vorpal/db_driver'
+require 'vorpal/driver/postgresql'
 
 describe Vorpal::Dsl::DefaultsGenerator do
   class Tester; end
@@ -11,7 +11,7 @@ describe Vorpal::Dsl::DefaultsGenerator do
     class Author; end
   end
 
-  let(:db_driver) { instance_double(Vorpal::DbDriver)}
+  let(:db_driver) { instance_double(Vorpal::Driver::Postgresql)}
 
   describe '#build_db_class' do
     it 'derives the table_name from the domain class name' do

data/vorpal.gemspec

@@ -18,6 +18,8 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
+  spec.required_ruby_version = ">= 2.1.6"
+
   spec.add_runtime_dependency "simple_serializer", "~> 1.0"
   spec.add_runtime_dependency "equalizer"
   spec.add_runtime_dependency "activesupport"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vorpal
 version: !ruby/object:Gem::Version
-  version: 0.1.0.rc3
+  version: 1.0.0
 platform: ruby
 authors:
 - Sean Kirby
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-11-11 00:00:00.000000000 Z
+date: 2018-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: simple_serializer
@@ -147,7 +147,6 @@ files:
 - ".editorconfig"
 - ".gitignore"
 - ".rspec"
-- ".ruby-version"
 - ".yardopts"
 - CHANGELOG.md
 - Gemfile
@@ -159,8 +158,8 @@ files:
 - lib/vorpal/aggregate_traversal.rb
 - lib/vorpal/aggregate_utils.rb
 - lib/vorpal/configs.rb
-- lib/vorpal/db_driver.rb
 - lib/vorpal/db_loader.rb
+- lib/vorpal/driver/postgresql.rb
 - lib/vorpal/dsl/config_builder.rb
 - lib/vorpal/dsl/configuration.rb
 - lib/vorpal/dsl/defaults_generator.rb
@@ -177,7 +176,7 @@ files:
 - spec/integration_spec_helper.rb
 - spec/unit_spec_helper.rb
 - spec/vorpal/acceptance/aggregate_mapper_spec.rb
-- spec/vorpal/integration/db_driver_spec.rb
+- spec/vorpal/integration/driver/postgresql_spec.rb
 - spec/vorpal/performance/performance_spec.rb
 - spec/vorpal/unit/configs_spec.rb
 - spec/vorpal/unit/db_loader_spec.rb
@@ -199,15 +198,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.1.6
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.8
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Separate your domain model from your persistence mechanism.
@@ -217,7 +216,7 @@ test_files:
 - spec/integration_spec_helper.rb
 - spec/unit_spec_helper.rb
 - spec/vorpal/acceptance/aggregate_mapper_spec.rb
-- spec/vorpal/integration/db_driver_spec.rb
+- spec/vorpal/integration/driver/postgresql_spec.rb
 - spec/vorpal/performance/performance_spec.rb
 - spec/vorpal/unit/configs_spec.rb
 - spec/vorpal/unit/db_loader_spec.rb

data/.ruby-version

@@ -1 +0,0 @@
-2.1.6

data/lib/vorpal/db_driver.rb

@@ -1,143 +0,0 @@
-require 'vorpal/util/string_utils.rb'
-
-module Vorpal
-  # Interface between the database and Vorpal
-  #
-  # Currently only works for PostgreSQL via ActiveRecord.
-  class DbDriver
-    def initialize
-      @sequence_names = {}
-    end
-
-    def insert(class_config, db_objects)
-      if defined? ActiveRecord::Import
-        class_config.db_class.import(db_objects, validate: false)
-      else
-        db_objects.each do |db_object|
-          db_object.save!(validate: false)
-        end
-      end
-    end
-
-    def update(class_config, db_objects)
-      db_objects.each do |db_object|
-        db_object.save!(validate: false)
-      end
-    end
-
-    def destroy(class_config, ids)
-      class_config.db_class.delete_all(id: ids)
-    end
-
-    # Loads instances of the given class by primary key.
-    #
-    # @param class_config [ClassConfig]
-    # @return [[Object]] An array of entities.
-    def load_by_id(class_config, ids)
-      class_config.db_class.where(id: ids).to_a
-    end
-
-    # Loads instances of the given class whose foreign key has the given value.
-    #
-    # @param class_config [ClassConfig]
-    # @param foreign_key_info [ForeignKeyInfo]
-    # @return [[Object]] An array of entities.
-    def load_by_foreign_key(class_config, id, foreign_key_info)
-      arel = class_config.db_class.where(foreign_key_info.fk_column => id)
-      arel = arel.where(foreign_key_info.fk_type_column => foreign_key_info.fk_type) if foreign_key_info.polymorphic?
-      arel.order(:id).to_a
-    end
-
-    # Fetches primary key values to be used for new entities.
-    #
-    # @param class_config [ClassConfig] Config of the entity whose primary keys are being fetched.
-    # @return [[Integer]] An array of unused primary keys.
-    def get_primary_keys(class_config, count)
-      result = execute("select nextval($1) from generate_series(1,$2);", [sequence_name(class_config), count])
-      result.rows.map(&:first).map(&:to_i)
-    end
-
-    # Builds an ORM Class for accessing data in the given DB table.
-    #
-    # @param model_class [Class] The PORO class that we are creating a DB interface class for.
-    # @param table_name [String] Name of the DB table the DB class should interface with.
-    # @return [Class] ActiveRecord::Base Class
-    def build_db_class(model_class, table_name)
-      db_class = Class.new(ActiveRecord::Base) do
-        class << self
-          # This is overridden for two reasons:
-          # 1) For anonymous classes, #name normally returns nil. Class names in Ruby come from the
-          #   name of the constant they are assigned to.
-          # 2) Because the default implementation for Class#name for anonymous classes is very, very
-          #   slow. https://bugs.ruby-lang.org/issues/11119
-          # Remove this override once #2 has been fixed!
-          def name
-            @name ||= "Vorpal_generated_ActiveRecord__Base_class_for_#{vorpal_model_class_name}"
-          end
-
-          # Overridden because, like #name, the default implementation for anonymous classes is very,
-          # very slow.
-          def to_s
-            name
-          end
-
-          attr_accessor :vorpal_model_class_name
-        end
-      end
-
-      db_class.vorpal_model_class_name = Util::StringUtils.escape_class_name(model_class.name)
-      db_class.table_name = table_name
-      db_class
-    end
-
-    # Builds a composable query object (e.g. ActiveRecord::Relation) with Vorpal methods mixed in.
-    #
-    # @param class_config [ClassConfig] Config of the entity whose db representations should be returned.
-    def query(class_config, aggregate_mapper)
-      class_config.db_class.unscoped.extending(ArelQueryMethods.new(aggregate_mapper))
-    end
-
-    private
-
-    def sequence_name(class_config)
-      @sequence_names[class_config] ||= execute(
-        "SELECT substring(column_default from '''(.*)''') FROM INFORMATION_SCHEMA.COLUMNS WHERE table_name = $1 AND column_name = 'id' LIMIT 1",
-        [class_config.db_class.table_name]
-      ).rows.first.first
-    end
-
-    def execute(sql, binds)
-      binds = binds.map { |row| [nil, row] }
-      ActiveRecord::Base.connection.exec_query(sql, 'SQL', binds)
-    end
-  end
-
-  class ArelQueryMethods < Module
-    def initialize(mapper)
-      @mapper = mapper
-    end
-
-    def extended(descendant)
-      super
-      descendant.extend(Methods)
-      descendant.vorpal_aggregate_mapper = @mapper
-    end
-
-    # Methods in this module will appear on any composable
-    module Methods
-      attr_writer :vorpal_aggregate_mapper
-
-      # See {AggregateMapper#load_many}.
-      def load_many
-        db_roots = self.to_a
-        @vorpal_aggregate_mapper.load_many(db_roots)
-      end
-
-      # See {AggregateMapper#load_one}.
-      def load_one
-        db_root = self.first
-        @vorpal_aggregate_mapper.load_one(db_root)
-      end
-    end
-  end
-end