record_collection 0.8.2 → 0.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8105f9981da0c30ff4cea3a5de92bf724b6a53d2
-  data.tar.gz: 74efbf9e4cfbe05de9745eaae179f69317b91b0a
+  metadata.gz: 6a1f2fc09b1f3aa4398ce4a15a126112e3dac101
+  data.tar.gz: 9aa4a6bff6c18594e8f4dbabb3efd4abde222a94
 SHA512:
-  metadata.gz: 5129d5f5f6104a49305680d9093a4b33f5efc322397d63fc2935a0eafea2900ecf29d489939a2f55d2c73cff035ed76c24eaccf9512a0acce08b8aeed58356cc
-  data.tar.gz: 897479481ce00c0e9b20305bac81b69d2433b83aee09f4798b1afe3c0a3c5ddb244a0a0fbab49f30618108dde7eabb8f25283766a2efa21c39fefbe2674dbdb9
+  metadata.gz: cfabb7c0d78aa856f3a10eda8260e1865d6ee83727ac717d0b0b9115b8d0c2dc573ebc40de763ed39641e91f2881cb1dfaac02767c470edc06afa4ef337205e3
+  data.tar.gz: 8d08ada30d3c68e32f62e97df0a8e4795ab8f8050551e30ba9d81e10216b124ed85c99c78202d4a9cccf7ce48a3dc25951f08a79cfb9e163a299abeffda457ca

data/CHANGELOG.md

@@ -0,0 +1,16 @@
+CHANGELOG
+=========
+
+2015-11-03 - v0.8.3
+-------------------
+
+### Added
+* before\_record\_update hook
+
+
+2015-11-03 - v0.8.2
+-------------------
+
+### Added
+* Smarter find on collection object
+

data/README.md

@@ -118,6 +118,19 @@ class MyAwesomeCollection < RecordCollection::Base
 end
 ```
 
+### The `before_record_update` hook
+The collection implements a general `update(attributes)` method that will
+update all the attributes that are set in the collection on the records it contains.
+If you want precondition your data you can do so in this hook:
+
+```ruby
+class Project::Prince2::Collection < RecordCollection::Base
+  before_record_update do |record|
+    record.plan_date_set = true if plan_date.present?
+  end
+end
+```
+
 ### The `after_record_update` hook
 The collection implements a general `update(attributes)` method that will
 update all the attributes that are set in the collection on the records it contains.

data/lib/record_collection/base.rb

@@ -28,6 +28,14 @@ module RecordCollection
         @record_class = klass
       end
 
+      def before_record_update(&blk)
+        if blk
+          @before_record_update = blk
+        else
+          @before_record_update
+        end
+      end
+
       def after_record_update(&blk)
         if blk
           @after_record_update = blk
@@ -93,7 +101,9 @@ module RecordCollection
 
     def update_collection_attributes!
       after_blk = self.class.after_record_update
+      before_blk = self.class.before_record_update
       each do |record|
+        before_blk.call(record) if before_blk
         record.update changed_attributes
         after_blk.call(record) if after_blk
       end

data/lib/record_collection/version.rb

@@ -1,3 +1,3 @@
 module RecordCollection
-  VERSION = "0.8.2"
+  VERSION = "0.8.3"
 end

data/spec/base/after_record_update_spec.rb

@@ -5,10 +5,18 @@ class AfterRecordUpdateCollection < RecordCollection::Base
 end
 RSpec.describe AfterRecordUpdateCollection do
   subject { described_class.new }
+
   it "executes on the record" do
     employee = Employee.create section: 'SE1', admin: false
     described_class.new([employee]).update({})
     employee.reload
     employee.admin.should be true
   end
+
+  it "will not be overridden by the update action itself (hence after)" do
+    employee = Employee.create section: 'SE1', admin: false
+    described_class.new([employee]).update(admin: false)
+    employee.reload
+    employee.admin.should be true
+  end
 end

data/spec/base/before_record_update_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+class BeforeRecordUpdateCollection < RecordCollection::Base
+  attribute :section
+  attribute :admin
+  before_record_update{|record| record.admin = true }
+end
+RSpec.describe BeforeRecordUpdateCollection do
+  subject { described_class.new }
+  it "executes on the record" do
+    employee = Employee.create section: 'SE1', admin: false
+    described_class.new([employee]).update({})
+    employee.reload
+    employee.admin.should be true
+  end
+
+  it "will be overriden by the actual update action (hence before)" do
+    employee = Employee.create section: 'SE1', admin: false
+    described_class.new([employee]).update(admin: false)
+    employee.reload
+    employee.admin.should be false
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: record_collection
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.8.3
 platform: ruby
 authors:
 - Benjamin ter Kuile
@@ -356,6 +356,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -399,6 +400,7 @@ files:
 - record_collection.gemspec
 - spec/base/accessors_spec.rb
 - spec/base/after_record_update_spec.rb
+- spec/base/before_record_update_spec.rb
 - spec/base/behaviour_spec.rb
 - spec/base/finding_records_spec.rb
 - spec/base/inheritance_spec.rb
@@ -516,6 +518,7 @@ summary: Manage collections of records in Ruby on Rails
 test_files:
 - spec/base/accessors_spec.rb
 - spec/base/after_record_update_spec.rb
+- spec/base/before_record_update_spec.rb
 - spec/base/behaviour_spec.rb
 - spec/base/finding_records_spec.rb
 - spec/base/inheritance_spec.rb