minimapper 0.5.2 → 0.5.3

data/README.md

@@ -252,6 +252,24 @@ Minimapper only calls #convert on non-empty strings. When the value is blank or
 
 There is no built in support for associations yet, but you can handle them manually (see https://github.com/joakimk/minimapper/issues/3).
 
+### Lifecycle hooks
+
+#### after_find
+
+This is called after any kind of find and can be used for things like loading associated data.
+
+The parameters to the after_find hook differs between mappers, for example the ActiveRecord mapper provides a record as the second argument. In practice this should not be a problem as each mapper class in an app only implements one type of mapper.
+
+``` ruby
+class ProjectMapper < Minimapper::AR
+  private
+
+  def after_find(entity, record)
+    entity.owner = User.new(record.owner.attributes)
+  end
+end
+```
+
 ### Custom entity class
 
 [Minimapper::Entity](https://github.com/joakimk/minimapper/blob/master/lib/minimapper/entity.rb) adds some convenience methods for when a model is used within a rails application. If you don't need that you can just include the core API from the [Minimapper::Entity::Core](https://github.com/joakimk/minimapper/blob/master/lib/minimapper/entity/core.rb) module (or implement your own version that behaves like [Minimapper::Entity::Core](https://github.com/joakimk/minimapper/blob/master/lib/minimapper/entity/core.rb)).

data/lib/minimapper/mapper/ar.rb

@@ -128,11 +128,21 @@ module Minimapper
           entity = klass.new
           entity.id = record.id
           entity.attributes = record.attributes.symbolize_keys
+
+          if klass == entity_class
+            after_find(entity, record)
+          end
+
           entity
         else
           nil
         end
       end
+
+      # Hooks
+
+      def after_find(entity, record)
+      end
     end
   end
 end

data/lib/minimapper/mapper/memory.rb

@@ -81,7 +81,9 @@ module Minimapper
       end
 
       def find_internal(id)
-        id && store.find { |e| e.id == id.to_i }
+        entity = id && store.find { |e| e.id == id.to_i }
+        after_find(entity)
+        entity
       end
 
       def next_id
@@ -89,6 +91,11 @@ module Minimapper
       end
 
       attr_reader :store, :last_id
+
+      # Hooks
+
+      def after_find(entity)
+      end
     end
   end
 end

data/lib/minimapper/version.rb

@@ -1,3 +1,3 @@
 module Minimapper
-  VERSION = "0.5.2"
+  VERSION = "0.5.3"
 end

data/spec/support/shared_examples/mapper.rb

@@ -63,6 +63,13 @@ shared_examples :mapper do
       mapper.find(entity.id).object_id.should_not == mapper.find(entity.id).object_id
     end
 
+    it "calls after_find on the mapper" do
+      entity = build_valid_entity
+      mapper.create(entity)
+      mapper.should_receive(:after_find)
+      found_entity = mapper.find(entity.id)
+    end
+
     it "fails when an entity can not be found" do
       lambda { mapper.find(-1) }.should raise_error(Minimapper::EntityNotFound)
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minimapper
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.5.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-29 00:00:00.000000000 Z
+date: 2013-05-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70225357873540 !ruby/object:Gem::Requirement
+  requirement: &70136082132800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,7 +21,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70225357873540
+  version_requirements: *70136082132800
 description: A minimalistic way of separating your models from ORMs like ActiveRecord.
 email:
 - joakim.kolsjo@gmail.com