lazy_xml_model 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4c3b4b9ff0fe8d3ba0aba451e4bbb6fe74449fd6
+  data.tar.gz: 1a3b4fe280483a8d344330a925c8298dd633cdc4
+SHA512:
+  metadata.gz: dc703645c5bcaee13a21d1f928e276bbdffbcb44ca47bcec0b602dc427cc3186412b8d53bb9ab3d34b853d4ab7ad74921e40b3b75c16b55ad6eb916c6fa85070
+  data.tar.gz: ee946a3f8875ac1c0d3ce0fa9c5aebc8c9b45b9de1ad7719b8228649474b6404d3147bf86baa33272acd0803e69e427fc74bb6f861ad5007499a9d65ca9e81eb

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+2.4.0

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.4.2
+before_install: gem install bundler -v 1.16.0

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in lazy_xml_model.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,74 @@
+PATH
+  remote: .
+  specs:
+    lazy_xml_model (0.1.0)
+      activemodel
+      activesupport
+      nokogiri
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (5.1.4)
+      activesupport (= 5.1.4)
+    activesupport (5.1.4)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (~> 0.7)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    codecov (0.1.10)
+      json
+      simplecov
+      url
+    coderay (1.1.2)
+    concurrent-ruby (1.0.5)
+    diff-lcs (1.3)
+    docile (1.1.5)
+    i18n (0.9.1)
+      concurrent-ruby (~> 1.0)
+    json (2.1.0)
+    method_source (0.9.0)
+    mini_portile2 (2.3.0)
+    minitest (5.10.3)
+    nokogiri (1.8.1)
+      mini_portile2 (~> 2.3.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rake (10.5.0)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.0)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.0)
+    simplecov (0.15.1)
+      docile (~> 1.1.0)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    thread_safe (0.3.6)
+    tzinfo (1.2.4)
+      thread_safe (~> 0.1)
+    url (0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  codecov
+  lazy_xml_model!
+  pry
+  rake (~> 10.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   1.16.0

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Evan Rolfe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,219 @@
+# LazyXmlModel
+Lets you modify xml files using ruby models with an interface similar to ActiveRecord models. It also lazily evaluates the xml file so you do not have to specify a model which covers the entire xml file. This is useful if you only want to modify certain parts of an xml file but do not care about the other contents.
+
+## Installation
+Add this to your Gemfile:
+```ruby
+gem 'lazy_xml_model', git: 'https://github.com/evanrolfe/lazy_xml_model'
+```
+## Usage
+Example XML file `company.xml`:
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<company name="SUSE">
+  <description type="about">
+    <headquarters>Nuremberg</headquarters>
+    <website>http://www.suse.com</website>
+  </description>
+  <trading>yes</trading>
+  <employee name="Tanya Erickson">
+    <jobtitle>Chief Marketing Synergist</jobtitle>
+  </employee>
+  <employee name="Rolando Garcia">
+    <jobtitle>Human Integration Coordinator</jobtitle>
+  </employee>
+  <employee name="Xavier Bringham">
+    <jobtitle>Regional Markets Executive</jobtitle>
+  </employee>
+</company>
+```
+Ruby models:
+```ruby
+class Company
+  include LazyXmlModel
+
+  attribute_node :name
+  element_node :trading
+
+  has_one :description, class_name: 'Description'
+  has_many :employees, class_name: 'Employee'
+end
+
+class Description
+  include LazyXmlModel
+
+  element_node :headquarters
+  element_node :website
+end
+
+class Employee
+  include LazyXmlModel
+
+  attribute_node :name
+  element_node :jobtitle
+end
+```
+**Parsing the xml:**
+```ruby
+xml_str = File.read('company.xml')
+company = Company.parse(xml_str)
+```
+
+**Accessing elements & attributes:**
+```ruby
+company.name
+# => 'SUSE'
+company.trading
+# => 'yes'
+company.name = 'openSuse'
+company.trading = 'no'
+```
+**has_one associations:**
+```ruby
+company.description.headquarters
+# => 'Nuremberg'
+company.description.destroy # Removes the <description> tag from the xml
+company.description
+# => nil
+company.build_description # Adds a new Description object and <description/> tag
+company.description.headquarters = 'Prague' # Sets the value on the new description
+```
+**has_many associations:**
+```ruby
+company.employees[0].name
+# => 'Tanya Erickson'
+company.employees[0].jobtitle
+# => 'Chief Marketing Synergist'
+company.employees[0].delete # Deletes the employee
+company.employees.build # Adds a new blank employee to the collection
+company.employees.delete_all
+```
+**Add a new item to has_many association:**
+```ruby
+new_employee = Employee.new
+new_employee.name = 'Evan Rolfe'
+new_employee.jobtitle = 'Junior Xml Parser'
+company.employees << new_employee
+```
+**Outputting the xml:**
+```ruby
+company.to_xml
+```
+
+**Validating the XML input**
+```ruby
+company = Company.parse('<company name="an invalid company!">')
+company.xml_document.errors
+# => => [#<Nokogiri::XML::SyntaxError: 1:37: FATAL: Premature end of data in tag company line 1>]
+```
+
+## Integrating with ActiveModel
+
+LazyXmlModel plays nicely with ActiveModel so you can have nice things like mass assignment and validations on your xml models.
+```ruby
+class Company
+  include LazyXmlModel
+  include ActiveModel::Model
+  include ActiveModel::Validations
+
+  attribute_node :name
+  element_node :trading
+
+  has_one :description, class_name: 'Description'
+  has_many :employees, class_name: 'Employee'
+
+  validates :name, presence: true
+  validates :trading, inclusion: { in: %w(yes no) }
+end
+```
+
+**Validating the object:**
+```ruby
+company = Company.new(name: 'My Company', trading: 'i dont know')
+company.valid?
+# => false
+company.errors.messages
+# => {:trading=>["is not included in the list"]}
+```
+
+**Validating the xml content:**
+Example XML file `company.xml`:
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<company>
+  <trading>yes</trading>
+</company>
+```
+```ruby
+xml_str = File.read('company.xml')
+company = Company.parse(xml_str)
+company.valid?
+# => false
+company.errors.messages
+# => {:name=>["can't be blank"]}
+```
+## Integrating with rails nested forms
+If you include ActiveModel on your models then LazyXmlMapping gives you an `_attributes=` method on your has_one and has_many associations which means the models can be used with `fields_for` in the same way that an ActiveRecord model which calls `accepts_nested_attributes_for` works.
+
+```html
+<%= form_for(company) do |f| %>
+  <div class="form-group">
+    <%= f.label :name %>
+    <%= f.text_field :name %>
+  </div>
+
+  <div class="form-group">
+    <%= f.label :trading %>
+    <%= f.text_field :trading %>
+  </div>
+
+  <%= f.fields_for :description do |description_fields| %>
+    <div class="form-group">
+      <%= description_fields.label :headquarters %>
+      <%= description_fields.text_field :headquarters %>
+    </div>
+
+    <div class="form-group">
+      <%= description_fields.label :website %>
+      <%= description_fields.text_field :website %>
+    </div>
+  <% end %>
+
+  <%= f.fields_for :employees, f.object.employees.to_a do |employees_fields| %>
+    <hr/>
+    <div class="row">
+      <b>Employee:</b>
+    </div>
+
+    <div class="form-group">
+      <%= employees_fields.label :name %>
+      <%= employees_fields.text_field :name %>
+    </div>
+
+    <div class="form-group">
+      <%= employees_fields.label :jobtitle %>
+      <%= employees_fields.text_field :jobtitle %>
+    </div>
+
+    <div class="form-group">
+      <label class="form-check-label">
+        <%= employees_fields.check_box :_destroy %>
+        Delete?
+      </label>
+    </div>
+  <% end %>
+
+  <%= f.submit 'Save' %>
+<% end %>
+
+```
+
+## TODO
+
+* Validate associated objects as well as the root object
+* Handle a collection of elements like:
+```xml
+<element>value1</element>
+<element>value2</element>
+<element>value3</element>
+```

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "lazy_xml_model"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lazy_xml_model.gemspec

@@ -0,0 +1,32 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "lazy_xml_model/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "lazy_xml_model"
+  spec.version       = LazyXmlModel::VERSION
+  spec.authors       = ["Evan Rolfe"]
+  spec.email         = ["esrolfe@suse.de"]
+
+  spec.summary       = %q{Allows you to create ActiveRecord-like models for editing XML files.}
+  spec.homepage      = "https://github.com/evanrolfe/lazy_xml_model"
+  spec.license       = "MIT"
+  spec.metadata      = { "source_code_uri" => "https://github.com/evanrolfe/lazy_xml_model" }
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'activesupport'
+  spec.add_dependency 'activemodel'
+  spec.add_dependency 'nokogiri'
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "codecov"
+end

data/lib/lazy_xml_model.rb

@@ -0,0 +1,66 @@
+require 'active_model'
+require 'active_support'
+require 'active_support/core_ext/hash/indifferent_access'
+require 'active_support/inflector'
+require 'forwardable'
+require 'nokogiri'
+
+require 'lazy_xml_model/version'
+require 'lazy_xml_model/attribute_node'
+require 'lazy_xml_model/element_node'
+require 'lazy_xml_model/has_one_association'
+require 'lazy_xml_model/has_many_association'
+
+module LazyXmlModel
+  extend ActiveSupport::Concern
+
+  included do
+    include AttributeNode
+    include HasManyAssociation
+    include HasOneAssociation
+    include ElementNode
+
+    attr_writer :xml_document, :xml_parent_element, :xml_element
+    class_attribute :tag
+
+    #
+    # Class Methods
+    #
+    def self.parse(xml_string)
+      object = self.new
+      object.xml_document = Nokogiri::XML::Document.parse(xml_string, &:noblanks)
+      object
+    end
+  end
+
+  #
+  # Instance Methods
+  #
+  def xml_document
+    @xml_document ||= Nokogiri::XML::Document.parse("<#{root_tag}/>", &:noblanks)
+  end
+
+  def xml_parent_element
+    @xml_parent_element
+  end
+
+  def xml_element
+    @xml_element ||= xml_document.root
+  end
+
+  def to_xml
+    # TODO: Make this work for non-root objects
+    xml_document.to_xml(indent: 2, encoding: 'UTF-8')
+  end
+
+  def delete
+    xml_element.remove
+  end
+
+  private
+
+  def root_tag
+    self.tag || self.class.name.demodulize.downcase
+  end
+end
+

data/lib/lazy_xml_model/attribute_node.rb

@@ -0,0 +1,22 @@
+module LazyXmlModel
+  module AttributeNode
+    extend ActiveSupport::Concern
+
+    included do
+      def self.attribute_node(name)
+        # Getter Method
+        define_method(name) do
+          attribute = xml_element.attributes[name.to_s]
+          return if attribute.nil?
+
+          xml_element.attributes[name.to_s].value
+        end
+
+        # Setter Method
+        define_method("#{name}=") do |value|
+          xml_element.set_attribute(name.to_s, value)
+        end
+      end
+    end
+  end
+end

data/lib/lazy_xml_model/collection_proxy.rb

@@ -0,0 +1,137 @@
+module LazyXmlModel
+  class CollectionProxy
+    include Enumerable
+    extend Forwardable
+
+    attr_reader :association_name, :xml_parent_element, :options
+
+    def_delegators :collection, :each, :[], :size, :length, :empty?
+
+    def initialize(association_name, xml_parent_element, options = {})
+      @association_name = association_name
+      @xml_parent_element = xml_parent_element
+      @options = options
+    end
+
+    def <<(item)
+      item.xml_document = nil
+      item.xml_parent_element = xml_parent_element
+
+      if collection.any?
+        collection.last.xml_element.add_next_sibling(item.xml_element)
+      else
+        xml_parent_element.add_child(item.xml_element)
+      end
+
+      @collection << item
+    end
+    alias_method :push, :<<
+
+    def []=(index, new_item)
+      original_item = self[index]
+
+      new_item.xml_document = nil
+      new_item.xml_parent_element = xml_parent_element
+
+      # 1. Replace the xml with new_item.to_xml
+      original_item.xml_element.replace(new_item.xml_element)
+
+      # 2. Replace the original object with the new object
+      @collection[index] = new_item
+    end
+
+    # TODO:
+    def concat(item)
+      raise NotImplementedError
+    end
+
+    def delete(item)
+      # Delete the object thats wrapping this xml element
+      @collection.delete(item)
+
+      # Delete from the xml document
+      item.xml_element.remove
+    end
+
+    def delete_all
+      @collection = []
+      xml_elements.each(&:remove)
+    end
+    alias_method :clear, :delete_all
+
+    def build(params = {})
+      new_object =
+        begin
+          klass.new(params)
+        # Incase the class does not include ActiveModel::AttributeAssignment
+        rescue ArgumentError
+          klass.new
+        end
+
+      self << new_object
+    end
+
+    def attributes=(attributes)
+      indexes_to_delete = []
+
+      # 1. Update the existing items and create new ones
+      attributes.each do |i, object_params|
+        i = i.to_i
+        object_params = object_params.with_indifferent_access
+
+        if self[i].present?
+          self[i].assign_attributes(object_params.except(:_destroy)) # Update the object
+        else
+          build(object_params.except(:_destroy)) # Build the object
+        end
+
+        # Keep track of which items will be deleted
+        indexes_to_delete << i if [true, 1, '1'].include?(object_params[:_destroy])
+      end
+
+      # 2. Delete any items marked for deletion, must come after the first step and
+      #    must be in reverse order
+      indexes_to_delete.sort.reverse.each do |i|
+        delete(self[i])
+      end
+    end
+
+    private
+
+    def xml_elements
+      xml_parent_element.elements.select { |element| element.name == element_name }
+    end
+
+    def collection
+      @collection ||= []
+
+      xml_elements.map do |element|
+        item_from_collection = @collection.find { |item| item.xml_element == element }
+
+        if item_from_collection.present?
+          item_from_collection
+        else
+          item = build_item_for_element(element)
+          @collection << item
+          item
+        end
+      end
+    end
+
+    def build_item_for_element(element)
+      new_item = klass.new
+      new_item.xml_parent_element = xml_parent_element
+      new_item.xml_element = element
+      new_item
+    end
+
+    def element_name
+      klass.tag || association_name
+    end
+
+    def klass
+      return ArgumentError, 'You must specify :class_name!' if options[:class_name].nil?
+      options[:class_name].constantize
+    end
+  end
+end

data/lib/lazy_xml_model/element_node.rb

@@ -0,0 +1,33 @@
+require_relative 'element_proxy'
+
+module LazyXmlModel
+  module ElementNode
+    extend ActiveSupport::Concern
+
+    included do
+      def self.element_node(element_tag)
+        # Proxy Accessor Method
+        define_method("#{element_tag}_proxy".to_sym) do
+          element_proxy = instance_variable_get("@#{element_tag}_proxy")
+          return element_proxy if element_proxy.present?
+
+          element_proxy = LazyXmlModel::ElementProxy.new(element_tag, xml_document, xml_element)
+          instance_variable_set("@#{element_tag}_proxy", element_proxy)
+          element_proxy
+        end
+
+        # Getter Method
+        define_method(element_tag) do
+          element_proxy = send("#{element_tag}_proxy".to_sym)
+          element_proxy.value
+        end
+
+        # Setter Method
+        define_method("#{element_tag}=") do |value|
+          element_proxy = send("#{element_tag}_proxy".to_sym)
+          element_proxy.value = value
+        end
+      end
+    end
+  end
+end

data/lib/lazy_xml_model/element_proxy.rb

@@ -0,0 +1,35 @@
+module LazyXmlModel
+  class ElementProxy
+    attr_reader :element_tag, :xml_document, :xml_parent_element
+
+    def initialize(element_tag, xml_document, xml_parent_element)
+      @element_tag = element_tag
+      @xml_document = xml_document
+      @xml_parent_element = xml_parent_element
+    end
+
+    # Getter Method
+    def value
+      if xml_element.present?
+        xml_element.children.first.content
+      end
+    end
+
+    # Setter Method
+    def value=(value)
+      if xml_element.present?
+        xml_element.children.first.content = value
+      else
+        xml_element = Nokogiri::XML::Element.new(element_tag.to_s, xml_document)
+        xml_element.content = value
+        xml_parent_element.add_child(xml_element)
+      end
+    end
+
+    private
+
+    def xml_element
+      xml_parent_element.elements.find { |element| element.name == element_tag.to_s }
+    end
+  end
+end

data/lib/lazy_xml_model/has_many_association.rb

@@ -0,0 +1,32 @@
+require_relative 'collection_proxy'
+
+module LazyXmlModel
+  module HasManyAssociation
+    extend ActiveSupport::Concern
+
+    included do
+      def self.has_many(association_name, options = {})
+        # Accessor Method
+        define_method(association_name) do
+          collection_proxy = instance_variable_get("@#{association_name}")
+          return collection_proxy if collection_proxy.present?
+
+          collection_proxy = LazyXmlModel::CollectionProxy.new(
+            association_name.to_s.singularize.gsub('_',''),
+            xml_element,
+            options
+          )
+          instance_variable_set("@#{association_name}", collection_proxy)
+          collection_proxy
+        end
+
+        # _attributes= Builder Method
+        # NOTE: This method requires that your object follows the API defined in ActiveModel::AttributeAssignment
+        define_method("#{association_name}_attributes=") do |attributes|
+          collection_proxy = send(association_name)
+          collection_proxy.attributes = attributes
+        end
+      end
+    end
+  end
+end

data/lib/lazy_xml_model/has_one_association.rb

@@ -0,0 +1,48 @@
+require_relative 'object_proxy'
+
+module LazyXmlModel
+  module HasOneAssociation
+    extend ActiveSupport::Concern
+
+    included do
+      def self.has_one(association_name, options)
+        association_name = association_name.to_s
+
+        # Proxy Accessor Method
+        define_method("#{association_name}_proxy".to_sym) do
+          object_proxy = instance_variable_get("@#{association_name}_proxy")
+          return object_proxy if object_proxy.present?
+
+          object_proxy = LazyXmlModel::ObjectProxy.new(association_name, xml_document, xml_element, options)
+          instance_variable_set("@#{association_name}_proxy", object_proxy)
+          object_proxy
+        end
+
+        # Getter Method
+        define_method(association_name) do
+          object_proxy = send("#{association_name}_proxy".to_sym)
+          object_proxy.object
+        end
+
+        # Setter Method
+        define_method("#{association_name}=".to_sym) do |object|
+          object_proxy = send("#{association_name}_proxy".to_sym)
+          object_proxy.object = object
+        end
+
+        # Builder Method
+        define_method("build_#{association_name}") do |params = {}|
+          object_proxy = send("#{association_name}_proxy".to_sym)
+          object_proxy.build_object(params)
+        end
+
+        # _attributes= Builder Method
+        # NOTE: This method requires that your object follows the API defined in ActiveModel::AttributeAssignment
+        define_method("#{association_name}_attributes=") do |attributes|
+          object_proxy = send("#{association_name}_proxy".to_sym)
+          object_proxy.attributes = attributes
+        end
+      end
+    end
+  end
+end

data/lib/lazy_xml_model/object_proxy.rb

@@ -0,0 +1,64 @@
+module LazyXmlModel
+  class ObjectProxy
+    attr_reader :association_name, :xml_document, :xml_parent_element, :options
+
+    def initialize(association_name, xml_document, xml_parent_element, options = {})
+      @association_name = association_name
+      @xml_document = xml_document
+      @xml_parent_element = xml_parent_element
+      @options = options
+    end
+
+    # Getter Method
+    def object
+      element = xml_parent_element.elements.find { |element| element.name == association_name }
+      return unless element.present?
+
+      @object ||= begin
+        new_object = klass.new
+        new_object.xml_parent_element = xml_parent_element
+        new_object.xml_element = element
+        new_object
+      end
+    end
+
+    # Setter Method
+    def object=(new_object)
+      @object.delete if @object.present?
+
+      @object = new_object
+
+      xml_parent_element.add_child(
+        new_object.xml_element
+      )
+      new_object.xml_parent_element = xml_parent_element
+    end
+
+    # Builder Method
+    def build_object(params = {})
+      new_object =
+        begin
+          klass.new(params)
+        # Incase the class does not include ActiveModel::AttributeAssignment
+        rescue ArgumentError
+          klass.new
+        end
+
+      self.object = new_object
+    end
+
+    def attributes=(attributes)
+      if object.present?
+        object.assign_attributes(attributes) # Update the object
+      else
+        build_object(attributes) # Build the object
+      end
+    end
+
+    private
+
+    def klass
+      options[:class_name].constantize
+    end
+  end
+end

data/lib/lazy_xml_model/version.rb

@@ -0,0 +1,3 @@
+module LazyXmlModel
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,178 @@
+--- !ruby/object:Gem::Specification
+name: lazy_xml_model
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Evan Rolfe
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-11-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: codecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- esrolfe@suse.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lazy_xml_model.gemspec
+- lib/lazy_xml_model.rb
+- lib/lazy_xml_model/attribute_node.rb
+- lib/lazy_xml_model/collection_proxy.rb
+- lib/lazy_xml_model/element_node.rb
+- lib/lazy_xml_model/element_proxy.rb
+- lib/lazy_xml_model/has_many_association.rb
+- lib/lazy_xml_model/has_one_association.rb
+- lib/lazy_xml_model/object_proxy.rb
+- lib/lazy_xml_model/version.rb
+homepage: https://github.com/evanrolfe/lazy_xml_model
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/evanrolfe/lazy_xml_model
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: Allows you to create ActiveRecord-like models for editing XML files.
+test_files: []