ar_merge 0.1.2

data/README.markdown

@@ -0,0 +1,43 @@
+ - Merges associations/attributes you want
+ - Can merge duplicates
+ - Protects from self-merges
+ - Keeps counters valid
+ - Removes merged record
+
+
+INSTALL
+=======
+
+Rails plugin
+
+    script/plugin install git://github.com/grosser/ar_merge.git
+
+OR Gem
+
+    sudo gem install ar_merge
+
+
+USAGE
+=====
+Merge from outside the model:
+
+    user.merge!(other,:attributes=>user.attributes.keys,:associations=>%w[movies friends])`
+
+Merge from inside the model
+
+    User < ActiveRecord::Base
+      def merge!(other)
+        super(other,:attributes=>%w[email website])
+      end
+    end
+
+Merge duplicates
+
+    #merge all new users, that have the same email
+    User.merge_duplicates!(User.find_all_by_status('new')) , :compare=>:email)
+
+AUTHOR
+======
+[Michael Grosser](http://pragmatig.wordpress.com)  
+grosser.michael@gmail.com
+Hereby placed under public domain, do what you want, just do not hold me accountable...

data/Rakefile

@@ -0,0 +1,20 @@
+task :default => :spec
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new {|t| t.spec_opts = ['--color']}
+
+begin
+  require 'jeweler'
+  project_name = 'ar_merge'
+  Jeweler::Tasks.new do |gem|
+    gem.name = project_name
+    gem.summary = "Merge 2 ActiveRecords, preserving associations and attributes"
+    gem.email = "grosser.michael@gmail.com"
+    gem.homepage = "http://github.com/grosser/#{project_name}"
+    gem.authors = ["Michael Grosser"]
+    gem.add_dependency ['activerecord']
+  end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.2

data/ar_merge.gemspec

@@ -0,0 +1,52 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ar_merge}
+  s.version = "0.1.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Grosser"]
+  s.date = %q{2009-11-22}
+  s.email = %q{grosser.michael@gmail.com}
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "ar_merge.gemspec",
+     "init.rb",
+     "lib/ar_merge.rb",
+     "spec/ar_merge_spec.rb",
+     "spec/setup_test_model.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/grosser/ar_merge}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Merge 2 ActiveRecords, preserving associations and attributes}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/ar_merge_spec.rb",
+     "spec/setup_test_model.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activerecord>, [">= 0"])
+    else
+      s.add_dependency(%q<activerecord>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activerecord>, [">= 0"])
+  end
+end
+

data/init.rb

@@ -0,0 +1 @@
+require 'ar_merge'

data/lib/ar_merge.rb

@@ -0,0 +1,58 @@
+require 'activerecord'
+
+module ARMerge
+  VERSION = File.read( File.join(File.dirname(__FILE__),'..','VERSION') ).strip
+
+  def self.included(base)
+    base.extend ClassMethods
+    base.send(:include, InstanceMethods)
+  end
+
+  module InstanceMethods
+    def merge!(other, options={})
+      raise "cannot merge wit a new record" if other.new_record?
+      raise "cannot merge with myself" if other == self
+
+      #merge associations
+      (options[:associations]||[]).each do |association_name|
+        other.send(association_name).each do |associated|
+          send(association_name) << associated
+        end
+        
+        #update counters, this is very basic/hacky/not secure for customized counters...
+        counter = "#{association_name}_count"
+        next unless other.respond_to?(counter)
+        self.class.update_counters(id, counter => other.send(counter))
+      end
+
+      #merge attributes
+      (options[:attributes]||[]).each do |attr|
+        send("#{attr}=", other.send(attr)) if send(attr).blank?
+      end
+
+      #cleanup
+      other.reload.destroy
+      save!
+    end
+  end
+
+  module ClassMethods
+    def merge_duplicates!(records,options)
+      records.each do |record|
+        next if record.nil?
+        records.each do |other|
+          next if other.nil?
+          next if other == record
+          is_comparable = other.send(options[:compare]) == record.send(options[:compare])
+          next unless is_comparable
+
+          #merge and remove the other
+          records[records.index(other)]=nil
+          record.merge!(other)
+        end
+      end.compact
+    end
+  end
+end
+
+ActiveRecord::Base.send(:include, ARMerge)

data/spec/ar_merge_spec.rb

@@ -0,0 +1,102 @@
+require "spec/spec_helper"
+
+describe ARMerge do
+  describe :merge! do
+    before do
+      @user = User.create!(:name=>'x')
+      @u2 = User.create!(:name=>'y')
+    end
+
+    describe :removal do
+      it "removes the merged user" do
+        @user.merge!(@u2)
+        lambda{@u2.reload}.should raise_error(ActiveRecord::RecordNotFound)
+      end
+
+      it "saves the merging user" do
+        @user.should_receive(:save!)
+        @user.merge!(@u2)
+      end
+    end
+
+    describe :attributes do
+      it "merges and overtakes attributes" do
+        @user.name = ''
+        @user.merge!(@u2,:attributes=>['name'])
+        @user.name.should == 'y'
+      end
+
+      it "does not overtake attributes when current is not blank" do
+        @user.merge!(@u2,:attributes=>['name'])
+        @user.name.should == 'x'
+      end
+    end
+
+    describe :associations do
+      before do
+        Movie.delete_all
+        @user.movies << Movie.new
+        @user.save!
+        @user.movies.size.should == Movie.count
+      end
+
+      it "overtakes asociated objects" do
+        @u2.merge!(@user,:associations=>[:movies])
+        @u2.reload.should have(Movie.count).movies
+      end
+
+      it "does not create new objects" do
+        lambda{@u2.merge!(@user,:associations=>['movies'])}.should_not change(Movie,:count)
+      end
+
+      it "keeps counters in sync" do
+        user, merged_user = CountingUser.create!, CountingUser.create!
+        user.movies_count.should == 0
+        merged_user.movies << Movie.new
+        merged_user.save!
+        merged_user.reload.movies_count.should == 1
+
+        user.merge!(merged_user,:associations=>[:movies])
+        user.reload.movies_count.should == 1
+      end
+    end
+
+    it "does no merge with new" do
+      lambda{@user.merge!(User.new)}.should raise_error
+    end
+
+    it "does no merge with self" do
+      lambda{@user.merge!(User.find(@user.id))}.should raise_error
+    end
+  end
+
+  describe :merge_duplicates! do
+    before do
+      @u1 = User.create!(:name=>'a')
+      @u2 = User.create!(:name=>'b')
+      @u3 = User.create!(:name=>'a')
+      @u4 = User.create!(:name=>'a')
+      @users=[@u1,@u2,@u3]
+    end
+
+    it "merges all records that have the same attributes" do
+      User.merge_duplicates!(@users,:compare=>:name).should == [@u1,@u2]
+    end
+
+    it "destroys the duplicates" do
+      User.merge_duplicates!(@users,:compare=>:name)
+      lambda{@u3.reload}.should raise_error(ActiveRecord::RecordNotFound)
+    end
+
+    it "merges the first with each of its duplicates" do
+      @users = [@u2,@u3,@u1,@u4]
+      @u3.should_receive(:merge!).with(@u1)
+      @u3.should_receive(:merge!).with(@u4)
+      User.merge_duplicates!(@users,:compare=>:name).should == [@u2,@u3]
+    end
+  end
+
+  it "has a VERSION" do
+    ARMerge::VERSION.should =~ /^\d+\.\d+\.\d+$/
+  end
+end

data/spec/setup_test_model.rb

@@ -0,0 +1,41 @@
+# connect
+ActiveRecord::Base.configurations = {"test" => {
+  :adapter => "sqlite3",
+  :database => ":memory:",
+}.with_indifferent_access}
+
+ActiveRecord::Base.establish_connection(:test)
+
+# create tables
+ActiveRecord::Schema.define(:version => 1) do
+  create_table :users do |t|
+    t.string :name
+    t.timestamps
+  end
+
+  create_table :counting_users do |t|
+    t.integer :movies_count, :default=>0, :null=>false
+    t.string :name
+    t.timestamps
+  end
+
+  create_table :movies do |t|
+    t.integer :user_id
+    t.integer :counting_user_id
+    t.timestamps
+  end
+end
+
+# create models
+class User < ActiveRecord::Base
+  has_many :movies
+end
+
+class CountingUser < ActiveRecord::Base
+  has_many :movies
+end
+
+class Movie < ActiveRecord::Base
+  belongs_to :user
+  belongs_to :counting_user, :counter_cache => true
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'rubygems'
+$LOAD_PATH << "lib"
+require "init"
+require "spec/setup_test_model"

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: ar_merge
+version: !ruby/object:Gem::Version 
+  version: 0.1.2
+platform: ruby
+authors: 
+- Michael Grosser
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-22 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: 
+email: grosser.michael@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+- Rakefile
+- VERSION
+- ar_merge.gemspec
+- init.rb
+- lib/ar_merge.rb
+- spec/ar_merge_spec.rb
+- spec/setup_test_model.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/grosser/ar_merge
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Merge 2 ActiveRecords, preserving associations and attributes
+test_files: 
+- spec/spec_helper.rb
+- spec/ar_merge_spec.rb
+- spec/setup_test_model.rb