datamappify 0.53.2 → 0.60.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4ec85b5050a819d22845e27d8dd637007b94910c
-  data.tar.gz: 8c42b671c22e957161aaf8c7791a978037559424
+  metadata.gz: b7fa8132e32a3dec1dd746263e0df0eff57b5448
+  data.tar.gz: 7536658c8651e4f89cb6ff9021dcfe7107bc59ca
 SHA512:
-  metadata.gz: 125891396e0b79a7336abb47f9fc1dbc9f1fd492a0acaeb439f5c111d1ddbdbb6fba6c7acb5ef4479c7b6db6153e214b1e7f5b87342182c0f533cf63e96777eb
-  data.tar.gz: d5d7ab84a3650dac56ad2678e732bb737e1d90873121f237a2489e72fa5709c7eab8d0ebfb86a4347c9721ccad6a8376d84b3b4db8650abeec68fa37440e1b9c
+  metadata.gz: 51787e716646495a2ccff4474e783805ad8e81d1a1de59f3600c0b2b9a3a89e509eb56016fd0f9728ee8310a14fb8fbde2e72f28b9346c193a8a7a2247b6716c
+  data.tar.gz: 421115bd3c70db49fefe9a136ba9caedce4357d6e921e37c53533d350481a6f71e8304346c77389171451b6930ff01c4a6b998cb0fb24f0afa08c61363bee866

data/.gitignore

@@ -3,3 +3,4 @@ pkg
 coverage
 .yardoc
 doc
+tmp

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## master
 
+## 0.60.0 [2013-07-23]
+
+- New API: Introduced `Datamappify.config` for configuring default behaviours.
+- API change: `where` now replaces `find` for multiple items.
+- API change: `map_attribute` now takes `:to` and `:provider` instead of a string for specifying data source.
+- New API: Introduced `group` for grouping `map_attribute`.
+- Added support for entity namespaces (closes #4).
+
 ## 0.53.2 [2013-07-18]
 
 - Better attributes inspect. Thanks @jamesmoriarty!

data/README.md

@@ -175,6 +175,7 @@ class UserRepository
   for_entity User
 
   # specify the default data provider for unmapped attributes
+  # optionally you may use `Datamappify.config` to config this globally
   default_provider :ActiveRecord
 
   # specify any attributes that need to be mapped
@@ -185,11 +186,17 @@ class UserRepository
   #   - 'last_name' is mapped to the 'User' ActiveRecord class and its 'surname' attribute
   #   - 'driver_license' is mapped to the 'UserDriverLicense' ActiveRecord class and its 'number' attribute
   #   - 'passport' is mapped to the 'UserPassport' Sequel class and its 'number' attribute
-  #   - attributes not specified here are mapped automatically to 'ActiveRecord::User'
-  map_attribute :last_name,      'ActiveRecord::User#surname'
-  map_attribute :driver_license, 'ActiveRecord::UserDriverLicense#number'
-  map_attribute :passport,       'Sequel::UserPassport#number'
-  map_attribute :health_care,    'Sequel::UserHealthCare#number'
+  #   - attributes not specified here are mapped automatically to 'User' with provider 'ActiveRecord'
+  map_attribute :last_name,      :to => 'User#surname'
+  map_attribute :driver_license, :to => 'UserDriverLicense#number'
+  map_attribute :passport,       :to => 'UserPassport#number',   :provider => :Sequel
+  map_attribute :health_care,    :to => 'UserHealthCare#number', :provider => :Sequel
+
+  # alternatively, you may group attribute mappings if they share certain options:
+  group :provider => :Sequel do
+    map_attribute :passport,    :to => 'UserPassport#number'
+    map_attribute :health_care, :to => 'UserHealthCare#number'
+  end
 
   # attributes can also be reverse mapped by specifying the `via` option
   #
@@ -197,7 +204,7 @@ class UserRepository
   # and map `hobby_name` from the `name` attribute of `ActiveRecord::Hobby`
   #
   # this is useful for mapping form fields (similar to ActiveRecord's nested attributes)
-  map_attribute :hobby_name,     'ActiveRecord::Hobby#name', :via => :hobby_id
+  map_attribute :hobby_name, :to => 'Hobby#name', :via => :hobby_id
 end
 ```
 
@@ -213,7 +220,7 @@ end
 class GuestUserRepository < UserRepository
   for_entity GuestUser
 
-  map_attribute :expiry, 'ActiveRecord::User#expiry_date'
+  map_attribute :expiry, :to => 'User#expiry_date'
 end
 ```
 
@@ -224,7 +231,7 @@ In the above example, both repositories deal with the `ActiveRecord::User` data
 Datamappify repository by default creates the underlying data model classes for you. For example:
 
 ```ruby
-map_attribute :driver_license, 'ActiveRecord::UserData::DriverLicense#number'
+map_attribute :driver_license, :to => 'UserData::DriverLicense#number'
 ```
 
 In the above example, a `Datamppify::Data::Record::ActiveRecord::UserDriverLicense` ActiveRecord model will be created. If you would like to customise the data model class, you may do so by creating one either under the default namespace or under the `Datamappify::Data::Record::NameOfDataProvider` namespace:
@@ -278,7 +285,7 @@ users = UserRepository.all
 Returns an array of entities.
 
 ```ruby
-users = UserRepository.find(:first_name => 'Fred', :driver_license => 'AABBCCDD')
+users = UserRepository.where(:first_name => 'Fred', :driver_license => 'AABBCCDD')
 ```
 
 _Note: it does not currently support searching attributes from different data providers._
@@ -374,6 +381,16 @@ end
 
 Note: Returning either `nil` or `false` from the callback will cancel all subsequent callbacks (and the action itself, if it's a `before_` callback).
 
+### Default configuration
+
+You may configure Datamappify's default behaviour. In Rails you would put it in an initializer file.
+
+```ruby
+Datamappify.config do |c|
+  c.default_provider = :ActiveRecord
+end
+```
+
 ## More Reading
 
 You may check out this [article](http://fredwu.me/post/54009567748/) for more examples.
@@ -399,6 +416,7 @@ Refer to [CHANGELOG](CHANGELOG.md).
 - [Fred Wu](http://fredwu.me/) - author.
 - [James Ladd](http://jamesladdcode.com/) for reviewing the code and giving advice on architectural decisions.
 - [Locomote](http://www.locomote.com.au/) - where Datamappify is built and being tested in product development.
+- And with these [awesome contributors](https://github.com/fredwu/datamappify/contributors)!
 
 ## License
 

data/lib/datamappify.rb

@@ -8,6 +8,7 @@ module Datamappify
   end
 end
 
+require 'datamappify/config'
 require 'datamappify/logger'
 require 'datamappify/entity'
 require 'datamappify/data'

data/lib/datamappify/config.rb

@@ -0,0 +1,18 @@
+module Datamappify
+  Config = Struct.new(:default_provider)
+
+  # A Struct containing default configuration values
+  #
+  # @return [Config]
+  def self.defaults
+    @defaults ||= Config.new
+  end
+
+  # @yield
+  #   configuration block
+  #
+  # @return [void]
+  def self.config(&block)
+    block.call(defaults)
+  end
+end

data/lib/datamappify/data/criteria/common.rb

@@ -97,7 +97,14 @@ module Datamappify
         #
         # @return [Boolean]
         def primary_record?
-          source_class.name.demodulize == default_source_class_name
+          source_class_name == default_source_class_name
+        end
+
+        # Source class name with its namespace but without Data::Record::Provider
+        #
+        # @return [String]
+        def source_class_name
+          source_class.name.split('Datamappify::Data::Record::')[-1].split('::', 2)[-1]
         end
 
         # Ignores the current Criteria's operation if there is no dirty attributes

data/lib/datamappify/data/criteria/relational/concerns/set_criteria.rb

@@ -7,22 +7,35 @@ module Datamappify
             def initialize(*args)
               super
 
-              set_criteria if entity.id
+              if entity.id
+                self.criteria = build_criteria
+              end
             end
 
             private
 
-            def set_criteria
-              self.criteria = if options[:via]
+            def build_criteria
+              if options[:via].nil?
+                criteria_for_normal_mapping
+              elsif finder?
                 criteria_for_reverse_mapping
               else
-                criteria_for_normal_mapping
+                {}
               end
             end
 
+            def criteria_for_reverse_mapping
+              reverse_id = options[:primary_record].send(options[:via])
+              reverse_id ? { :id => reverse_id } : {}
+            end
+
             def criteria_for_normal_mapping
               { key_name => entity.id }
             end
+
+            def finder?
+              self.class.name =~ /Find/
+            end
           end
         end
       end

data/lib/datamappify/data/criteria/relational/find_by_key.rb

@@ -11,13 +11,6 @@ module Datamappify
           def initialize(source_class, entity, attributes, options = {}, &block)
             super(source_class, entity, nil, attributes, options, &block)
           end
-
-          private
-
-          def criteria_for_reverse_mapping
-            reverse_id = options[:primary_record].send(options[:via])
-            reverse_id ? { :id => reverse_id } : {}
-          end
         end
       end
     end

data/lib/datamappify/data/criteria/relational/save_by_key.rb

@@ -10,12 +10,6 @@ module Datamappify
           def initialize(source_class, entity, attributes, options = {}, &block)
             super(source_class, entity, {}, attributes, options, &block)
           end
-
-          private
-
-          def criteria_for_reverse_mapping
-            {}
-          end
         end
       end
     end

data/lib/datamappify/data/mapper.rb

@@ -20,6 +20,8 @@ module Datamappify
       def initialize
         @custom_mapping         = {}
         @custom_attribute_names = []
+
+        @default_provider_name  = Datamappify.defaults.default_provider
       end
 
       # @return [Module]
@@ -78,26 +80,32 @@ module Datamappify
       # @return [Array<Attribute>]
       def default_attributes
         @default_attributes ||= default_attribute_names.collect do |attribute|
-          Attribute.new(attribute, default_source_for(attribute), :primary_source_class => default_source_class)
+          Attribute.new(
+            attribute,
+            :to                   => default_source_for(attribute),
+            :provider             => default_provider_name,
+            :primary_source_class => default_source_class
+          )
         end
       end
 
       # @return [Array<Attribute>]
       def custom_attributes
-        @custom_attributes ||= custom_mapping.collect do |attribute, source_and_options|
-          map_custom_attribute(attribute, *source_and_options)
+        @custom_attributes ||= custom_mapping.collect do |attribute, options|
+          map_custom_attribute(attribute, options)
         end
       end
 
       # @param (see Data::Mapper::Attribute#initialize)
       #
       # @return [Attribute]
-      def map_custom_attribute(name, source, options)
+      def map_custom_attribute(name, options)
         @custom_attribute_names << name
 
+        options.reverse_merge!(:provider => default_provider_name)
         options.merge!(:primary_source_class => default_source_class)
 
-        Attribute.new(name, source, options)
+        Attribute.new(name, options)
       end
 
       # @param attribute [Symbol]
@@ -105,7 +113,7 @@ module Datamappify
       #
       # @return [String]
       def default_source_for(attribute)
-        "#{default_provider_name}::#{default_source_class_name}##{attribute}"
+        "#{default_source_class_name}##{attribute}"
       end
     end
   end

data/lib/datamappify/data/mapper/attribute.rb

@@ -32,18 +32,15 @@ module Datamappify
         # @param name [Symbol]
         #   name of the attribute
         #
-        # @param source [String]
-        #   data provider, class and attribute,
-        #   e.g. "ActiveRecord::User#surname"
-        #
         # @param options [Hash]
-        def initialize(name, source, options)
+        def initialize(name, options)
           @key                  = name
           @name                 = name.to_s
           @options              = options
+          @provider_name        = options[:provider].to_s
           @primary_source_class = options[:primary_source_class]
 
-          @provider_name, @source_class_name, @source_attribute_name = parse_source(source)
+          @source_class_name, @source_attribute_name = parse_source(options[:to])
 
           if secondary_attribute?
             if reverse_mapped?
@@ -151,9 +148,7 @@ module Datamappify
         # @return [Array<String>]
         #   an array with provider name, source class name and source attribute name
         def parse_source(source)
-          provider_name, source_class_and_attribute = source.split('::', 2)
-
-          [provider_name, *source_class_and_attribute.split('#')]
+          source.split('#')
         end
       end
     end

data/lib/datamappify/entity/inspectable.rb

@@ -25,4 +25,3 @@ module Datamappify
     end
   end
 end
-

data/lib/datamappify/repository.rb

@@ -18,6 +18,9 @@ module Datamappify
         include Singleton
         extend  SingletonWrapper
 
+        class_attribute :current_group_options
+        self.current_group_options = {}
+
         self.data_mapper = Data::Mapper.new
 
         include LazyChecking

data/lib/datamappify/repository/mapping_dsl.rb

@@ -26,8 +26,22 @@ module Datamappify
       # @param (see Data::Mapper::Attribute#initialize)
       #
       # @return [void]
-      def map_attribute(name, source, options = {})
-        data_mapper.custom_mapping[name] = [source, options]
+      def map_attribute(name, options = {})
+        data_mapper.custom_mapping[name.to_sym] = self.current_group_options.merge(options)
+      end
+
+      # @param options [Hash]
+      #
+      # @yield
+      #   a block containing `map_attribute` DSLs
+      #
+      # @return [void]
+      def group(options = {}, &block)
+        self.current_group_options = options
+
+        block.call
+
+        self.current_group_options = {}
       end
     end
   end

data/lib/datamappify/repository/query_methods.rb

@@ -20,16 +20,20 @@ module Datamappify
         QueryMethod::Exists.new(query_options, entity).perform
       end
 
-      # @param criteria [Integer, Hash]
+      # @param criteria [Integer, String]
       #   an entity id or a hash containing criteria
       #
       # @return [Entity, nil]
       def find(criteria)
-        if criteria.is_a?(Integer)
-          QueryMethod::Find.new(query_options, criteria).perform
-        else
-          QueryMethod::FindMultiple.new(query_options, criteria).perform
-        end
+        QueryMethod::Find.new(query_options, criteria).perform
+      end
+
+      # @param criteria [Hash]
+      #   a hash containing criteria
+      #
+      # @return [Entity]
+      def where(criteria)
+        QueryMethod::FindMultiple.new(query_options, criteria).perform
       end
 
       # Returns a collection of all the entities in the repository

data/lib/datamappify/repository/unit_of_work/transaction.rb

@@ -15,4 +15,3 @@ module Datamappify
     end
   end
 end
-

data/lib/datamappify/version.rb

@@ -1,3 +1,3 @@
 module Datamappify
-  VERSION = '0.53.2'
+  VERSION = '0.60.0'
 end

data/spec/config_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe Datamappify do
+  before do
+    Datamappify.config do |c|
+      c.default_provider = :ActiveRecord
+    end
+  end
+
+  it "#default_provider" do
+    mapper = Datamappify::Data::Mapper.new
+    mapper.default_provider_name.should == :ActiveRecord
+  end
+end

data/spec/entity_spec.rb

@@ -43,4 +43,3 @@ describe Datamappify::Entity do
     it { should respond_to(:to_key) }
   end
 end
-

data/spec/lazy_spec.rb

@@ -70,4 +70,3 @@ describe Datamappify::Lazy do
     end
   end
 end
-

data/spec/repository/finders_spec.rb

@@ -14,6 +14,9 @@ shared_examples_for "finders" do |data_provider|
         its(:id) { should == existing_user.id }
       end
 
+    end
+
+    describe "#where" do
       describe "by criteria" do
         before do
           user_repository.save!(User.new(:first_name => 'Mary', :driver_license => 'IDONTCARE'))
@@ -26,13 +29,13 @@ shared_examples_for "finders" do |data_provider|
         end
 
         describe "by attribute that does not exist" do
-          let(:records) { user_repository.find(:blah => 'Bob') }
+          let(:records) { user_repository.where(:blah => 'Bob') }
 
           it { expect { records }.to raise_exception(Datamappify::Data::EntityAttributeInvalid) }
         end
 
         describe "by primary attribute" do
-          let(:records) { user_repository.find(:first_name => 'Bob') }
+          let(:records) { user_repository.where(:first_name => 'Bob') }
           subject       { records }
 
           it { should have(3).users }
@@ -46,7 +49,7 @@ shared_examples_for "finders" do |data_provider|
         end
 
         describe "by secondary attribute" do
-          let(:records) { user_repository.find(:driver_license => 'NO_LICENSE') }
+          let(:records) { user_repository.where(:driver_license => 'NO_LICENSE') }
           subject       { records }
 
           it { should have(2).user }
@@ -61,7 +64,7 @@ shared_examples_for "finders" do |data_provider|
 
         describe "by primary and secondary attributes" do
           context "example 1" do
-            let(:records) { user_repository.find(:first_name => 'Bob', :driver_license => 'NO_LICENSE') }
+            let(:records) { user_repository.where(:first_name => 'Bob', :driver_license => 'NO_LICENSE') }
             subject       { records }
 
             it { should have(1).user }
@@ -75,7 +78,7 @@ shared_examples_for "finders" do |data_provider|
           end
 
           context "example 2" do
-            let(:records) { user_repository.find(:first_name => 'Bob', :driver_license => 'IDONTCARE') }
+            let(:records) { user_repository.where(:first_name => 'Bob', :driver_license => 'IDONTCARE') }
             subject       { records }
 
             it { should have(2).users }
@@ -89,13 +92,13 @@ shared_examples_for "finders" do |data_provider|
           end
 
           context "example 3" do
-            subject { user_repository.find(:first_name => 'Nope', :driver_license => 'IDONTCARE') }
+            subject { user_repository.where(:first_name => 'Nope', :driver_license => 'IDONTCARE') }
 
             it { should be_empty }
           end
 
           context "example 4" do
-            subject { user_repository.find(:first_name => 'Bob', :driver_license => 'NOPE') }
+            subject { user_repository.where(:first_name => 'Bob', :driver_license => 'NOPE') }
 
             it { should be_empty }
           end

data/spec/repository/reverse_mapped_spec.rb

@@ -1,11 +1,11 @@
 require 'spec_helper'
 
 shared_examples_for "reverse mapped" do |data_provider|
-  let!(:author_repository) { "AuthorRepository#{data_provider}".constantize }
-  let!(:post_repository)   { "PostRepository#{data_provider}".constantize }
-  let(:new_author)         { Author.new(:name => 'George R. R. Martin', :bio => 'GoT') }
-  let(:new_post)           { Post.new(:title => 'Hello world', :author_name => 'Fred Wu', :author_bio => 'x')}
-  let(:new_post_2)         { Post.new(:title => 'Hello earth', :author_name => 'Sheldon Cooper', :author_bio => 'y')}
+  let!(:author_repository) { "Reversed::AuthorRepository#{data_provider}".constantize }
+  let!(:post_repository)   { "Reversed::PostRepository#{data_provider}".constantize }
+  let(:new_author)         { Reversed::Author.new(:name => 'George R. R. Martin', :bio => 'GoT') }
+  let(:new_post)           { Reversed::Post.new(:title => 'Hello world', :author_name => 'Fred Wu', :author_bio => 'x')}
+  let(:new_post_2)         { Reversed::Post.new(:title => 'Hello earth', :author_name => 'Sheldon Cooper', :author_bio => 'y')}
 
   context "#{data_provider}" do
     before do

data/spec/support/entities/reversed/author.rb

@@ -0,0 +1,8 @@
+module Reversed
+  class Author
+    include Datamappify::Entity
+
+    attribute :name, String
+    attribute :bio,  String
+  end
+end

data/spec/support/entities/{post.rb → reversed/post.rb}

@@ -1,9 +1,9 @@
 require_relative 'author'
 
-class Post
+class Reversed::Post
   include Datamappify::Entity
 
   attribute :title, String
 
-  attributes_from Author, :prefix_with => :author
+  attributes_from Reversed::Author, :prefix_with => :author
 end

data/spec/support/repositories/active_record/computer_repository.rb

@@ -8,13 +8,13 @@ class ComputerRepositoryActiveRecord
   for_entity Computer
   default_provider :ActiveRecord
 
-  map_attribute :cpu,             'ActiveRecord::ComputerComponent::Hardware#cpu'
-  map_attribute :ram,             'ActiveRecord::ComputerComponent::Hardware#ram'
-  map_attribute :hdd,             'ActiveRecord::ComputerComponent::Hardware#hdd'
-  map_attribute :gfx,             'ActiveRecord::ComputerComponent::Hardware#gfx'
-  map_attribute :vendor,          'ActiveRecord::ComputerComponent::Hardware#vendor'
-  map_attribute :software_os,     'ActiveRecord::ComputerSoftware#os'
-  map_attribute :software_vendor, 'ActiveRecord::ComputerSoftware#vendor'
-  map_attribute :game_os,         'ActiveRecord::ComputerSoftware#os',     :via => :game_id
-  map_attribute :game_vendor,     'ActiveRecord::ComputerSoftware#vendor', :via => :game_id
+  map_attribute :cpu,             :to => 'ComputerComponent::Hardware#cpu'
+  map_attribute :ram,             :to => 'ComputerComponent::Hardware#ram'
+  map_attribute :hdd,             :to => 'ComputerComponent::Hardware#hdd'
+  map_attribute :gfx,             :to => 'ComputerComponent::Hardware#gfx'
+  map_attribute :vendor,          :to => 'ComputerComponent::Hardware#vendor'
+  map_attribute :software_os,     :to => 'ComputerSoftware#os'
+  map_attribute :software_vendor, :to => 'ComputerSoftware#vendor'
+  map_attribute :game_os,         :to => 'ComputerSoftware#os',     :via => :game_id
+  map_attribute :game_vendor,     :to => 'ComputerSoftware#vendor', :via => :game_id
 end

data/spec/support/repositories/active_record/reversed/author_repository.rb

@@ -0,0 +1,8 @@
+module Reversed
+  class AuthorRepositoryActiveRecord
+    include Datamappify::Repository
+
+    for_entity Author
+    default_provider :ActiveRecord
+  end
+end

data/spec/support/repositories/active_record/reversed/post_repository.rb

@@ -0,0 +1,13 @@
+module Reversed
+  class PostRepositoryActiveRecord
+    include Datamappify::Repository
+
+    for_entity Post
+    default_provider :ActiveRecord
+
+    group :provider => :ActiveRecord, :via => :author_id do
+      map_attribute :author_name, :to => 'Reversed::Author#name'
+      map_attribute :author_bio,  :to => 'Reversed::Author#bio'
+    end
+  end
+end

data/spec/support/repositories/active_record/user_repository.rb

@@ -4,8 +4,8 @@ class UserRepositoryActiveRecord
   for_entity User
   default_provider :ActiveRecord
 
-  map_attribute :last_name,      'ActiveRecord::User#surname'
-  map_attribute :driver_license, 'ActiveRecord::UserDriverLicense#number'
-  map_attribute :passport,       'ActiveRecord::UserPassport#number'
-  map_attribute :health_care,    'ActiveRecord::UserHealthCare#number'
+  map_attribute :last_name,      :to => 'User#surname'
+  map_attribute :driver_license, :to => 'UserDriverLicense#number'
+  map_attribute :passport,       :to => 'UserPassport#number'
+  map_attribute :health_care,    :to => 'UserHealthCare#number'
 end

data/spec/support/repositories/callbacks_chaining_repository.rb

@@ -4,9 +4,9 @@ class CallbacksChainingRepository
   for_entity HeroUser
   default_provider :ActiveRecord
 
-  map_attribute :first_name, 'ActiveRecord::HeroUser#first_name'
-  map_attribute :last_name,  'Sequel::HeroUserLastName#last_name'
-  map_attribute :gender,     'Sequel::HeroUserLastName#gender'
+  map_attribute :first_name, :to => 'HeroUser#first_name'
+  map_attribute :last_name,  :to => 'HeroUserLastName#last_name', :provider => :Sequel
+  map_attribute :gender,     :to => 'HeroUserLastName#gender',    :provider => :Sequel
 
   before_save   :before_save_1
   before_save   :before_save_2
@@ -39,9 +39,9 @@ class CallbacksChainingPauseBeforeRepository
   for_entity HeroUser
   default_provider :ActiveRecord
 
-  map_attribute :first_name, 'ActiveRecord::HeroUser#first_name'
-  map_attribute :last_name,  'Sequel::HeroUserLastName#last_name'
-  map_attribute :gender,     'Sequel::HeroUserLastName#gender'
+  map_attribute :first_name, :to => 'HeroUser#first_name'
+  map_attribute :last_name,  :to => 'HeroUserLastName#last_name', :provider => :Sequel
+  map_attribute :gender,     :to => 'HeroUserLastName#gender',    :provider => :Sequel
 
   before_save   :before_save_1
   before_save   :before_save_2
@@ -74,9 +74,9 @@ class CallbacksChainingPauseAfterRepository
   for_entity HeroUser
   default_provider :ActiveRecord
 
-  map_attribute :first_name, 'ActiveRecord::HeroUser#first_name'
-  map_attribute :last_name,  'Sequel::HeroUserLastName#last_name'
-  map_attribute :gender,     'Sequel::HeroUserLastName#gender'
+  map_attribute :first_name, :to => 'HeroUser#first_name'
+  map_attribute :last_name,  :to => 'HeroUserLastName#last_name', :provider => :Sequel
+  map_attribute :gender,     :to => 'HeroUserLastName#gender',    :provider => :Sequel
 
   before_save   :before_save_1
   before_save   :before_save_2

data/spec/support/repositories/hero_user_repository.rb

@@ -4,9 +4,12 @@ class HeroUserRepository
   for_entity HeroUser
   default_provider :ActiveRecord
 
-  map_attribute :first_name, 'ActiveRecord::HeroUser#first_name'
-  map_attribute :last_name,  'Sequel::HeroUserLastName#last_name'
-  map_attribute :gender,     'Sequel::HeroUserLastName#gender'
+  map_attribute :first_name, :to => 'HeroUser#first_name'
+
+  group :provider => :Sequel do
+    map_attribute :last_name, :to => 'HeroUserLastName#last_name'
+    map_attribute :gender,    :to => 'HeroUserLastName#gender'
+  end
 
   before_create  :action_before_create
   before_create  :action_before_create_2

data/spec/support/repositories/sequel/computer_repository.rb

@@ -4,13 +4,13 @@ class ComputerRepositorySequel
   for_entity Computer
   default_provider :Sequel
 
-  map_attribute :cpu,             'Sequel::ComputerComponent::Hardware#cpu'
-  map_attribute :ram,             'Sequel::ComputerComponent::Hardware#ram'
-  map_attribute :hdd,             'Sequel::ComputerComponent::Hardware#hdd'
-  map_attribute :gfx,             'Sequel::ComputerComponent::Hardware#gfx'
-  map_attribute :vendor,          'Sequel::ComputerComponent::Hardware#vendor'
-  map_attribute :software_os,     'Sequel::ComputerComponent::Software#os'
-  map_attribute :software_vendor, 'Sequel::ComputerComponent::Software#vendor'
-  map_attribute :game_os,         'Sequel::ComputerComponent::Software#os',     :via => :game_id
-  map_attribute :game_vendor,     'Sequel::ComputerComponent::Software#vendor', :via => :game_id
+  map_attribute :cpu,             :to => 'ComputerComponent::Hardware#cpu'
+  map_attribute :ram,             :to => 'ComputerComponent::Hardware#ram'
+  map_attribute :hdd,             :to => 'ComputerComponent::Hardware#hdd'
+  map_attribute :gfx,             :to => 'ComputerComponent::Hardware#gfx'
+  map_attribute :vendor,          :to => 'ComputerComponent::Hardware#vendor'
+  map_attribute :software_os,     :to => 'ComputerComponent::Software#os'
+  map_attribute :software_vendor, :to => 'ComputerComponent::Software#vendor'
+  map_attribute :game_os,         :to => 'ComputerComponent::Software#os',     :via => :game_id
+  map_attribute :game_vendor,     :to => 'ComputerComponent::Software#vendor', :via => :game_id
 end

data/spec/support/repositories/sequel/reversed/author_repository.rb

@@ -0,0 +1,8 @@
+module Reversed
+  class AuthorRepositorySequel
+    include Datamappify::Repository
+
+    for_entity Author
+    default_provider :Sequel
+  end
+end

data/spec/support/repositories/sequel/reversed/post_repository.rb

@@ -0,0 +1,13 @@
+module Reversed
+  class PostRepositorySequel
+    include Datamappify::Repository
+
+    for_entity Post
+    default_provider :Sequel
+
+    group :provider => :Sequel, :via => :author_id do
+      map_attribute :author_name, :to => 'Reversed::Author#name'
+      map_attribute :author_bio,  :to => 'Reversed::Author#bio'
+    end
+  end
+end

data/spec/support/repositories/sequel/user_repository.rb

@@ -4,8 +4,8 @@ class UserRepositorySequel
   for_entity User
   default_provider :Sequel
 
-  map_attribute :last_name,      'Sequel::User#surname'
-  map_attribute :driver_license, 'Sequel::UserDriverLicense#number'
-  map_attribute :passport,       'Sequel::UserPassport#number'
-  map_attribute :health_care,    'Sequel::UserHealthCare#number'
+  map_attribute :last_name,      :to => 'User#surname'
+  map_attribute :driver_license, :to => 'UserDriverLicense#number'
+  map_attribute :passport,       :to => 'UserPassport#number'
+  map_attribute :health_care,    :to => 'UserHealthCare#number'
 end

data/spec/support/tables/active_record.rb

@@ -64,16 +64,15 @@ ActiveRecord::Migration.suppress_messages do
       t.timestamps
     end
 
-    create_table :posts do |t|
+    create_table :reversed_posts do |t|
       t.string :title
       t.references :author
       t.timestamps
     end
 
-    create_table :authors do |t|
+    create_table :reversed_authors do |t|
       t.string :name
       t.string :bio
-      t.references :post
       t.timestamps
     end
 

data/spec/support/tables/sequel.rb

@@ -77,7 +77,7 @@ DB.create_table :user_health_cares do
   DateTime :updated_at
 end
 
-DB.create_table :posts do |t|
+DB.create_table :reversed_posts do |t|
   primary_key :id
   String :title
   foreign_key :author_id
@@ -85,11 +85,10 @@ DB.create_table :posts do |t|
   DateTime :updated_at
 end
 
-DB.create_table :authors do |t|
+DB.create_table :reversed_authors do |t|
   primary_key :id
   String :name
   String :bio
-  foreign_key :post_id
   DateTime :created_at
   DateTime :updated_at
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: datamappify
 version: !ruby/object:Gem::Version
-  version: 0.53.2
+  version: 0.60.0
 platform: ruby
 authors:
 - Fred Wu
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-18 00:00:00.000000000 Z
+date: 2013-07-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: virtus
@@ -270,6 +270,7 @@ files:
 - Rakefile
 - datamappify.gemspec
 - lib/datamappify.rb
+- lib/datamappify/config.rb
 - lib/datamappify/data.rb
 - lib/datamappify/data/criteria.rb
 - lib/datamappify/data/criteria/active_record/count.rb
@@ -341,6 +342,7 @@ files:
 - lib/datamappify/repository/unit_of_work/persistent_states/object.rb
 - lib/datamappify/repository/unit_of_work/transaction.rb
 - lib/datamappify/version.rb
+- spec/config_spec.rb
 - spec/entity/composable_spec.rb
 - spec/entity/inheritance_spec.rb
 - spec/entity/relation_spec.rb
@@ -358,33 +360,33 @@ files:
 - spec/repository_spec.rb
 - spec/spec_helper.rb
 - spec/support/entities/admin_user.rb
-- spec/support/entities/author.rb
 - spec/support/entities/comment.rb
 - spec/support/entities/computer.rb
 - spec/support/entities/computer_component/hardware.rb
 - spec/support/entities/computer_component/software.rb
 - spec/support/entities/group.rb
 - spec/support/entities/hero_user.rb
-- spec/support/entities/post.rb
+- spec/support/entities/reversed/author.rb
+- spec/support/entities/reversed/post.rb
 - spec/support/entities/role.rb
 - spec/support/entities/user.rb
 - spec/support/monkey_patches/database_cleaner.rb
 - spec/support/repositories/active_record/admin_user_repository.rb
-- spec/support/repositories/active_record/author_repository.rb
 - spec/support/repositories/active_record/comment_repository.rb
 - spec/support/repositories/active_record/computer_repository.rb
 - spec/support/repositories/active_record/group_repository.rb
-- spec/support/repositories/active_record/post_repository.rb
+- spec/support/repositories/active_record/reversed/author_repository.rb
+- spec/support/repositories/active_record/reversed/post_repository.rb
 - spec/support/repositories/active_record/role_repository.rb
 - spec/support/repositories/active_record/user_repository.rb
 - spec/support/repositories/callbacks_chaining_repository.rb
 - spec/support/repositories/hero_user_repository.rb
 - spec/support/repositories/sequel/admin_user_repository.rb
-- spec/support/repositories/sequel/author_repository.rb
 - spec/support/repositories/sequel/comment_repository.rb
 - spec/support/repositories/sequel/computer_repository.rb
 - spec/support/repositories/sequel/group_repository.rb
-- spec/support/repositories/sequel/post_repository.rb
+- spec/support/repositories/sequel/reversed/author_repository.rb
+- spec/support/repositories/sequel/reversed/post_repository.rb
 - spec/support/repositories/sequel/role_repository.rb
 - spec/support/repositories/sequel/user_repository.rb
 - spec/support/shared/contexts.rb
@@ -419,6 +421,7 @@ specification_version: 4
 summary: Compose, decouple and manage domain logic and data persistence separately.
   Works particularly great for composing form objects!
 test_files:
+- spec/config_spec.rb
 - spec/entity/composable_spec.rb
 - spec/entity/inheritance_spec.rb
 - spec/entity/relation_spec.rb
@@ -436,33 +439,33 @@ test_files:
 - spec/repository_spec.rb
 - spec/spec_helper.rb
 - spec/support/entities/admin_user.rb
-- spec/support/entities/author.rb
 - spec/support/entities/comment.rb
 - spec/support/entities/computer.rb
 - spec/support/entities/computer_component/hardware.rb
 - spec/support/entities/computer_component/software.rb
 - spec/support/entities/group.rb
 - spec/support/entities/hero_user.rb
-- spec/support/entities/post.rb
+- spec/support/entities/reversed/author.rb
+- spec/support/entities/reversed/post.rb
 - spec/support/entities/role.rb
 - spec/support/entities/user.rb
 - spec/support/monkey_patches/database_cleaner.rb
 - spec/support/repositories/active_record/admin_user_repository.rb
-- spec/support/repositories/active_record/author_repository.rb
 - spec/support/repositories/active_record/comment_repository.rb
 - spec/support/repositories/active_record/computer_repository.rb
 - spec/support/repositories/active_record/group_repository.rb
-- spec/support/repositories/active_record/post_repository.rb
+- spec/support/repositories/active_record/reversed/author_repository.rb
+- spec/support/repositories/active_record/reversed/post_repository.rb
 - spec/support/repositories/active_record/role_repository.rb
 - spec/support/repositories/active_record/user_repository.rb
 - spec/support/repositories/callbacks_chaining_repository.rb
 - spec/support/repositories/hero_user_repository.rb
 - spec/support/repositories/sequel/admin_user_repository.rb
-- spec/support/repositories/sequel/author_repository.rb
 - spec/support/repositories/sequel/comment_repository.rb
 - spec/support/repositories/sequel/computer_repository.rb
 - spec/support/repositories/sequel/group_repository.rb
-- spec/support/repositories/sequel/post_repository.rb
+- spec/support/repositories/sequel/reversed/author_repository.rb
+- spec/support/repositories/sequel/reversed/post_repository.rb
 - spec/support/repositories/sequel/role_repository.rb
 - spec/support/repositories/sequel/user_repository.rb
 - spec/support/shared/contexts.rb

data/spec/support/entities/author.rb

@@ -1,6 +0,0 @@
-class Author
-  include Datamappify::Entity
-
-  attribute :name, String
-  attribute :bio,  String
-end

data/spec/support/repositories/active_record/author_repository.rb

@@ -1,6 +0,0 @@
-class AuthorRepositoryActiveRecord
-  include Datamappify::Repository
-
-  for_entity Author
-  default_provider :ActiveRecord
-end

data/spec/support/repositories/active_record/post_repository.rb

@@ -1,9 +0,0 @@
-class PostRepositoryActiveRecord
-  include Datamappify::Repository
-
-  for_entity Post
-  default_provider :ActiveRecord
-
-  map_attribute :author_name, 'ActiveRecord::Author#name', :via => :author_id
-  map_attribute :author_bio,  'ActiveRecord::Author#bio'
-end

data/spec/support/repositories/sequel/author_repository.rb

@@ -1,6 +0,0 @@
-class AuthorRepositorySequel
-  include Datamappify::Repository
-
-  for_entity Author
-  default_provider :Sequel
-end

data/spec/support/repositories/sequel/post_repository.rb

@@ -1,9 +0,0 @@
-class PostRepositorySequel
-  include Datamappify::Repository
-
-  for_entity Post
-  default_provider :Sequel
-
-  map_attribute :author_name, 'Sequel::Author#name', :via => :author_id
-  map_attribute :author_bio,  'Sequel::Author#bio'
-end