faster_xml_simple 0.5.0

data/COPYING

@@ -0,0 +1,18 @@
+Copyright (c) 2006 Michael Koziarski
+
+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

@@ -0,0 +1,8 @@
+FasterXmlSimple
+
+FasterXS is intended to be a drop in replacement for the xml input functionality
+from XmlSimple.  Instead of using rexml, it uses libxml and the associated ruby
+bindings.  This reduces CPU utilisation and memory consumption considerably.
+
+Preliminary benchmarks show it between 3 and 10 times as fast, and using a
+fraction of the ram.

data/Rakefile

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+require 'lib/faster_xml_simple'
+
+task :default => :test
+
+Rake::TestTask.new do |test|
+  test.pattern = 'test/*_test.rb'
+  test.verbose = true
+end
+
+
+Rake::RDocTask.new do |rdoc|  
+  rdoc.rdoc_dir = 'doc'  
+  rdoc.title    = "FasterXmlSimple, a libxml based replacement for XmlSimple"  
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('COPYING')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+namespace :dist do  
+
+  spec = Gem::Specification.new do |s|
+    s.name              = 'faster_xml_simple'
+    s.version           = Gem::Version.new(FasterXmlSimple::Version)
+    s.summary           = "A libxml based replacement for XmlSimple"
+    s.description       = s.summary
+    s.email             = 'michael@koziarski.com'
+    s.author            = 'Michael Koziarski'
+    s.has_rdoc          = true
+    s.extra_rdoc_files  = %w(README COPYING)
+    s.homepage          = 'http://fasterxs.rubyforge.org'
+    s.rubyforge_project = 'fasterxs'
+    s.files             = FileList['Rakefile', 'lib/**/*.rb']
+    s.test_files        = Dir['test/**/*']
+
+    s.add_dependency 'libxml-ruby', '>= 0.3.8.4'
+    s.rdoc_options  = ['--title', "",
+                       '--main',  'README',
+                       '--line-numbers', '--inline-source']
+  end
+  Rake::GemPackageTask.new(spec) do |pkg|
+    pkg.need_tar_gz = true
+    pkg.package_files.include('{lib,test}/**/*')
+    pkg.package_files.include('README')
+    pkg.package_files.include('COPYING')
+    pkg.package_files.include('Rakefile')
+  end
+end

data/lib/faster_xml_simple.rb

@@ -0,0 +1,187 @@
+# 
+# Copyright (c) 2006 Michael Koziarski
+# 
+# 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.
+
+require 'rubygems'
+require 'xml/libxml'
+
+class FasterXmlSimple
+  Version = '0.5.0'
+  class << self
+    # Take an string containing XML, and returns a hash representing that 
+    # XML document.  For example:
+    # 
+    #   FasterXmlSimple.xml_in("<root><something>1</something></root>")
+    #   {"root"=>{"something"=>{"__content__"=>"1"}}}
+    #
+    # Faster XML Simple is designed to be a drop in replacement for the xml_in
+    # functionality of http://xml-simple.rubyforge.org
+    #
+    # The following options are supported:
+    # 
+    # * <tt>contentkey</tt>: The key to use for the content of text elements,
+    #   defaults to '\_\_content__'
+    # * <tt>forcearray</tt>: The list of elements which should always be returned
+    #   as arrays.  Under normal circumstances single element arrays are inlined.
+    # * <tt>suppressempty</tt>: The value to return for empty elements, pass +true+
+    #   to remove empty elements entirely.
+    # * <tt>keeproot</tt>:  By default the hash returned has a single key with the
+    #   name of the root element.  If the name of the root element isn't 
+    #   interesting to you, pass +false+. 
+    # * <tt>forcecontent</tt>:  By default a text element with no attributes, will 
+    #   be collapsed to just a string instead of a hash with a single key.  
+    #   Pass +true+ to prevent this.
+    #
+    #
+    def xml_in(string, options={})
+      new(string, options).out
+    end
+  end
+  
+  def initialize(string, options) #:nodoc:
+    @doc     = parse(string)
+    @options = default_options.merge options
+  end
+  
+  def out #:nodoc:
+    if @options['keeproot']
+      {@doc.root.name => collapse(@doc.root)}
+    else
+      collapse(@doc.root)
+    end
+  end
+  
+  private
+    def default_options
+      {'contentkey' => '__content__', 'forcearray' => [], 'keeproot'=>true}
+    end
+  
+    def collapse(element)
+      result = hash_of_attributes(element) 
+      if text_node? element
+        text = collapse_text(element)
+        result[content_key] = text if text =~ /\S/
+      elsif element.children?
+        element.inject(result) do |hash, child|
+          unless child.text?
+            child_result = collapse(child) 
+            (hash[child.name] ||= []) << child_result
+          end
+          hash
+        end
+      end
+      if result.empty?
+        return empty_element
+      end
+      # Compact them to ensure it complies with the user's requests
+      inline_single_element_arrays(result) 
+      remove_empty_elements(result) if suppress_empty?
+      if content_only?(result) && !force_content?
+        result[content_key]
+      else
+        result
+      end
+    end
+    
+    def content_only?(result)
+      result.keys == [content_key]
+    end
+  
+    def content_key
+      @options['contentkey']
+    end
+  
+    def force_array?(key_name)
+      Array(@options['forcearray']).include?(key_name)
+    end
+  
+    def inline_single_element_arrays(result)
+      result.each do |key, value|
+        if value.size == 1 && value.is_a?(Array) && !force_array?(key)
+          result[key] = value.first
+        end
+      end    
+    end
+  
+    def remove_empty_elements(result)
+      result.each do |key, value|
+        if value == empty_element
+          result.delete key
+        end
+      end
+    end
+    
+    def suppress_empty?
+      @options['suppressempty'] == true
+    end
+     
+    def empty_element
+      if !@options.has_key? 'suppressempty'
+        {}
+      else
+        @options['suppressempty']
+      end
+    end
+
+    # removes the content if it's nothing but blanks,  prevents
+    # the hash being polluted with lots of content like "\n\t\t\t" 
+    def suppress_empty_content(result)
+      result.delete content_key if result[content_key] !~ /\S/ 
+    end
+  
+    def force_content?
+      @options['forcecontent']
+    end
+  
+    # a text node is one with 1 or more child nodes which are
+    # text nodes, and no non-text children, there's no sensible
+    # way to support nodes which are text and markup like:
+    # <p>Something <b>Bold</b> </p>
+    def text_node?(element)
+      !element.text? && element.all? {|c| c.text?}
+    end
+  
+    # takes a text node, and collapses it into a string
+    def collapse_text(element)
+      element.map {|c| c.content } * ''
+    end
+  
+    def hash_of_attributes(element)
+      result = {}
+      element.each_attr do |attribute| 
+        name = attribute.name
+        name = [attribute.ns, attribute.name].join(':') if attribute.ns?
+        result[name] = attribute.value 
+      end
+      result
+    end
+  
+    def parse(string)
+      if string == ''
+        string = ' '
+      end
+      XML::Parser.string(string).parse
+    end
+end
+
+class XmlSimple # :nodoc:
+  def self.xml_in(*args)
+    FasterXmlSimple.xml_in *args
+  end
+end

data/test/fixtures/test-1.rails.yml

@@ -0,0 +1,4 @@
+--- 
+something: 
+  something-else: 
+    __content__: testing

data/test/fixtures/test-1.xml

@@ -0,0 +1,3 @@
+<something>
+	<something-else>testing</something-else>
+</something>

data/test/fixtures/test-1.yml

@@ -0,0 +1,4 @@
+--- 
+something: 
+  something-else: 
+  - __content__: testing

data/test/fixtures/test-2.rails.yml

@@ -0,0 +1,6 @@
+--- 
+something: 
+  something-else: 
+    __content__: testing
+    child_attribute: "15"
+  root_attribute: "12"

data/test/fixtures/test-2.xml

@@ -0,0 +1,3 @@
+<something root_attribute="12">
+	<something-else child_attribute="15">testing</something-else>
+</something>

data/test/fixtures/test-2.yml

@@ -0,0 +1,6 @@
+--- 
+something: 
+  something-else: 
+  - __content__: testing
+    child_attribute: "15"
+  root_attribute: "12"

data/test/fixtures/test-3.rails.yml

@@ -0,0 +1,6 @@
+--- 
+something: 
+  something-else: 
+    __content__: "\n\
+      \t\ttesting\n\
+      \t"

data/test/fixtures/test-3.xml

@@ -0,0 +1,5 @@
+<something>
+	<something-else>
+		testing
+	</something-else>
+</something>

data/test/fixtures/test-3.yml

@@ -0,0 +1,6 @@
+--- 
+something: 
+  something-else: 
+  - __content__: "\n\
+      \t\ttesting\n\
+      \t"

data/test/fixtures/test-4.rails.yml

@@ -0,0 +1,5 @@
+--- 
+something: 
+  something-else: 
+    another_child: 
+      attribute: "4"

data/test/fixtures/test-4.xml

@@ -0,0 +1,7 @@
+<something>
+	<something-else>
+		testing
+		<another_child attribute='4' />
+		testing	
+	</something-else>
+</something>

data/test/fixtures/test-4.yml

@@ -0,0 +1,5 @@
+--- 
+something: 
+  something-else: 
+  - another_child: 
+      attribute: "4"

data/test/fixtures/test-5.rails.yml

@@ -0,0 +1,8 @@
+--- 
+something: 
+  something-else: 
+  - __content__: testing
+  - __content__: testing
+  - __content__: testing
+  - __content__: testing
+  - __content__: testing

data/test/fixtures/test-5.xml

@@ -0,0 +1,7 @@
+<something>
+	<something-else>testing</something-else>
+	<something-else>testing</something-else>
+	<something-else>testing</something-else>
+	<something-else>testing</something-else>
+	<something-else>testing</something-else>
+</something>

data/test/fixtures/test-5.yml

@@ -0,0 +1,8 @@
+--- 
+something: 
+  something-else: 
+  - __content__: testing
+  - __content__: testing
+  - __content__: testing
+  - __content__: testing
+  - __content__: testing

data/test/fixtures/test-6.rails.yml

@@ -0,0 +1,43 @@
+--- 
+ListBucketResult: 
+  Prefix: {}
+
+  Name: 
+    __content__: projectionist
+  MaxKeys: 
+    __content__: "1000"
+  Contents: 
+  - StorageClass: 
+      __content__: STANDARD
+    Owner: 
+      DisplayName: 
+        __content__: noradio
+      ID: 
+        __content__: bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1
+    Size: 
+      __content__: "186870"
+    ETag: 
+      __content__: "\"2ac1aa042e20ab7e1a9879b0df9f17b7\""
+    LastModified: 
+      __content__: "2006-11-15T05:49:39.000Z"
+    Key: 
+      __content__: 1973-plymouth-satellite-sebring.jpg
+  - StorageClass: 
+      __content__: STANDARD
+    Owner: 
+      DisplayName: 
+        __content__: noradio
+      ID: 
+        __content__: bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1
+    Size: 
+      __content__: "43562"
+    ETag: 
+      __content__: "\"4ead118ba91491f9c9697153264a1943\""
+    LastModified: 
+      __content__: "2006-11-15T05:51:20.000Z"
+    Key: 
+      __content__: 37-cluster.jpg
+  Marker: {}
+
+  IsTruncated: 
+    __content__: "false"

data/test/fixtures/test-6.xml

@@ -0,0 +1,29 @@
+<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
+  <Name>projectionist</Name>
+  <Prefix/>
+  <Marker/>
+  <MaxKeys>1000</MaxKeys>
+  <IsTruncated>false</IsTruncated>
+  <Contents>
+    <Key>1973-plymouth-satellite-sebring.jpg</Key>
+    <LastModified>2006-11-15T05:49:39.000Z</LastModified>
+    <ETag>"2ac1aa042e20ab7e1a9879b0df9f17b7"</ETag>
+    <Size>186870</Size>
+    <Owner>
+      <ID>bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1</ID>
+      <DisplayName>noradio</DisplayName>
+    </Owner>
+    <StorageClass>STANDARD</StorageClass>
+  </Contents>
+  <Contents>
+    <Key>37-cluster.jpg</Key>
+    <LastModified>2006-11-15T05:51:20.000Z</LastModified>
+    <ETag>"4ead118ba91491f9c9697153264a1943"</ETag>
+    <Size>43562</Size>
+    <Owner>
+      <ID>bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1</ID>
+      <DisplayName>noradio</DisplayName>
+    </Owner>
+    <StorageClass>STANDARD</StorageClass>
+  </Contents>
+</ListBucketResult>

data/test/fixtures/test-6.yml

@@ -0,0 +1,41 @@
+--- 
+ListBucketResult: 
+  Prefix: 
+  Name: 
+    __content__: projectionist
+  MaxKeys: 
+    __content__: "1000"
+  Contents: 
+  - StorageClass: 
+      __content__: STANDARD
+    Owner: 
+      DisplayName: 
+        __content__: noradio
+      ID: 
+        __content__: bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1
+    Size: 
+      __content__: "186870"
+    ETag: 
+      __content__: "\"2ac1aa042e20ab7e1a9879b0df9f17b7\""
+    LastModified: 
+      __content__: "2006-11-15T05:49:39.000Z"
+    Key: 
+      __content__: 1973-plymouth-satellite-sebring.jpg
+  - StorageClass: 
+      __content__: STANDARD
+    Owner: 
+      DisplayName: 
+        __content__: noradio
+      ID: 
+        __content__: bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1
+    Size: 
+      __content__: "43562"
+    ETag: 
+      __content__: "\"4ead118ba91491f9c9697153264a1943\""
+    LastModified: 
+      __content__: "2006-11-15T05:51:20.000Z"
+    Key: 
+      __content__: 37-cluster.jpg
+  Marker: 
+  IsTruncated: 
+    __content__: "false"

data/test/fixtures/test-7.rails.yml

@@ -0,0 +1,23 @@
+--- 
+AccessControlPolicy: 
+  AccessControlList: 
+    Grant: 
+    - Permission: 
+        __content__: FULL_CONTROL
+      Grantee: 
+        DisplayName: 
+          __content__: noradio
+        ID: 
+          __content__: bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1
+        xsi:type: CanonicalUser
+    - Permission: 
+        __content__: READ
+      Grantee: 
+        URI: 
+          __content__: http://acs.amazonaws.com/groups/global/AllUsers
+        xsi:type: Group
+  Owner: 
+    DisplayName: 
+      __content__: noradio
+    ID: 
+      __content__: bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1

data/test/fixtures/test-7.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
+  <Owner>
+    <ID>bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1</ID>
+    <DisplayName>noradio</DisplayName>
+  </Owner>
+  <AccessControlList>
+    <Grant>
+      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
+        <ID>bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1</ID>
+        <DisplayName>noradio</DisplayName>
+      </Grantee>
+      <Permission>FULL_CONTROL</Permission>
+    </Grant>
+    <Grant>
+      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
+        <URI>http://acs.amazonaws.com/groups/global/AllUsers</URI>
+      </Grantee>
+      <Permission>READ</Permission>
+    </Grant>
+  </AccessControlList>
+</AccessControlPolicy>

data/test/fixtures/test-7.yml

@@ -0,0 +1,22 @@
+AccessControlPolicy: 
+  Owner: 
+    DisplayName: 
+      __content__: noradio
+    ID: 
+      __content__: bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1
+  AccessControlList: 
+    Grant: 
+    - Permission: 
+        __content__: FULL_CONTROL
+      Grantee: 
+        DisplayName: 
+          __content__: noradio
+        ID: 
+          __content__: bb2041a25975c3d4ce9775fe9e93e5b77a6a9fad97dc7e00686191f3790b13f1
+        xsi:type: CanonicalUser
+    - Permission: 
+        __content__: READ
+      Grantee: 
+        URI: 
+          __content__: http://acs.amazonaws.com/groups/global/AllUsers
+        xsi:type: Group

data/test/fixtures/test-8.rails.yml

@@ -0,0 +1,14 @@
+--- 
+topic: 
+  parent-id: {}
+
+  title: {}
+
+  approved: 
+    type: boolean
+  id: 
+    type: integer
+  viewed-at: 
+    type: datetime
+  written-on: 
+    type: date

data/test/fixtures/test-8.xml

@@ -0,0 +1,8 @@
+<topic>
+	<title></title>
+	<id type="integer"></id>
+	<approved type="boolean"></approved>
+	<written-on type="date"></written-on>
+	<viewed-at type="datetime"></viewed-at>
+	<parent-id></parent-id>
+</topic>

data/test/fixtures/test-8.yml

@@ -0,0 +1,11 @@
+topic:
+    title: 
+    id:
+        type: integer
+    approved:
+        type: boolean
+    parent-id:
+    viewed-at:
+        type: datetime
+    written-on:
+        type: date

data/test/regression_test.rb

@@ -0,0 +1,47 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class RegressionTest < FasterXSTest
+  def test_content_nil_regressions
+    expected = {"asdf"=>{"jklsemicolon"=>{}}}
+    assert_equal expected, FasterXmlSimple.xml_in("<asdf><jklsemicolon /></asdf>")
+    assert_equal expected, FasterXmlSimple.xml_in("<asdf><jklsemicolon /></asdf>", 'forcearray'=>['asdf'])
+  end
+  
+  def test_s3_regression
+    str = File.read("test/fixtures/test-7.xml")
+    assert_nil FasterXmlSimple.xml_in(str)["AccessControlPolicy"]["AccessControlList"]["__content__"]
+  end
+  
+  def test_xml_simple_transparency
+    assert_equal XmlSimple.xml_in("<asdf />"), FasterXmlSimple.xml_in("<asdf />")
+  end
+  
+  def test_suppress_empty_variations
+    str = "<asdf><fdsa /></asdf>"
+    
+    assert_equal Hash.new, FasterXmlSimple.xml_in(str)["asdf"]["fdsa"]
+    assert_nil FasterXmlSimple.xml_in(str, 'suppressempty'=>nil)["asdf"]["fdsa"]
+    assert_equal '', FasterXmlSimple.xml_in(str, 'suppressempty'=>'')["asdf"]["fdsa"]
+    assert !FasterXmlSimple.xml_in(str, 'suppressempty'=>true)["asdf"].has_key?("fdsa")
+  end
+
+  def test_empty_string_doesnt_crash
+    assert_raise(XML::Parser::ParseError) do
+      silence_stderr do 
+        FasterXmlSimple.xml_in('')
+      end
+    end
+  end
+  
+  def test_keeproot_false
+    str = "<asdf><fdsa>1</fdsa></asdf>"
+    expected = {"fdsa"=>"1"}
+    assert_equal expected, FasterXmlSimple.xml_in(str, 'keeproot'=>false)
+  end
+  
+  def test_keeproot_false_with_force_content
+    str = "<asdf><fdsa>1</fdsa></asdf>"
+    expected = {"fdsa"=>{"__content__"=>"1"}}
+    assert_equal expected, FasterXmlSimple.xml_in(str, 'keeproot'=>false, 'forcecontent'=>true)
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,17 @@
+
+require 'test/unit'
+require 'faster_xml_simple'
+
+class FasterXSTest < Test::Unit::TestCase
+  def default_test
+  end
+  
+  def silence_stderr
+    str = STDERR.dup
+    STDERR.reopen("/dev/null")
+    STDERR.sync=true
+    yield
+  ensure
+    STDERR.reopen(str)
+  end
+end

data/test/xml_simple_comparison_test.rb

@@ -0,0 +1,46 @@
+require File.dirname(__FILE__) + '/test_helper'
+require 'yaml'
+
+class XmlSimpleComparisonTest < FasterXSTest
+  
+  # Define test methods
+  
+  Dir["test/fixtures/test-*.xml"].each do |file_name|
+    xml_file_name = file_name
+    method_name = File.basename(file_name, ".xml").gsub('-', '_')
+    yml_file_name = file_name.gsub('xml', 'yml')
+    rails_yml_file_name = file_name.gsub('xml', 'rails.yml')
+    class_eval <<-EOV, __FILE__, __LINE__
+      def #{method_name}
+        assert_equal YAML.load(File.read('#{yml_file_name}')), 
+              FasterXmlSimple.xml_in(File.read('#{xml_file_name}'), default_options )
+      end
+      
+      def #{method_name}_rails
+        assert_equal YAML.load(File.read('#{rails_yml_file_name}')), 
+              FasterXmlSimple.xml_in(File.read('#{xml_file_name}'), rails_options)
+      end
+    EOV
+  end
+  
+  def default_options
+    {
+       'keeproot'      => true, 
+       'contentkey'    => '__content__', 
+       'forcecontent'  => true, 
+       'suppressempty' => nil,
+       'forcearray'    => ['something-else']
+    }
+  end
+  
+  def rails_options
+    {
+      'forcearray'   => false,
+      'forcecontent' => true,
+      'keeproot'     => true,
+      'contentkey'   => '__content__'
+    }
+  end
+  
+
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: faster_xml_simple
+version: !ruby/object:Gem::Version 
+  version: 0.5.0
+date: 2006-12-24 00:00:00 +13:00
+summary: A libxml based replacement for XmlSimple
+require_paths: 
+- lib
+email: michael@koziarski.com
+homepage: http://fasterxs.rubyforge.org
+rubyforge_project: fasterxs
+description: A libxml based replacement for XmlSimple
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Michael Koziarski
+files: 
+- Rakefile
+- lib/faster_xml_simple.rb
+- README
+- COPYING
+test_files: 
+- test/fixtures
+- test/regression_test.rb
+- test/test_helper.rb
+- test/xml_simple_comparison_test.rb
+- test/fixtures/test-1.rails.yml
+- test/fixtures/test-1.xml
+- test/fixtures/test-1.yml
+- test/fixtures/test-2.rails.yml
+- test/fixtures/test-2.xml
+- test/fixtures/test-2.yml
+- test/fixtures/test-3.rails.yml
+- test/fixtures/test-3.xml
+- test/fixtures/test-3.yml
+- test/fixtures/test-4.rails.yml
+- test/fixtures/test-4.xml
+- test/fixtures/test-4.yml
+- test/fixtures/test-5.rails.yml
+- test/fixtures/test-5.xml
+- test/fixtures/test-5.yml
+- test/fixtures/test-6.rails.yml
+- test/fixtures/test-6.xml
+- test/fixtures/test-6.yml
+- test/fixtures/test-7.rails.yml
+- test/fixtures/test-7.xml
+- test/fixtures/test-7.yml
+- test/fixtures/test-8.rails.yml
+- test/fixtures/test-8.xml
+- test/fixtures/test-8.yml
+rdoc_options: 
+- --title
+- ""
+- --main
+- README
+- --line-numbers
+- --inline-source
+extra_rdoc_files: 
+- README
+- COPYING
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: libxml-ruby
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.3.8.4
+    version: