vorpal 0.1.0.rc3 → 1.1.0

data/.gitignore

@@ -1,16 +0,0 @@
-/.bundle/
-/.idea/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log
-/projectFilesBackup

data/.rspec

@@ -1 +0,0 @@
---colour

data/.ruby-version

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

data/.yardopts

@@ -1 +0,0 @@
---no-private -m markdown lib/**/*.*

data/Gemfile

@@ -1,4 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in vorpal.gemspec
-gemspec

data/Rakefile

@@ -1,10 +0,0 @@
-#!/usr/bin/env rake
-begin
-  require "bundler/gem_tasks"
-rescue LoadError
-  puts 'You must `gem install bundler` and `bundle install` to run rake tasks associated with creating new versions of the gem.'
-end
-
-require 'rspec/core/rake_task'
-RSpec::Core::RakeTask.new(:spec)
-task :default => :spec

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

data/spec/helpers/db_helpers.rb

@@ -1,51 +0,0 @@
-module DbHelpers
-  module_function
-
-  CONNECTION_SETTINGS = {
-    adapter: 'postgresql',
-    host: 'localhost',
-    database: 'vorpal_test',
-    min_messages: 'error',
-    # Change the following to reflect your database settings
-    # username: 'vorpal',
-    # password: 'pass',
-  }
-
-  def ensure_database_exists
-    test_database_name = CONNECTION_SETTINGS.fetch(:database)
-    if !db_exists?(test_database_name)
-      db_connection.create_database(test_database_name)
-    end
-  end
-
-  def db_exists?(db_name)
-    ActiveRecord::Base.establish_connection(CONNECTION_SETTINGS.merge(database: 'template1'))
-
-    return db_connection.exec_query("SELECT 1 from pg_database WHERE datname='#{db_name}';").present?
-  end
-
-  def db_connection
-    ActiveRecord::Base.connection
-  end
-
-  def establish_connection
-    ActiveRecord::Base.establish_connection(CONNECTION_SETTINGS)
-  end
-
-  # when you change a table's columns, set force to true to re-generate the table in the DB
-  def define_table(table_name, columns, force)
-    if !db_connection.table_exists?(table_name) || force
-      db_connection.create_table(table_name, force: true) do |t|
-        columns.each do |name, type|
-          t.send(type, name)
-        end
-      end
-    end
-  end
-
-  def defineAr(table_name)
-    Class.new(ActiveRecord::Base) do
-      self.table_name = table_name
-    end
-  end
-end

data/spec/helpers/profile_helpers.rb

@@ -1,26 +0,0 @@
-require 'ruby-prof'
-
-# In order to use these helpers do the following:
-# 1) Add `spec.add_development_dependency "ruby-prof"` to the vorpal.gemspec file.
-# 2) Do a `bundle update`
-# 3) Add `require 'helpers/profile_helpers'` to the spec where you wish to profile.
-module ProfileHelpers
-  module_function
-
-  # Runs a block a given number of times and outputs the profiling results in a 'Call Tree'
-  # format suitable for display by a tool like KCacheGrind.
-  #
-  # - Installing QCacheGrind on OSX: http://nickology.com/2014/04/16/view-xdebug-cachegrind-files-on-mac-os/
-  def output_callgrind(description, times=1, &block)
-    RubyProf.measure_mode = RubyProf::PROCESS_TIME
-    RubyProf.start
-
-    times.times(&block)
-
-    result = RubyProf.stop
-    printer = RubyProf::CallTreePrinter.new(result)
-    File.open("#{description}_#{DateTime.now.strftime("%FT%H:%M:%S%z")}.callgrind", "w") do |file|
-      printer.print(file)
-    end
-  end
-end

data/spec/integration_spec_helper.rb

@@ -1,36 +0,0 @@
-require 'active_record'
-require 'pg'
-require 'helpers/db_helpers'
-
-DbHelpers.ensure_database_exists
-DbHelpers.establish_connection
-
-RSpec.configure do |config|
-  config.include DbHelpers
-
-  # implements `use_transactional_fixtures = true`
-  config.before(:each) do
-    connection = ActiveRecord::Base.connection
-    if ActiveRecord::VERSION::MAJOR == 3
-      # from lib/active_record/fixtures.rb
-      connection.increment_open_transactions
-      connection.transaction_joinable = false
-      connection.begin_db_transaction
-    else
-      connection.begin_transaction(joinable: false)
-    end
-  end
-
-  config.after(:each) do
-    connection = ActiveRecord::Base.connection
-    if ActiveRecord::VERSION::MAJOR == 3
-      if connection.open_transactions != 0
-        connection.rollback_db_transaction
-        connection.decrement_open_transactions
-      end
-    else
-      connection.rollback_transaction if connection.transaction_open?
-    end
-    ActiveRecord::Base.clear_active_connections!
-  end
-end

data/spec/vorpal/acceptance/aggregate_mapper_spec.rb

@@ -1,911 +0,0 @@
-require 'integration_spec_helper'
-require 'vorpal'
-require 'virtus'
-require 'activerecord-import/base'
-
-describe 'AggregateMapper' do
-
-  # for testing polymorphic associations
-  class Bug
-    include Virtus.model
-
-    attribute :id, Integer
-    attribute :name, String
-    attribute :lives_on, Object
-  end
-
-  class Tree; end
-
-  class Trunk
-    include Virtus.model
-
-    attribute :id, Integer
-    attribute :length, Decimal
-    attribute :bugs, Array[Bug]
-    attribute :tree, Tree
-  end
-
-  class Branch
-    include Virtus.model
-
-    attribute :id, Integer
-    attribute :length, Decimal
-    attribute :tree, Tree
-    attribute :branches, Array[Branch]
-    attribute :bugs, Array[Bug]
-  end
-
-  class Fissure < ActiveRecord::Base; end
-  class Swamp < ActiveRecord::Base; end
-
-  class Tree
-    include Virtus.model
-
-    attribute :id, Integer
-    attribute :name, String
-    attribute :trunk, Trunk
-    attribute :environment, Object
-    attribute :fissures, Array[Fissure]
-    attribute :branches, Array[Branch]
-  end
-
-  before(:all) do
-    define_table('branches', {length: :decimal, tree_id: :integer, branch_id: :integer}, false)
-    define_table('bugs', {name: :text, lives_on_id: :integer, lives_on_type: :string}, false)
-    define_table('fissures', {length: :decimal, tree_id: :integer}, false)
-    define_table('trees', {name: :text, trunk_id: :integer, environment_id: :integer, environment_type: :string}, false)
-    define_table('trunks', {length: :decimal}, false)
-    define_table('swamps', {}, false)
-  end
-
-  describe 'new records' do
-    it 'saves attributes' do
-      test_mapper = configure
-
-      tree = Tree.new(name: 'backyard tree')
-      test_mapper.persist(tree)
-
-      tree_db = db_class_for(Tree, test_mapper).first
-      expect(tree_db.name).to eq 'backyard tree'
-    end
-
-    it 'sets the id when first saved' do
-      test_mapper = configure
-
-      tree = Tree.new()
-      test_mapper.persist(tree)
-
-      expect(tree.id).to_not be nil
-
-      tree_db = db_class_for(Tree, test_mapper).first
-      expect(tree_db.id).to eq tree.id
-    end
-
-    it 'saves AR::Base objects' do
-      test_mapper = configure
-
-      fissure = Fissure.new(length: 21)
-      tree = Tree.new(fissures: [fissure])
-
-      test_mapper.persist(tree)
-
-      expect(Fissure.first.length).to eq 21
-    end
-  end
-
-  describe 'on error' do
-    it 'nils ids of new objects' do
-      db_driver = Vorpal::DbDriver.new
-      test_mapper = configure(db_driver: db_driver)
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-
-      expect(db_driver).to receive(:update).and_raise('not so good')
-
-      fissure = Fissure.new
-      tree = Tree.new(id: tree_db.id, fissures: [fissure])
-
-      expect {
-        test_mapper.persist(tree)
-      }.to raise_error(Exception)
-
-      expect(fissure.id).to eq nil
-      expect(tree.id).to_not eq nil
-    end
-  end
-
-  describe 'existing records' do
-    it 'updates attributes' do
-      test_mapper = configure
-
-      tree = Tree.new(name: 'little tree')
-      test_mapper.persist(tree)
-
-      tree.name = 'big tree'
-      test_mapper.persist(tree)
-
-      tree_db = db_class_for(Tree, test_mapper).first
-      expect(tree_db.name).to eq 'big tree'
-    end
-
-    it 'does not change the id on update' do
-      test_mapper = configure
-
-      tree = Tree.new
-      test_mapper.persist(tree)
-
-      original_id = tree.id
-
-      tree.name = 'change it'
-      test_mapper.persist(tree)
-
-      expect(tree.id).to eq original_id
-    end
-
-    it 'does not create additional records' do
-      test_mapper = configure
-
-      tree = Tree.new
-      test_mapper.persist(tree)
-
-      tree.name = 'change it'
-      test_mapper.persist(tree)
-
-      expect(db_class_for(Tree, test_mapper).count).to eq 1
-    end
-
-    it 'removes orphans' do
-      test_mapper = configure
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-      db_class_for(Branch, test_mapper).create!(tree_id: tree_db.id)
-
-      tree = Tree.new(id: tree_db.id, branches: [])
-
-      test_mapper.persist(tree)
-
-      expect(db_class_for(Branch, test_mapper).count).to eq 0
-    end
-
-    it 'does not remove orphans from unowned associations' do
-      test_mapper = configure_unowned
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-      db_class_for(Branch, test_mapper).create!(tree_id: tree_db.id)
-
-      tree = Tree.new(id: tree_db.id, branches: [])
-
-      test_mapper.persist(tree)
-
-      expect(db_class_for(Branch, test_mapper).count).to eq 1
-    end
-  end
-
-  it 'copies attributes to domain' do
-    test_mapper = configure
-
-    tree_db = db_class_for(Tree, test_mapper).create! name: 'tree name'
-    tree = test_mapper.load_one(tree_db)
-
-    expect(tree.id).to eq tree_db.id
-    expect(tree.name).to eq 'tree name'
-  end
-
-  it 'hydrates ActiveRecord::Base associations' do
-    test_mapper = configure
-
-    tree_db = db_class_for(Tree, test_mapper).create!
-    Fissure.create! length: 21, tree_id: tree_db.id
-
-    tree = test_mapper.load_one(tree_db)
-
-    expect(tree.fissures.first.length).to eq 21
-  end
-
-  describe 'cycles' do
-    it 'persists' do
-     test_mapper = configure_with_cycle
-
-      tree = Tree.new
-      long_branch = Branch.new(length: 100, tree: tree)
-      tree.branches << long_branch
-
-      test_mapper.persist(tree)
-
-      expect(db_class_for(Tree, test_mapper).count).to eq 1
-    end
-
-    it 'hydrates' do
-      test_mapper = configure_with_cycle
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-      db_class_for(Branch, test_mapper).create!(length: 50, tree_id: tree_db.id)
-
-      tree = test_mapper.load_one(tree_db)
-
-      expect(tree).to be tree.branches.first.tree
-    end
-  end
-
-  describe 'recursive associations' do
-    it 'persists' do
-      test_mapper = configure_recursive
-
-      tree = Tree.new
-      long_branch = Branch.new(length: 100, tree: tree)
-      tree.branches << long_branch
-      short_branch = Branch.new(length: 50, tree: tree)
-      long_branch.branches << short_branch
-
-      test_mapper.persist(tree)
-
-      expect(db_class_for(Branch, test_mapper).count).to eq 2
-    end
-
-    it 'hydrates' do
-      test_mapper = configure_recursive
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-      long_branch = db_class_for(Branch, test_mapper).create!(length: 100, tree_id: tree_db.id)
-      db_class_for(Branch, test_mapper).create!(length: 50, branch_id: long_branch.id)
-
-      tree = test_mapper.load_one(tree_db)
-
-      expect(tree.branches.first.branches.first.length).to eq 50
-    end
-  end
-
-  describe 'belongs_to associations' do
-    it 'saves attributes' do
-      test_mapper = configure
-      trunk = Trunk.new(length: 12)
-      tree = Tree.new(trunk: trunk)
-
-      test_mapper.persist(tree)
-
-      trunk_db = db_class_for(Trunk, test_mapper).first
-      expect(trunk_db.length).to eq 12
-    end
-
-    it 'saves foreign keys' do
-      test_mapper = configure
-      trunk = Trunk.new
-      tree = Tree.new(trunk: trunk)
-
-      test_mapper.persist(tree)
-
-      tree_db = db_class_for(Tree, test_mapper).first
-      expect(tree_db.trunk_id).to eq trunk.id
-    end
-
-    it 'updating does not create additional rows' do
-      test_mapper = configure
-      trunk = Trunk.new
-      tree = Tree.new(trunk: trunk)
-
-      test_mapper.persist(tree)
-
-      trunk.length = 21
-
-      expect{ test_mapper.persist(tree) }.to_not change{ db_class_for(Trunk, test_mapper).count }
-    end
-
-    it 'only saves entities that are owned' do
-      test_mapper = configure_unowned
-
-      trunk = Trunk.new
-      tree = Tree.new(trunk: trunk)
-
-      test_mapper.persist(tree)
-
-      expect(db_class_for(Trunk, test_mapper).count).to eq 0
-    end
-
-    it 'hydrates' do
-      test_mapper = configure
-      trunk_db = db_class_for(Trunk, test_mapper).create!(length: 21)
-      tree_db = db_class_for(Tree, test_mapper).create!(trunk_id: trunk_db.id)
-
-      new_tree = test_mapper.load_one(tree_db)
-      expect(new_tree.trunk.length).to eq 21
-    end
-  end
-
-  describe 'has_many associations' do
-    it 'saves' do
-      test_mapper = configure
-      tree = Tree.new
-      tree.branches << Branch.new(length: 100)
-      tree.branches << Branch.new(length: 3)
-
-      test_mapper.persist(tree)
-
-      branches = db_class_for(Branch, test_mapper).all
-      expect(branches.size).to eq 2
-      expect(branches.first.length).to eq 100
-      expect(branches.second.length).to eq 3
-    end
-
-    it 'saves foreign keys' do
-      test_mapper = configure
-      tree = Tree.new
-      tree.branches << Branch.new(length: 100)
-
-      test_mapper.persist(tree)
-
-      branches = db_class_for(Branch, test_mapper).all
-      expect(branches.first.tree_id).to eq tree.id
-    end
-
-    it 'updates' do
-      test_mapper = configure
-      tree = Tree.new
-      long_branch = Branch.new(length: 100)
-      tree.branches << long_branch
-
-      test_mapper.persist(tree)
-
-      long_branch.length = 120
-
-      test_mapper.persist(tree)
-
-      branches = db_class_for(Branch, test_mapper).all
-      expect(branches.first.length).to eq 120
-    end
-
-    it 'only saves entities that are owned' do
-      test_mapper = configure_unowned
-
-      tree = Tree.new
-      long_branch = Branch.new(length: 100)
-      tree.branches << long_branch
-
-      test_mapper.persist(tree)
-
-      expect(db_class_for(Branch, test_mapper).count).to eq 0
-    end
-
-    it 'hydrates' do
-      test_mapper = configure
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-      db_class_for(Branch, test_mapper).create!(length: 50, tree_id: tree_db.id)
-
-      tree = test_mapper.load_one(tree_db)
-
-      expect(tree.branches.first.length).to eq 50
-    end
-  end
-
-  describe 'has_one associations' do
-    it 'saves' do
-      test_mapper = configure_has_one
-      tree = Tree.new(name: 'big tree')
-      trunk = Trunk.new(tree: tree)
-
-      test_mapper.persist(trunk)
-
-      expect(db_class_for(Tree, test_mapper).first.name).to eq 'big tree'
-    end
-
-    it 'saves foreign keys' do
-      test_mapper = configure_has_one
-      tree = Tree.new(name: 'big tree')
-      trunk = Trunk.new(tree: tree)
-
-      test_mapper.persist(trunk)
-
-      expect(db_class_for(Tree, test_mapper).first.trunk_id).to eq trunk.id
-    end
-
-    it 'only saves entities that are owned' do
-      test_mapper = configure_unowned_has_one
-      tree = Tree.new
-      trunk = Trunk.new(tree: tree)
-
-      test_mapper.persist(trunk)
-
-      expect(db_class_for(Tree, test_mapper).count).to eq 0
-    end
-
-    it 'hydrates' do
-      test_mapper = configure_has_one
-
-      trunk_db = db_class_for(Trunk, test_mapper).create!
-      db_class_for(Tree, test_mapper).create!(name: 'big tree', trunk_id: trunk_db.id)
-
-      trunk = test_mapper.load_one(trunk_db)
-
-      expect(trunk.tree.name).to eq 'big tree'
-    end
-  end
-
-  describe 'polymorphic associations' do
-    it 'saves with has_manys' do
-      test_mapper = configure_polymorphic_has_many
-      trunk = Trunk.new
-      branch = Branch.new
-      tree = Tree.new(trunk: trunk, branches: [branch])
-
-      trunk_bug = Bug.new
-      trunk.bugs << trunk_bug
-      branch_bug = Bug.new
-      branch.bugs << branch_bug
-
-      test_mapper.persist(tree)
-
-      expect(db_class_for(Bug, test_mapper).find(trunk_bug.id).lives_on_type).to eq Trunk.name
-      expect(db_class_for(Bug, test_mapper).find(branch_bug.id).lives_on_type).to eq Branch.name
-    end
-
-    it 'restores with has_manys' do
-      test_mapper = configure_polymorphic_has_many
-
-      trunk_db = db_class_for(Trunk, test_mapper).create!
-      tree_db = db_class_for(Tree, test_mapper).create!(trunk_id: trunk_db.id)
-      db_class_for(Bug, test_mapper).create!(name: 'trunk bug', lives_on_id: trunk_db.id, lives_on_type: Trunk.name)
-      db_class_for(Bug, test_mapper).create!(name: 'not a trunk bug!', lives_on_id: trunk_db.id, lives_on_type: 'some other table')
-
-      tree = test_mapper.load_one(tree_db)
-
-      expect(tree.trunk.bugs.map(&:name)).to eq ['trunk bug']
-    end
-
-    it 'saves with belongs_tos' do
-      test_mapper = configure_polymorphic_belongs_to
-
-      trunk_bug = Bug.new(lives_on: Trunk.new)
-      branch_bug = Bug.new(lives_on: Branch.new)
-
-      test_mapper.persist([trunk_bug, branch_bug])
-
-      expect(db_class_for(Bug, test_mapper).find(trunk_bug.id).lives_on_type).to eq Trunk.name
-      expect(db_class_for(Bug, test_mapper).find(branch_bug.id).lives_on_type).to eq Branch.name
-    end
-
-    it 'saves associations to unowned entities via belongs_to' do
-      test_mapper = configure_unowned_polymorphic_belongs_to
-      trunk = Trunk.new
-
-      trunk_bug = Bug.new(lives_on: trunk)
-
-      test_mapper.persist(trunk_bug)
-
-      expect(db_class_for(Bug, test_mapper).find(trunk_bug.id).lives_on_type).to eq Trunk.name
-    end
-
-    it 'restores with belongs_tos' do
-      test_mapper = configure_polymorphic_belongs_to
-
-      # makes sure that we are using the fk_type to discriminate against
-      # two entities with the same primary key value
-      trunk_db = db_class_for(Trunk, test_mapper).new(length: 99)
-      trunk_db.id = 99
-      trunk_db.save!
-      trunk_bug_db = db_class_for(Bug, test_mapper).create!(lives_on_id: trunk_db.id, lives_on_type: Trunk.name)
-      branch_db = db_class_for(Branch, test_mapper).new(length: 5)
-      branch_db.id = 99
-      branch_db.save!
-      branch_bug_db = db_class_for(Bug, test_mapper).create!(lives_on_id: branch_db.id, lives_on_type: Branch.name)
-
-      trunk_bug, branch_bug = test_mapper.load_many([trunk_bug_db, branch_bug_db])
-
-      expect(trunk_bug.lives_on.length).to eq 99
-      expect(branch_bug.lives_on.length).to eq 5
-    end
-
-    it 'restores active record objects' do
-      test_mapper = configure_ar_polymorphic_belongs_to
-
-      swamp = Swamp.create!
-      tree_db = db_class_for(Tree, test_mapper).create!(environment_id: swamp.id, environment_type: Swamp.name)
-
-      tree = test_mapper.load_one(tree_db)
-
-      expect(tree.environment).to eq swamp
-    end
-  end
-
-  describe 'arel' do
-    it 'loads many' do
-      test_mapper = configure
-
-      db_class_for(Tree, test_mapper).create!
-      tree_db = db_class_for(Tree, test_mapper).create!
-
-      trees = test_mapper.query.where(id: tree_db.id).load_many
-
-      expect(trees.map(&:id)).to eq [tree_db.id]
-    end
-
-    it 'loads one' do
-      test_mapper = configure
-
-      db_class_for(Tree, test_mapper).create!
-      tree_db = db_class_for(Tree, test_mapper).create!
-
-      trees = test_mapper.query.where(id: tree_db.id).load_one
-
-      expect(trees.id).to eq tree_db.id
-    end
-  end
-
-  describe 'load_many' do
-    it 'maps given db objects' do
-      test_mapper = configure
-
-      db_class_for(Tree, test_mapper).create!
-      tree_db = db_class_for(Tree, test_mapper).create!
-
-      trees = test_mapper.load_many([tree_db])
-
-      expect(trees.map(&:id)).to eq [tree_db.id]
-    end
-
-    it 'only returns roots' do
-      test_mapper = configure
-
-      db_class_for(Tree, test_mapper).create!
-      tree_db = db_class_for(Tree, test_mapper).create!
-      db_class_for(Branch, test_mapper).create!(tree_id: tree_db.id)
-
-      trees = test_mapper.load_many([tree_db])
-
-      expect(trees.map(&:id)).to eq [tree_db.id]
-    end
-  end
-
-  describe 'destroy' do
-    it 'removes the entity from the database' do
-      test_mapper = configure
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-
-      test_mapper.destroy([Tree.new(id: tree_db.id)])
-
-      expect(db_class_for(Tree, test_mapper).count).to eq 0
-    end
-
-    it 'removes has many children from the database' do
-      test_mapper = configure
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-      db_class_for(Branch, test_mapper).create!(tree_id: tree_db.id)
-
-      test_mapper.destroy(Tree.new(id: tree_db.id))
-
-      expect(db_class_for(Branch, test_mapper).count).to eq 0
-    end
-
-    it 'removes belongs to children from the database' do
-      test_mapper = configure
-
-      trunk_db = db_class_for(Trunk, test_mapper).create!
-      tree_db = db_class_for(Tree, test_mapper).create!(trunk_id: trunk_db.id)
-
-      test_mapper.destroy(Tree.new(id: tree_db.id))
-
-      expect(db_class_for(Trunk, test_mapper).count).to eq 0
-    end
-
-    it 'removes AR children from the database' do
-      test_mapper = configure
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-      Fissure.create!(tree_id: tree_db.id)
-
-      test_mapper.destroy(Tree.new(id: tree_db.id))
-
-      expect(Fissure.count).to eq 0
-    end
-
-    it 'leaves unowned belongs to children in the database' do
-      test_mapper = configure_unowned
-
-      trunk_db = db_class_for(Trunk, test_mapper).create!
-      tree_db = db_class_for(Tree, test_mapper).create!(trunk_id: trunk_db.id)
-
-      test_mapper.destroy(Tree.new(id: tree_db.id))
-
-      expect(db_class_for(Trunk, test_mapper).count).to eq 1
-    end
-
-    it 'leaves unowned has many children in the database' do
-      test_mapper = configure_unowned
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-      db_class_for(Branch, test_mapper).create!(tree_id: tree_db.id)
-
-      test_mapper.destroy(Tree.new(id: tree_db.id))
-
-      expect(db_class_for(Branch, test_mapper).count).to eq 1
-    end
-  end
-
-  describe 'destroy_by_id' do
-    it 'removes the entity from the database' do
-      test_mapper = configure
-
-      tree_db = db_class_for(Tree, test_mapper).create!
-
-      test_mapper.destroy_by_id([tree_db.id])
-
-      expect(db_class_for(Tree, test_mapper).count).to eq 0
-    end
-  end
-
-  describe 'non-existent values' do
-    it 'load_many returns an empty array when given an empty array' do
-      test_mapper = configure
-
-      results = test_mapper.load_many([])
-      expect(results).to eq []
-    end
-
-    it 'load_many throws an exception when given a nil db_object' do
-      test_mapper = configure
-
-      expect {
-        test_mapper.load_many([nil])
-      }.to raise_error(Vorpal::InvalidAggregateRoot, "Nil aggregate roots are not allowed.")
-    end
-
-    it 'load_one returns nil when given nil' do
-      test_mapper = configure
-
-      result = test_mapper.load_one(nil)
-      expect(result).to eq nil
-    end
-
-    it 'persist ignores empty arrays' do
-      test_mapper = configure
-
-      results = test_mapper.persist([])
-      expect(results).to eq []
-    end
-
-    it 'persist throws an exception when given a collection with a nil root' do
-      test_mapper = configure
-      expect {
-        test_mapper.persist([nil])
-      }.to raise_error(Vorpal::InvalidAggregateRoot, "Nil aggregate roots are not allowed.")
-    end
-
-    it 'persist throws an exception when given a nil root' do
-      test_mapper = configure
-      expect {
-        test_mapper.persist(nil)
-      }.to raise_error(Vorpal::InvalidAggregateRoot, "Nil aggregate roots are not allowed.")
-    end
-
-    it 'destroy ignores empty arrays' do
-      test_mapper = configure
-
-      results = test_mapper.destroy([])
-      expect(results).to eq []
-    end
-
-    it 'destroy throws an exception when given a nil root' do
-      test_mapper = configure
-
-      expect {
-        test_mapper.destroy(nil)
-      }.to raise_error(Vorpal::InvalidAggregateRoot, "Nil aggregate roots are not allowed.")
-    end
-
-    it 'destroy throws an exception when given a collection with a nil root' do
-      test_mapper = configure
-
-      expect {
-        test_mapper.destroy([nil])
-      }.to raise_error(Vorpal::InvalidAggregateRoot, "Nil aggregate roots are not allowed.")
-    end
-
-    it 'destroy_by_id ignores empty arrays' do
-      test_mapper = configure
-
-      results = test_mapper.destroy_by_id([])
-      expect(results).to eq []
-    end
-
-    it 'destroy_by_id ignores ids that do not exist' do
-      test_mapper = configure
-
-      test_mapper.destroy_by_id([99])
-    end
-
-    it 'destroy_by_id throws an exception when given a collection with a nil id' do
-      test_mapper = configure
-
-      expect {
-        test_mapper.destroy_by_id([nil])
-      }.to raise_error(Vorpal::InvalidPrimaryKeyValue, "Nil primary key values are not allowed.")
-    end
-
-    it 'destroy_by_id throws an exception when given a nil id' do
-      test_mapper = configure
-
-      expect {
-        test_mapper.destroy_by_id(nil)
-      }.to raise_error(Vorpal::InvalidPrimaryKeyValue, "Nil primary key values are not allowed.")
-    end
-  end
-
-private
-
-  def db_class_for(clazz, mapper)
-    mapper.engine.mapper_for(clazz).db_class
-  end
-
-  def configure_polymorphic_has_many
-    engine = Vorpal.define do
-      map Tree do
-        attributes :name
-        has_many :branches
-        belongs_to :trunk
-      end
-
-      map Trunk do
-        attributes :length
-        has_many :bugs, fk: :lives_on_id, fk_type: :lives_on_type
-      end
-
-      map Branch do
-        attributes :length
-        has_many :bugs, fk: :lives_on_id, fk_type: :lives_on_type
-      end
-
-      map Bug do
-        attributes :name
-      end
-    end
-    engine.mapper_for(Tree)
-  end
-
-  def configure_polymorphic_belongs_to
-    engine = Vorpal.define do
-      map Bug do
-        attributes :name
-        belongs_to :lives_on, fk: :lives_on_id, fk_type: :lives_on_type, child_classes: [Trunk, Branch]
-      end
-
-      map Trunk do
-        attributes :length
-      end
-
-      map Branch do
-        attributes :length
-      end
-    end
-    engine.mapper_for(Bug)
-  end
-
-  def configure_ar_polymorphic_belongs_to
-    engine = Vorpal.define do
-      map Tree do
-        attributes :name
-        belongs_to :environment, owned: false, fk: :environment_id, fk_type: :environment_type, child_class: Swamp
-      end
-
-      map Swamp, to: Swamp
-    end
-    engine.mapper_for(Tree)
-  end
-
-  def configure_unowned_polymorphic_belongs_to
-    engine = Vorpal.define do
-      map Bug do
-        attributes :name
-        belongs_to :lives_on, owned: false, fk: :lives_on_id, fk_type: :lives_on_type, child_classes: [Trunk, Branch]
-      end
-
-      map Trunk do
-        attributes :length
-      end
-
-      map Branch do
-        attributes :length
-      end
-    end
-    engine.mapper_for(Bug)
-  end
-
-  def configure_unowned
-    engine = Vorpal.define do
-      map Tree do
-        attributes :name
-        has_many :branches, owned: false
-        belongs_to :trunk, owned: false
-      end
-
-      map Trunk do
-        attributes :length
-      end
-
-      map Branch do
-        attributes :length
-      end
-    end
-    engine.mapper_for(Tree)
-  end
-
-  def configure_recursive
-    engine = Vorpal.define do
-      map Branch do
-        attributes :length
-        has_many :branches
-      end
-
-      map Tree do
-        attributes :name
-        has_many :branches
-      end
-    end
-    engine.mapper_for(Tree)
-  end
-
-  def configure_with_cycle
-    engine = Vorpal.define do
-      map Branch do
-        attributes :length
-        belongs_to :tree
-      end
-
-      map Tree do
-        attributes :name
-        has_many :branches
-      end
-    end
-    engine.mapper_for(Tree)
-  end
-
-  def configure(options={})
-    engine = Vorpal.define(options) do
-      map Tree do
-        attributes :name
-        belongs_to :trunk
-        has_many :fissures
-        has_many :branches
-      end
-
-      map Trunk do
-        attributes :length
-      end
-
-      map Branch do
-        attributes :length
-      end
-
-      map Fissure, to: Fissure
-    end
-    engine.mapper_for(Tree)
-  end
-
-  def configure_has_one
-    engine = Vorpal.define do
-      map Trunk do
-        attributes :length
-        has_one :tree
-      end
-
-      map Tree do
-        attributes :name
-      end
-    end
-    engine.mapper_for(Trunk)
-  end
-
-  def configure_unowned_has_one
-    engine = Vorpal.define do
-      map Trunk do
-        attributes :length
-        has_one :tree, owned: false
-      end
-
-      map Tree do
-        attributes :name
-      end
-    end
-    engine.mapper_for(Trunk)
-  end
-end