has_many_callbacks 0.0.3 → 0.0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4702d26c8756bc050e4acf0daba8e4db79999678
-  data.tar.gz: 8422e002a2bc0a4aab26e7187b57a2acf5d08521
+  metadata.gz: f90ce44eb6ffe7889b256dc9de088c64bb89a09a
+  data.tar.gz: 25a2972a6594f730d0e72760481bf408e813f916
 SHA512:
-  metadata.gz: fe3d05719cd28020ad81c4b9754f8aa372065e5ce233464703940ffb399cfffbb8995c4047a8867d7566e42f85829fb226492145f4cb41a819fcccd99ecedf4e
-  data.tar.gz: 86afc2005b6cb85c0dcbc67db0c7ecadac108ba51ea2a4da17b5790b8f95cddd7291436df6df579813a46373db1133d7791e72c824c3e402a404f2083cc2f7ae
+  metadata.gz: 600a38824a6d6e6bd7559f5fba91bcc465e6158ecca63d22c84fd569096e398d49907d30451ee22927092f5b41ef813b1cab0e53885bfe335e04a8aa202e6bba
+  data.tar.gz: da6976393e652c35634b9b9013ff56829e1b6be5e311bffa5df196ea8701723e3dbcef31ec1f5f279b3e1baecb62219e071bb0ce2567922c79fcdc41f35ac278

data/README.rdoc

@@ -11,33 +11,66 @@ in the same way.
 
 The main goal is ensuring the code that expresses the relation parent behavior when handling events
 triggered by child objects is kept in the parent code base, where it belongs. If the parent
-has a lot of relations, this prevents that class' code to be scattered accross all the child
+has a lot of relations, this prevents that class' code to be scattered across all the child
 class definitions.
 
-=== Example
-Consider the following classes:
+=== Usage
 
-class TodoList
-  # name, completed
-  has_many :tasks
-end
+Just add a reference to Gemfile:
 
-class Task
-  # name, completed
-  belongs_to :todo_list
-end
+  gem install "has_many_callbacks"
 
-Imagine that a To-Do list is completed if it's not empty and all the tasks in it get are completed.
+As an example, consider the following classes:
 
-class TodoList
-  has_many :tasks,
-           :after_save => lambda { |todo_list, task|
-             todo_list.completed = !task.completed ? false : todo_list.tasks.map(&:completed).inject(&:&)
-             todo_list.save! if todo_list.completed_changed?
-           }
+  class TodoList < ActiveRecord::Base
+    # name, completed
+    has_many :tasks
+  end
 
-end
+  class Task < ActiveRecord::Base
+    # name, completed
+    belongs_to :todo_list
+  end
+
+Imagine that you want a To-Do list to be marked completed if it's not empty and all the tasks in it are completed.
+
+  class TodoList < ActiveRecord::Base
+    has_many :tasks, :inverse_of => :todo_list,
+             :after_save => lambda { |todo_list, task|
+               todo_list.completed = !task.completed ? false : todo_list.tasks.where(:completed => false).count == 0
+               todo_list.save! if todo_list.completed_changed?
+             },
+             :after_destroy => lambda { |todo_list, task|
+               todo_list.completed = (todo_list.tasks.any? and todo_list.tasks.where(:completed => false).count == 0)
+               todo_list.save! if todo_list.completed_changed?
+             }
+  
+  end
+
+Please note that the <tt>inverse_of</tt> option is required. Three callbacks are available, <tt>after_create</tt>,
+<tt>after_save</tt> and <tt>after_destroy</tt>.
+
+You can also pass callbacks as symbols refering to the instance methods to call:
+
+  class TodoList < ActiveRecord::Base
+    has_many :tasks,
+             :inverse_of => :todo_list,
+             :after_save => :handle_task_save,
+             :after_destroy => :handle_task_destroy
+             
+    private
+    
+    def handle_task_save(task)
+      self.completed = !task.completed ? false : tasks.where(:completed => false).count == 0
+      save! if completed_changed?
+    end
+    
+    def handle_task_destroy(task)
+      self.completed = (tasks.any? and tasks.where(:completed => false).count == 0)
+      save! if completed_changed?
+    end
+  end
 
 
 === License
-This software is provided under the MIT License. See MIT-LICENSE for details.
+This software is available under the MIT License. See MIT-LICENSE for details.

data/lib/has_many_callbacks.rb

@@ -4,6 +4,10 @@ module HasManyCallbacks
 
   class HasManyWithChildCallbacksBuilder < ActiveRecord::Associations::Builder::HasMany
     HAS_MANY_CALLBACKS = [ :after_create, :after_save, :after_destroy ]
+    def self.valid_options
+      super + HAS_MANY_CALLBACKS
+    end
+
     def valid_options
       super + HAS_MANY_CALLBACKS
     end
@@ -27,7 +31,7 @@ module HasManyCallbacks
         end
 
         code = %{
-          #{callback_name} do |obj|
+        #{callback_name} do |obj|
             association = obj.class.reflect_on_association(:#{association.inverse_of.name})
             inverse_association = association.klass.reflect_on_association(:#{association.name})
             callback_option = inverse_association.options[:#{callback_name}]
@@ -54,13 +58,24 @@ module HasManyCallbacks
     end
   end
 
+
   module ClassMethods
+  end
+
+  module ClassMethodsV4
     def has_many(name, scope = nil, options = {}, &extension)
       HasManyWithChildCallbacksBuilder.build(self, name, scope, options, &extension)
     end
   end
 
+  module ClassMethodsV3
+    def has_many(name, options = {}, &extension)
+      HasManyWithChildCallbacksBuilder.build(self, name, options, &extension)
+    end
+  end
 end
 
+module_to_include = ((Rails.version.split('.').first) || 4).to_i == 4 ?
+  HasManyCallbacks::ClassMethodsV4 : HasManyCallbacks::ClassMethodsV3
+HasManyCallbacks::ClassMethods.send(:include, module_to_include)
 ActiveRecord::Base.send(:include, HasManyCallbacks)
-ActiveRecord::Base.send(:include, HasManyCallbacks::ClassMethods)

data/lib/has_many_callbacks/version.rb

@@ -1,3 +1,3 @@
 module HasManyCallbacks
-  VERSION = "0.0.3"
+  VERSION = "0.0.3.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: has_many_callbacks
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.3.1
 platform: ruby
 authors:
 - Jose Fernandes
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-20 00:00:00.000000000 Z
+date: 2013-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails