data_active 0.0.1

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+Gemfile.lock
+pkg/*
+
+## MAC OS
+.DS_Store
+
+## RubyMine
+.idea
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+tmp
+.bundle
+doc
+
+## Logging
+*.log
+

data/.rvmrc

@@ -0,0 +1 @@
+rvm ruby-1.9.3-p125@data_active --create

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in data_active.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,275 @@
+= Data Active
+
+Rails has some really fantastic features for serialisation of ActiveRecord to XML however going back the other way is not so fantastic.  Data Active aims to provide the import of XML into your database while utilising the strengths of ActiveRecord. It extends ActiveRecord allowing it to seamlessly work in with your model.  Here are the features provided by Data Active:
+
+* Updating of records based on an XML document containing elements matching primary key
+* Creation of records based on elements in an XML
+* Removal of records based on an XML document containing elements matching primary key
+* Choose to only update, only create or only remove records
+* Choose to combine update, create and remove actions
+* Synchronise your database with an XML Document
+
+== The Background
+
+== XML Documents
+
+Data Active supports specific XML document styles including those created by ActiveRecord and Microsoft Access.  Following are soem samples of an XML documents that are supported.
+
+Active Record Style
+    <books type="array">
+      <book>
+        <id type="Integer">4</id>
+        <name>Book 1</name>
+      </book>
+      <book>
+        <id type="integer">5</id>
+        <name>Book 1</name>
+        <chapters type="array">
+          <chapter>
+            <id type="integer">1</id>
+            <title>Chapter 1</title>
+            <introduction>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</introduction>
+            <pages type="array">
+              <page>
+                <id type="integer">1</id>
+                <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+                <number>1</number>
+              </page>
+              <page>
+                <id type="integer">2</id>
+                <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+                <number>2</number>
+              </page>
+              <page>
+                <id type="integer">3</id>
+                <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+                <number>3</number>
+              </page>
+            </pages>
+          </chapter>
+          <chapter>
+            <id type="integer">2</id>
+            <title>Chapter 2</title>
+            <introduction>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</introduction>
+            <pages type="array">
+              <page>
+                <id type="integer">5</id>
+                <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+                <number>1</number>
+              </page>
+              <page>
+                <id type="integer">6</id>
+                <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+                <number>2</number>
+              </page>
+              <page>
+                <id type="integer">7</id>
+                <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+                <number>3</number>
+              </page>
+              <page>
+                <id type="integer">8</id>
+                <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+                <number>4</number>
+              </page>
+            </pages>
+          </chapter>
+        </chapters>
+      </book>
+      <book>
+        <id type="integer">6</id>
+        <name>Book 1</name>
+      </book>
+    </books>
+    </code>
+
+
+Microsoft Style
+    <dataroot xmlns:od="urn:schemas-microsoft-com:officedata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+              xsi:noNamespaceSchemaLocation="book.xsd" generated="2012-07-11T16:01:54">
+      <book>
+        <id >1</id>
+        <name>Book 1</name>
+        <book_price>
+          <id >1</id>
+          <sell>50.00</sell>
+          <educational>35.00</educational>
+          <cost>20.00</cost>
+        </book_price>
+        <chapter>
+          <id >1</id>
+          <title>Chapter 1</title>
+          <introduction>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</introduction>
+          <page>
+            <id >1</id>
+            <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+            <number>1</number>
+          </page>
+          <page>
+            <id >2</id>
+            <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+            <number>2</number>
+          </page>
+          <page>
+            <id >3</id>
+            <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+            <number>3</number>
+          </page>
+        </chapter>
+      </book>
+      <book>
+        <id >2</id>
+        <name>Book 12</name>
+        <chapter>
+          <id >4</id>
+          <title>Chapter 1</title>
+          <introduction>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</introduction>
+          <page>
+            <id >12</id>
+            <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+            <number>1</number>
+          </page>
+          <page>
+            <id >13</id>
+            <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+            <number>2</number>
+          </page>
+          <page>
+            <id >14</id>
+            <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+            <number>3</number>
+          </page>
+          <page>
+            <id >15</id>
+            <content>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus purus nulla, condimentum vitae hendrerit nec, blandit et felis. Suspendisse vulputate mollis suscipit. Vivamus non libero quis urna gravida euismod quis in nisi. Morbi turpis orci, posuere nec ultrices ut, egestas ac purus. Morbi id pretium erat. In ullamcorper, ligula id porta pellentesque, sem turpis ultricies libero, non elementum ipsum neque at dui. Donec auctor nulla id mi dapibus id faucibus felis mollis. Curabitur imperdiet tristique nisi, consectetur molestie purus accumsan id. Curabitur lacinia diam et nisl iaculis eleifend. Quisque turpis elit, volutpat eget dapibus sed, egestas nec leo. Mauris dignissim tellus non lorem fringilla pharetra.</content>
+            <number>4</number>
+          </page>
+        </chapter>
+      </book>
+    </dataroot>
+
+
+=== Database Schema
+
+Data Active will detect the primary key of the tables in your schema even if is a name other than <b>id</b>.  It will use the primary key to match records for update or deletion or creation when they don't exist.  Given this it's very important that the tables that you wish to synchronise have a primary key with auto increment.  The good news is by default Rails will create a primary key field called <b>id</b> that is auto-increment.  At this time Data Active doesn't support compound primary keys.
+
+=== The Model
+
+In order to identify the relationships Data Active it relies on associations so you have to make sure you define your associations in your model.  Following are is a sample model.
+
+book.rb
+    class Book < ActiveRecord::Base
+      has_many :chapters, :dependent => :destroy
+    end
+
+chapter.rb
+    class Chapter < ActiveRecord::Base
+      has_many :pages, :dependent => :destroy
+      belongs_to :book
+    end
+
+page.rb
+    class Page < ActiveRecord::Base
+      belongs_to :chapter
+    end
+
+At this stage Data Active has been tested with a limited number of associations.  It is hoped in the future that a more complete set of tests will exist.
+
+== Examples
+
+Now to the meaty part, the examples.  Data Active currenly uses "Nokogiri"(http://nokogiri.org/) to do its XML parsing so you can provide either a <b>Nokogiri::XML::Element</b> or raw XML.
+
+=== New Functions
+
+Data Active extends the ActiveRecord class giving you the following functions:
+
+many_from_xml(xml, options)
+Allows for the import of many records based on an XML document. This function expects an XML document similar to the following with many records in it:
+
+books_changed.xml
+    <books type="array">
+      <book>
+        <id type="Integer">4</id>
+        <name>Book 1</name>
+      </book>
+      <book>
+        <id type="integer">5</id>
+        <name>Book 1</name>
+      </book>
+      <book>
+        <id type="integer">6</id>
+        <name>Book 1</name>
+      </book>
+    </books>
+
+Following is an example:
+    Book.many_from_xml File.open("books_changed.xml").read, [:update]
+
+one_from_xml(xml, options)
+Allows for the import of one record based on an XML document. This function expects an XML document similar to the following with many records in it:
+
+one_book_changed.xml
+    <book>
+      <id type="Integer">4</id>
+      <name>Book 1</name>
+    </book>
+
+Following is an example:
+    Book.one_from_xml File.open("one_book_changed.xml").read, [:update]
+
+=== Options
+
+You can combine any of the options (:create, :update or :destroy) and Data Active will only perform the actions provided in the options.  However if you use the :sync option then all other options are ignored.  Following are the current options:
+
+* <b>:update</b> records in the database that match those in the provided XML document based on classes in the model, associations and the primary key.
+
+* <b>:create</b> records in the database that exist in the provided XML document but not in the database. Matching is based on classes in the model, associations and the primary key.
+
+* <b>:destroy</b> records in the database that don't exist in the provided XML document. Matching is based on classes in the model, associations and the primary key.  This respects validation by using the ActiveRecord destroy rather than delete.
+
+* <b>:sync</b> is really the combination of :create, :update and :destroy. Using this option will cause Data Active to ignore :create, :update and :destroy options and will proceed to make your database records match those in the XML document.
+
+=== One to One Associations
+Data Active supports has_one association with all options and following arr the behaviours of Data Active with each option:
+
+<b>:update</b>
+
+* <i>Record exists in XML but not in DB</i>: No Action
+* <i>Record exists in DB but not in XML</i>: No Action
+* <i>Record exists in XML and in DB</i>: DB record is updated if identifying features (eg id) match
+
+<b>:create</b>
+
+* <i>Record exists in XML but not in DB</i>: A new record in the DB is created
+* <i>Record exists in DB but not in XML</i>: No Action
+* <i>Record exists in XML and in DB</i>: No Action
+
+<b>:destroy</b>
+
+* <i>Record exists in XML but not in DB</i>: No Action
+* <i>Record exists in DB but not in XML</i>: The DB Record is Destroyed
+* <i>Record exists in XML and in DB</i>: DB record is destroyed if identifying features (eg id) don't match
+
+<b>:sync</b>
+
+* <i>Record exists in XML but not in DB</i>: A new record in the DB is created
+* <i>Record exists in DB but not in XML</i>: The DB Record is Destroyed
+* <i>Record exists in XML and in DB</i>: DB record is replaced if identifying features (eg id) don't match but if they do then the DB record is updated
+
+=== Versions
+
+* 0.0.1 First Release
+
+=== Future Features
+
+* <b>Dry Run</b> allow data_active to do a dry run and report potentail changes rather than making them
+* <b>Events</b> Event hooks in key locations
+* <b>Selective Upates</b> Specify a set of active record objects to effect and leave all the rest alone
+* <b>Many to Many</b> Tested support for has_and_belongs_to_many
+* <b>Polymorphic Associations</b> Tested support for these associations
+
+=== Testing
+In order to perform testing I created a number of test applications which can be found in the test_apps folder.  These
+applications target specific versions of rails utilising cucumber for testing
+
+At this stage data_active has been tested with Rails 3.1.x and 3.2.x

data/Rakefile

@@ -0,0 +1,2 @@
+require 'rubygems'
+require "bundler/gem_tasks"

data/data_active.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "data_active/version"
+
+Gem::Specification.new do |s|
+  s.name        = "data_active"
+  s.version     = DataActive::VERSION
+  s.authors     = ["Michael Harrison"]
+  s.email       = %w(michael@focalpause.com)
+  s.homepage    = "https://github.com/michael-harrison/data_active"
+  s.summary     = "data_active #{s.version}"
+  s.description = %q{Data Active is an extension of ActiveRecord that provides features to synchronise an ActiveRecord Model with a supplied XML document}
+
+  s.rubyforge_project = "data_active"
+
+  s.add_dependency 'nokogiri'
+  s.add_dependency 'rails'
+  s.add_development_dependency 'rake'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test_apps,test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = %w(lib)
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/features/remove_records_missing_in_xml.feature

@@ -0,0 +1,30 @@
+Feature: Remove records missing in XML
+  As a Developer
+  I need to update the my database with an XML document
+  So that records in my database that do not share the same identify features as those in the XML are removed from my database
+
+  Scenario: Attempt removing missing records when records exist in the database with some matching records in the XML Document
+    Given I have a fresh set of books
+    And I have the "features/support/fixtures/xml/books_changed.xml" file
+    When I synchronise with "features/support/fixtures/xml/books_changed.xml" to only remove mismatching records
+    Then the books in the database that don't exist in "features/support/fixtures/xml/books_changed.xml" will no longer exist in the database
+    And the chapters in the database that don't exist in "features/support/fixtures/xml/books_changed.xml" will no longer exist in the database
+    And the pages in the database that don't exist in "features/support/fixtures/xml/books_changed.xml" will no longer exist in the database
+
+  Scenario: Attempt removing missing records when no records exist in the database
+    Given I have no books
+    And I have the "features/support/fixtures/xml/books_changed.xml" file
+    When I synchronise with "features/support/fixtures/xml/books_changed.xml" to only remove mismatching records
+    Then will have no books
+    And will have no chapters
+    And will have no pages
+    And will have no book prices
+
+  Scenario: Attempt removing missing records when records exist but there are no matching records in the database
+    Given I have no matching books
+    And I have the "features/support/fixtures/xml/books_changed.xml" file
+    When I synchronise with "features/support/fixtures/xml/books_changed.xml" to only remove mismatching records
+    Then will have no books
+    And will have no chapters
+    And will have no pages
+    And will have no book prices

data/features/step_definitions/remove_records_missing_in_xml.rb

@@ -0,0 +1,85 @@
+require_relative "step_helper"
+
+When /^I synchronise with "([^"]*)" to only remove mismatching records$/ do |xml_document_file|
+  Book.many_from_xml(File.open(Rails.root.join(xml_document_file)).read, [:destroy]) != nil
+end
+
+Then /^the books in the database that don't exist in "([^"]*)" will no longer exist in the database$/ do |xml_document_file|
+  xml_document = Nokogiri::XML(File.open(Rails.root.join(xml_document_file)).read)
+  books_in_database = Book.all
+
+  books_in_database.each do |book|
+    xml_book = xml_document.xpath("//book[id[text()='#{book.id}']]")
+    if (xml_book.count == 0)
+      fail "Found book (id=#{book.id} in database that doesn't exist in the XML and should have been destroyed"
+    end
+  end
+
+end
+
+Then /^the book_prices in the database that don't exist in "([^"]*)" will no longer exist in the database$/ do |xml_document_file|
+  xml_document = Nokogiri::XML(File.open(Rails.root.join(xml_document_file)).read)
+  book_prices_in_database = BookPrice.all
+
+  book_prices_in_database.each do |book_price|
+    xml_book_price = xml_document.xpath("//book_price[id[text()='#{book_price.id}']]")
+    if (xml_book_price.count == 0)
+      fail "Found book_price (id=#{book_price.id} in database that doesn't exist in the XML and should have been destroyed"
+    end
+  end
+
+end
+
+When /^the chapters in the database that don't exist in "([^"]*)" will no longer exist in the database$/ do |xml_document_file|
+  xml_document = Nokogiri::XML(File.open(Rails.root.join(xml_document_file)).read)
+  chapters_in_database = Chapter.all
+
+  chapters_in_database.each do |chapter|
+    xml_chapter = xml_document.xpath("//chapter[id[text()='#{chapter.id}']]")
+    if (xml_chapter.count == 0)
+      fail "Found chapter (id=#{chapter.id} in database that doesn't exist in the XML and should have been destroyed"
+    end
+  end
+
+end
+
+When /^the pages in the database that don't exist in "([^"]*)" will no longer exist in the database$/ do |xml_document_file|
+  xml_document = Nokogiri::XML(File.open(Rails.root.join(xml_document_file)).read)
+  pages_in_database = Page.all
+
+  pages_in_database.each do |page|
+    xml_page = xml_document.xpath("//page[id[text()='#{page.id}']]")
+    if (xml_page.count == 0)
+      fail "Found page (id=#{page.id} in database that doesn't exist in the XML and should have been destroyed"
+    end
+  end
+
+end
+
+Then /^will have no books$/ do
+  books = Book.all
+  if books.count > 0
+    fail "Books exist in the database"
+  end
+end
+
+When /^will have no chapters$/ do
+  chapters = Chapter.all
+  if chapters.count > 0
+    fail "Chapters exist in the database"
+  end
+end
+
+When /^will have no pages$/ do
+  pages = Page.all
+  if pages.count > 0
+    fail "Pages exist in the database"
+  end
+end
+
+When /^will have no book prices$/ do
+  book_prices = BookPrice.all
+  if book_prices.count > 0
+    fail "Book Prices exist in the database"
+  end
+end