chassis_repo 0.1.0

data/test/repo/delegation_test.rb

@@ -0,0 +1,100 @@
+require_relative '../test_helper'
+
+class RepoDelegationTest < Minitest::Test
+  class PersonRepo
+    extend Chassis::Repo::Delegation
+
+    def self.obj_class
+      Person
+    end
+  end
+
+  class SomethingSomething
+    extend Chassis::Repo::Delegation
+  end
+
+  Person = Struct.new :name
+
+  attr_reader :target, :person
+
+  def repo
+    PersonRepo
+  end
+
+  def setup
+    @target = mock
+    @person = Person.new 'ahawkins'
+    Chassis::Repo.stubs(:default).returns(target)
+  end
+
+  def test_classes_that_dont_match_on_name_fail_with_a_helpful_error
+    assert_raises Chassis::UnknownObjectClassError do
+      SomethingSomething.object_class
+    end
+  end
+
+  def test_find_delegates_to_the_target
+    target.expects(:find).with(Person, 1)
+    repo.find(1)
+  end
+
+  def test_delete_delegates_to_the_target
+    target.expects(:delete).with(person)
+    repo.delete(person)
+  end
+
+  def test_save_delegates_to_the_target
+    target.expects(:save).with(person)
+    repo.save(person)
+  end
+
+  def test_first_delegates_to_the_target
+    target.expects(:first).with(Person)
+    repo.first
+  end
+
+  def test_last_delegates_to_the_target
+    target.expects(:last).with(Person)
+    repo.last
+  end
+
+  def test_all_delegates_to_the_target
+    target.expects(:all).with(Person)
+    repo.all
+  end
+
+  def test_each_delegates_to_the_target
+    target.expects(:each).with(Person)
+    repo.each
+  end
+
+  def test_count_delegates_to_the_target
+    target.expects(:count).with(Person)
+    repo.count
+  end
+
+  def test_query_delegates_to_the_target
+    target.expects(:query).with(Person, :foo)
+    repo.query :foo
+  end
+
+  def test_query_bang__delegates_to_the_target
+    target.expects(:query!).with(Person, :foo)
+    repo.query! :foo
+  end
+
+  def test_graph_query_delegates_to_the_target
+    target.expects(:graph_query).with(Person, :foo)
+    repo.graph_query(:foo)
+  end
+
+  def test_sample_delegates_to_the_backend
+    target.expects(:sample).with(Person)
+    repo.sample
+  end
+
+  def test_empty_delegates_to_the_backend
+    target.expects(:empty?).with(Person)
+    repo.empty?
+  end
+end

data/test/repo/maglev_repo_test.rb

@@ -0,0 +1,52 @@
+require_relative '../test_helper'
+require_relative 'repo_tests'
+
+class MaglevRepoTest < Minitest::Test
+  ROOT_KEY = :chassis_test
+
+  class TestRepo < Chassis::MaglevRepo
+    def query_person_named(klass, selector)
+      all(klass).select do |person|
+        person.name == selector.name
+      end
+    end
+
+    def graph_query_person_named(klass, selector)
+      all(klass).select do |person|
+        person.name == selector.name
+      end
+    end
+  end
+
+  include RepoTests
+
+  def setup
+    Maglev[ROOT_KEY] = {}
+    Maglev.commit
+    @repo = TestRepo.new Maglev[ROOT_KEY]
+    super
+  end
+
+  def teardown
+    Maglev.root.delete ROOT_KEY
+    Maglev.commit
+  end
+
+  def test_map_store_is_committed
+    map = @repo.send :map
+    store = map.send :store
+    refute store.nil?
+    assert store.committed?
+  end
+
+  def test_persistent_crud_operations
+    person = Person.new 'ahawkins'
+
+    refute person.committed?, "brand new custom objects should be transient"
+    repo.create person
+    assert person.committed?, "repo must commit saved objects"
+
+    # repo.delete(person)
+    # refute person.committed?, "repo must delete committed objects"
+  end
+end

data/test/repo/memory_repo_test.rb

@@ -0,0 +1,25 @@
+require_relative '../test_helper'
+require_relative 'repo_tests'
+
+class MemoryRepoTest < Minitest::Test
+  class TestRepo < Chassis::MemoryRepo
+    def query_person_named(klass, selector)
+      all(klass).select do |person|
+        person.name == selector.name
+      end
+    end
+
+    def graph_query_person_named(klass, selector)
+      all(klass).select do |person|
+        person.name == selector.name
+      end
+    end
+  end
+
+  include RepoTests
+
+  def setup
+    @repo = TestRepo.new
+    super
+  end
+end

data/test/repo/null_repo_test.rb

@@ -0,0 +1,56 @@
+require_relative '../test_helper'
+
+class NullRepoTest < Minitest::Test
+  Person = Struct.new :name do
+    attr_accessor :id
+  end
+
+  attr_reader :repo
+
+  def setup
+    @repo = Chassis::NullRepo.new
+  end
+
+  def test_create_sets_the_id
+    person = Person.new 'ahawkins'
+    repo.create person
+
+    assert person.id, "Repo must set the ID after creating"
+  end
+
+  def test_all_returns_an_empty_array
+    assert_equal [], repo.all(Person)
+  end
+
+  def test_implements_required_interface
+    assert_respond_to repo, :update
+    assert_respond_to repo, :delete
+    assert_respond_to repo, :find
+    assert_respond_to repo, :all
+    assert_respond_to repo, :count
+    assert_respond_to repo, :first
+    assert_respond_to repo, :last
+    assert_respond_to repo, :sample
+    assert_respond_to repo, :query
+    assert_respond_to repo, :graph_query
+    assert_respond_to repo, :graph_query
+    assert_respond_to repo, :clear
+  end
+
+  def test_query_returns_empty_array
+    assert_equal [ ], repo.query(Person, :selector)
+  end
+
+  def test_graph_query_returns_empty_array
+    assert_equal [ ], repo.graph_query(Person, :selector)
+  end
+
+  def test_count_returns_no
+    assert_equal 0, repo.count(Person)
+  end
+
+  def test_first_and_last_return_nil
+    assert_nil repo.first(Person)
+    assert_nil repo.last(Person)
+  end
+end

data/test/repo/repo_tests.rb

@@ -0,0 +1,120 @@
+module RepoTests
+  Person = Struct.new :name do
+    attr_accessor :id
+  end
+
+  PersonNamed = Struct.new :name
+  PersonFooBarBaz = Class.new
+
+  def repo
+    fail "test class must assign @repo" unless @repo
+    @repo
+  end
+
+  def setup
+    repo.clear
+    repo.initialize_storage
+  end
+
+  def test_crud_operations
+    assert_equal 0, repo.count(Person), "Precondition: there should be no records"
+
+    person = Person.new 'ahawkins'
+    repo.create person
+
+    assert person.id, "repo must set the ID after creating"
+
+    assert_equal 1, repo.count(Person)
+
+    assert_equal person, repo.find(Person, person.id)
+
+    assert_equal [person], repo.all(Person)
+
+    person.name = 'adam'
+    repo.update person
+    assert_equal 'adam', repo.find(Person, person.id).name
+
+    repo.delete(person)
+
+    assert_equal 0, repo.count(Person)
+  end
+
+  def test_raises_error_when_no_reecord_exists
+    assert_equal 0, repo.count(Person)
+
+    assert_raises Chassis::RecordNotFoundError do
+      repo.find Person, 1
+    end
+  end
+
+  def test_first_and_last
+    assert_equal 0, repo.count(Person), "Precondition: there should be no records"
+
+    adam = Person.new 'ahawkins'
+    peter = Person.new 'pepps'
+
+    repo.create adam
+    repo.create peter
+
+    assert_equal adam, repo.first(Person)
+    assert_equal peter, repo.last(Person)
+  end
+
+  def test_clear_wipes_data
+    assert_equal 0, repo.count(Person), "Precondition: there should be no records"
+
+    adam = Person.new 'ahawkins'
+    repo.create adam
+
+    refute_empty repo.all(Person)
+    assert_equal 1, repo.count(Person)
+    assert repo.find(Person, adam.id)
+
+    repo.clear
+
+    assert_empty repo.all(Person)
+    assert_equal 0, repo.count(Person)
+  end
+
+  def test_raises_an_error_when_query_not_implemented
+    assert_raises Chassis::QueryNotImplementedError do
+      repo.query Person, PersonFooBarBaz.new
+    end
+  end
+
+  def test_uses_query_method_to_implement_queries
+    assert_equal 0, repo.count(Person), "Precondition: there should be no records"
+
+    adam = Person.new 'ahawkins'
+    peter = Person.new 'pepp'
+
+    repo.create adam
+    repo.create peter
+
+    assert_equal 2, repo.count(Person)
+
+    query = repo.query(Person, PersonNamed.new('ahawkins'))
+    refute_empty query
+    assert_equal adam, query.first
+  end
+
+  def test_raises_an_error_when_a_graph_query_is_not_implemented
+    assert_raises Chassis::GraphQueryNotImplementedError do
+      repo.graph_query Person, PersonFooBarBaz.new
+    end
+  end
+
+  def test_uses_the_specific_graph_query_method_for_graph_query
+    assert_equal 0, repo.count(Person), "Precondition: there should be no records"
+
+    adam = Person.new 'ahawkins'
+    peter = Person.new 'pepp'
+
+    repo.create adam
+    repo.create peter
+
+    query = repo.query(Person, PersonNamed.new('ahawkins'))
+    refute_empty query
+    assert_equal adam, query.first
+  end
+end

data/test/repo_test.rb

@@ -0,0 +1,76 @@
+require_relative 'test_helper'
+
+class RepoTest < Minitest::Test
+  class TestAdapter < Chassis::MemoryRepo
+    def query_test_empty_array_query(klass, q)
+      [ ]
+    end
+
+    def query_test_nil_query(klass, q)
+      nil
+    end
+
+    def query_person_by_name(klass, q)
+      all(klass).find do |record|
+        record.name == q.name
+      end
+    end
+
+    def update(record)
+      record.name = 'updated'
+    end
+  end
+
+  CustomError = Class.new RuntimeError
+  TestEmptyArrayQuery = Struct.new :foo
+  TestNilQuery = Struct.new :foo
+  PersonByName = Struct.new :name
+  Person = Struct.new :id, :name
+
+  def repo
+    Chassis.repo
+  end
+
+  def setup
+    repo.register :test, TestAdapter.new
+    repo.use :test
+  end
+
+  def test_query_bang_raises_an_exception_if_empty
+    assert_raises Chassis::NoQueryResultError do
+      repo.query! Person, TestEmptyArrayQuery.new(:foo)
+    end
+  end
+
+  def test_query_bang_raises_an_exception_if_nil
+    assert_raises Chassis::NoQueryResultError do
+      repo.query! Person, TestNilQuery.new(:foo)
+    end
+  end
+
+  def test_query_bang_can_take_a_block_to_customize_exception
+    assert_raises CustomError do
+      repo.query! Person, TestNilQuery.new(:foo) do |klass, selector|
+        fail CustomError
+      end
+    end
+  end
+
+  def test_query_bang_works_when_a_non_array_object_is_returned
+    person = Person.new nil, 'ahawkins'
+    repo.save person
+    assert_equal person, repo.query!(Person, PersonByName.new('ahawkins'))
+  end
+
+  def test_save_creates_records_without_ids
+    person = Person.new nil, 'ahawkins'
+    repo.save person
+    assert person.id
+  end
+
+  def test_save_updates_records_otherwise
+    person = Person.new 1, 'ahawkins'
+    repo.save person
+    assert_equal 'updated', person.name
+  end
+end

data/test/string_utils_test.rb

@@ -0,0 +1,21 @@
+require_relative 'test_helper'
+
+class StringUtilsTest < Minitest::Test
+  def utils
+    Chassis::StringUtils
+  end
+
+  def test_underscore
+    result = utils.underscore 'FooBar'
+    assert_equal 'foo_bar', result
+  end
+
+  def test_demodulize
+    result = utils.demodulize 'Foo::Bar::Baz'
+    assert_equal 'Baz', result
+  end
+
+  def test_constantize
+    assert_equal utils, utils.constantize('Chassis::StringUtils')
+  end
+end