sergio 0.0.1

data/Gemfile

@@ -0,0 +1,5 @@
+source 'http://rubygems.org'
+
+gem 'rake'
+gem 'rspec'
+gem 'nokogiri'

data/Gemfile.lock

@@ -0,0 +1,24 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    nokogiri (1.4.4)
+    rake (0.9.0)
+    rcov (0.9.9)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.3)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  nokogiri
+  rake
+  rcov
+  rspec

data/Rakefile

@@ -0,0 +1,12 @@
+# Get your spec rake tasks working in RSpec 2.0
+
+require 'rspec/core/rake_task'
+
+desc 'Default: run specs.'
+task :default => :spec
+
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "./spec/**/*_spec.rb" # don't need this, it's default.
+  # Put spec opts in a file named .rspec in root
+end

data/lib/sergio.rb

@@ -0,0 +1,32 @@
+require 'nokogiri'
+require File.dirname(__FILE__) + '/sergio/hash_methods'
+require File.dirname(__FILE__) + '/sergio/sergio_sax'
+require File.dirname(__FILE__) + '/sergio/sergio_element'
+require File.dirname(__FILE__) + '/sergio/sergio_config'
+require File.dirname(__FILE__) + '/sergio/sergio_parsed_document'
+
+module Sergio
+  def self.included(base)
+    base.extend(ClassMethods)
+    include(Sergio::HashMethods)
+  end
+
+  def sergio_parsed_document
+    @sergio_parsed_document ||= Sergio::ParsedDocument.new
+  end
+
+  def parse(doc)
+    Nokogiri::XML::SAX::Parser.new(SergioSax.new(self)).parse(doc)
+    sergio_parsed_document.parsed_hash
+  end
+
+  module ClassMethods
+    def element(name, newname = nil, args = {}, &blk)
+      sergio_config.element(name, newname, args, &blk)
+    end
+
+    def sergio_config
+      @sergio_config ||= Sergio::Config.new
+    end
+  end
+end

data/lib/sergio/hash_methods.rb

@@ -0,0 +1,58 @@
+module Sergio
+  module HashMethods
+    def hash_from_path(path, val)
+      path = path.clone
+      k = path.shift
+      h = {}
+      h[k] = if path.empty?
+        val
+      else
+        hash_from_path(path, val)
+      end
+      h
+    end
+
+    def value_at_path(path, hash)
+      k = path.shift
+      k = k.is_a?(Array) ? k[0] : k
+      v = hash[k]
+      if v
+        if v.is_a?(Hash) && path.length > 0
+          value_at_path(path, v)
+        else
+          v
+        end
+      else
+        nil
+      end
+    end
+
+    def hash_recursive_merge_to_arrays(lval, rval)
+      r = {}
+      v = lval.merge(rval) do |key, oldval, newval| 
+        v = if oldval.class == lval.class
+          hash_recursive_merge_to_arrays(oldval, newval) 
+        else
+          if oldval.is_a?(Array)
+            oldval << newval
+          elsif newval.is_a?(Array)
+            newval << oldval
+          else
+            [oldval] << newval
+          end
+        end
+        r[key] = v
+      end
+      v
+    end
+
+    #FROM https://gist.github.com/6391/62b6aae9206abe7b3fea6d4659e4c246f8cf7632
+    def hash_recursive_merge(lval, rval)
+      r = {}
+      v = lval.merge(rval) do |key, oldval, newval| 
+        r[key] = oldval.class == Hash && newval.class == Hash ? hash_recursive_merge(oldval, newval) : newval
+      end
+      v
+    end
+  end
+end

data/lib/sergio/sergio_config.rb

@@ -0,0 +1,81 @@
+module Sergio
+  class Config
+    include HashMethods
+    attr_accessor :sergio_elements, :new_path, :current_path
+    def initialize
+      @parsing_elements = {}
+      @new_path, @current_path = [], []
+    end
+
+    def element(name, newname = nil, args = {}, &blk)
+      if newname.is_a?(Hash)
+        args = newname
+        newname = nil
+      end
+
+      args = args.inject({}) do |args, k_v|
+        args[k_v[0].to_sym] = k_v[1]
+        args
+      end
+
+      args[:attribute] ||= '@text'
+      args[:having] ||= false
+      newname = name unless newname
+      name = [name] unless name.is_a?(Array)
+      newname = [newname] unless newname.is_a?(Array)
+
+      name.each do |n|
+        @current_path << n
+      end
+
+      newname.each do |n|
+        @new_path << n
+      end
+
+      unless block_given?
+        blk = lambda do |val|
+          val
+        end
+      end
+
+      #block with more calls to #element
+      if blk.arity < 1
+        blk.call
+        callback = lambda {|v|{}}
+      else
+        callback = blk
+      end
+
+      elem = SergioElement.new(new_path, args, callback)
+
+      @parsing_elements = hash_recursive_merge_to_arrays(@parsing_elements, hash_from_path(current_path, {:sergio_elem => elem}))
+      current_path.pop(name.length)
+      new_path.pop(newname.length)
+    end
+
+    def get_element_configs(path)
+      path = path.clone
+      current_elem = path.last
+      v = value_at_path(path, @parsing_elements)
+      if v
+        v = v[:sergio_elem]
+        if v
+          v = [v] if v.is_a?(SergioElement)
+          vs = v.select do |v|
+            if v.options[:having]
+              match = v.options[:having].any? do |attr,value|
+                current_elem_attrs = current_elem[1]
+                elem_val = current_elem_attrs.assoc(attr.to_s)
+                elem_val[1] == value.to_s if elem_val
+              end
+              true if match
+            else
+              true
+            end
+          end
+          vs
+        end
+      end
+    end
+  end
+end

data/lib/sergio/sergio_element.rb

@@ -0,0 +1,8 @@
+class SergioElement
+  attr_accessor :new_path, :callback, :options
+  def initialize(new_path, args, callback)
+    @new_path = new_path.clone
+    @callback = callback
+    @options = args
+  end
+end

data/lib/sergio/sergio_parsed_document.rb

@@ -0,0 +1,32 @@
+module Sergio
+  class ParsedDocument
+    include HashMethods
+    attr_accessor :parsed_hash
+
+    def initialize
+      @parsed_hash = {}
+    end
+
+    def set_element(path, val, options = {})
+      v = value_at_path(path.clone, self.parsed_hash)
+
+      val = if v
+        if v.is_a? Array
+          v << val
+        else
+          if val.is_a?(Hash) && val.empty?
+            options[:as_array] ? [v] : v
+          else
+            [v] << val
+          end
+        end
+      else
+        options[:as_array] ? [val] : val
+      end
+
+      h = hash_from_path(path, val)
+      @parsed_hash = hash_recursive_merge(self.parsed_hash, h)
+      @parsed_hash
+    end
+  end
+end

data/lib/sergio/sergio_sax.rb

@@ -0,0 +1,45 @@
+class SergioSax < Nokogiri::XML::SAX::Document
+  def initialize(object)
+    @stack = []
+    @object = object
+  end
+
+  def start_element(name, attrs = [])
+    @stack << [name, attrs]
+  end
+
+  def characters(string)
+    name, attrs = @stack.last
+    attrs << ['@text', string]
+  end
+
+  def cdata_block(string)
+    characters(string)
+  end
+  
+  def end_element(name)
+    e_context = @stack.clone
+    name, attrs = @stack.pop
+    if sergio_elements = @object.class.sergio_config.get_element_configs(e_context)
+      sergio_elements.each do |sergio_element|
+        attr = sergio_element.options[:attribute]
+        val = attrs.assoc(attr)
+        if val
+          val = val[1]
+          hash_path = sergio_element.new_path
+          callback = sergio_element.callback
+
+          r = if callback.arity == 1
+            callback.call(val)
+          elsif callback.arity == 2
+            h = Hash[*attrs.flatten]
+            h.delete('@text')
+            callback.call(val, Hash[*attrs.flatten])
+          end
+
+          @object.sergio_parsed_document.set_element(hash_path, r, sergio_element.options)
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+require 'rspec'
+require File.dirname(__FILE__) + '/../lib/sergio'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end
+
+def new_sergio(&blk)
+  c = Class.new do
+    include Sergio
+  end
+  if block_given?
+    c.class_exec(&blk)
+  end
+  c
+end

data/spec/support/buzz_activity_stream.xml

@@ -0,0 +1,48 @@
+<entry xmlns="http://www.w3.org/2005/Atom" xmlns:georss="http://www.georss.org/georss" xmlns:media="http://search.yahoo.com/mrss/" xmlns:buzz="http://schemas.google.com/buzz/2010" xmlns:crosspost="http://purl.org/syndication/cross-posting" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0" xmlns:activity="http://activitystrea.ms/spec/1.0/" xmlns:poco="http://portablecontacts.net/ns/1.0" gd:kind="buzz#activity"> 
+  <title>Seated figure</title> 
+  <published>2011-05-20T15:30:02.000Z</published> 
+  <updated>2011-05-20T15:35:30.184Z</updated> 
+  <id>tag:google.com,2010:buzz:z12dgfjgkwabv3egs04ch3kqzqnscp2xvhc</id> 
+  <link href="https://profiles.google.com/101327999921150687436/posts/SUjANDpeWVo" type="text/html" rel="alternate"/> 
+  <link href="https://www.googleapis.com/buzz/v1/activities/101327999921150687436/@self/B:z12dgfjgkwabv3egs04ch3kqzqnscp2xvhc?alt=atom" type="application/atom+xml" rel="self"/> 
+  <link thr:count="0" href="https://www.googleapis.com/buzz/v1/activities/101327999921150687436/@self/B:z12dgfjgkwabv3egs04ch3kqzqnscp2xvhc/@comments?alt=atom" type="application/atom+xml" thr:updated="2011-05-20T15:35:30.184Z" rel="replies"/> 
+  <author> 
+    <poco:id>101327999921150687436</poco:id> 
+    <poco:photoUrl/> 
+    <name>Roy Patrick Tan</name> 
+    <uri>https://profiles.google.com/101327999921150687436</uri> 
+    <link href="" type="image/jpeg" rel="photo"/> 
+    <activity:object-type>http://activitystrea.ms/schema/1.0/person</activity:object-type> 
+  </author> 
+  <content type="html">Seated figure</content> 
+  <activity:verb>http://activitystrea.ms/schema/1.0/post</activity:verb> 
+  <activity:object> 
+    <activity:object-type>http://activitystrea.ms/schema/1.0/note</activity:object-type> 
+    <content type="html">Seated figure</content> 
+    <buzz:original-content type="text"/> 
+    <link href="https://profiles.google.com/101327999921150687436/posts/SUjANDpeWVo" type="text/html" rel="alternate"/> 
+    <buzz:attachment> 
+      <activity:object-type>http://activitystrea.ms/schema/1.0/photo</activity:object-type> 
+      <title>Seated figure</title> 
+      <link media:width="1744" href="http://farm4.static.flickr.com/3539/5740322886_f9273216ea_o.jpg" type="image/jpeg" rel="enclosure" media:height="2331"/> 
+      <link href="http://www.flickr.com/photos/8962549@N02/5740322886" type="text/html" rel="alternate"/> 
+      <link href="http://images0-focus-opensocial.googleusercontent.com/gadgets/proxy?container=focus&amp;gadget=a&amp;resize_h=100&amp;url=http%3A%2F%2Ffarm4.static.flickr.com%2F3539%2F5740322886_ebcef1bbec_m.jpg" type="image/jpeg" rel="preview"/> 
+      <link href="http://images0-focus-opensocial.googleusercontent.com/gadgets/proxy?container=focus&amp;gadget=a&amp;resize_h=100&amp;url=http%3A%2F%2Ffarm4.static.flickr.com%2F3539%2F5740322886_ebcef1bbec_b.jpg" type="image/jpeg" rel="preview"/> 
+    </buzz:attachment> 
+  </activity:object> 
+  <source> 
+    <activity:service> 
+      <title>Flickr</title> 
+    </activity:service> 
+    <id>tag:google.com,2010:buzz-feed:public:posted:101327999921150687436</id> 
+    <updated>2011-05-20T15:35:30.184Z</updated> 
+    <link href="https://www.googleapis.com/buzz/v1/activities/101327999921150687436/@public?alt=atom" type="application/atom+xml" rel="self"/> 
+    <link href="http://pubsubhubbub.appspot.com/" rel="hub"/> 
+  </source> 
+  <buzz:visibility> 
+    <buzz:aclentry type="group"> 
+      <poco:name>Public</poco:name> 
+    </buzz:aclentry> 
+  </buzz:visibility> 
+  <link buzz:count="0" href="https://www.googleapis.com/buzz/v1/activities/101327999921150687436/@self/B:z12dgfjgkwabv3egs04ch3kqzqnscp2xvhc/@liked?alt=atom" type="application/poco+xml" rel="http://schemas.google.com/buzz/2010#liked"/> 
+</entry> 

data/spec/support/facebook_activity_stream.xml

@@ -0,0 +1,43 @@
+<entry xmlns="http://www.w3.org/2005/Atom" xmlns:activity="http://activitystrea.ms/spec/1.0/" xmlns:service="http://activitystrea.ms/service-provider" xmlns:thr="http://purl.org/syndication/thread/1.0" xmlns:gnip="http://www.gnip.com/schemas/2010"> 
+  <id>100000601711657_225559834120776</id> 
+  <created>2011-05-19T23:13:57+00:00</created> 
+  <published>2011-05-19T23:13:57+00:00</published> 
+  <updated>2011-05-19T23:13:57+00:00</updated> 
+  <title>Shane Smith posted a bookmark to Facebook</title> 
+  <category term="BookmarkPosted" label="Bookmark Posted"/> 
+  <link rel="alternate" type="html" href="http://www.facebook.com/profile.php?id=100000601711657&amp;v=wall&amp;story_fbid=225559834120776"/> 
+  <generator uri="http://www.facebook.com/apps/application.php?id=2344061033">Events</generator> 
+  <source> 
+    <link rel="self" type="application/json" href="https://graph.facebook.com/search?q=party&amp;type=post&amp;limit=75&amp;access_token=&amp;since=Thu+May+19+19%3A13%3A32+-0400+2011"/> 
+    <title>Facebook - Keyword - Search - party</title> 
+    <updated>2011-05-19T23-14-05Z</updated> 
+    <gnip:rule xmlns:gnip="http://www.gnip.com/schemas/2010">party</gnip:rule> 
+  </source> 
+  <service:provider> 
+    <name>Facebook</name> 
+    <uri>www.facebook.com</uri> 
+    <icon/> 
+  </service:provider> 
+  <activity:verb>http://activitystrea.ms/schema/1.0/post</activity:verb> 
+  <activity:object> 
+    <activity:object-type>http://activitystrea.ms/schema/1.0/bookmark</activity:object-type> 
+    <id>100000601711657_225559834120776</id> 
+    <title>GRADUATION PARTY!!!</title> 
+    <content>Come to my Graduation Party on June 18th!!!</content> 
+    <link rel="alternate" type="html" href="http://www.facebook.com/profile.php?id=100000601711657&amp;v=wall&amp;story_fbid=225559834120776"/> 
+    <link rel="related" href="http://www.facebook.com/event.php?eid=184487541600108"/> 
+    <link rel="preview" href="http://profile.ak.fbcdn.net/hprofile-ak-snc4/187804_184487541600108_5482560_s.jpg"/> 
+  </activity:object> 
+  <author> 
+    <name>Shane Smith</name> 
+    <uri>http://www.facebook.com/profile.php?id=100000601711657</uri> 
+  </author> 
+  <activity:actor> 
+    <activity:object-type>http://activitystrea.ms/schema/1.0/person</activity:object-type> 
+    <link rel="alternate" type="html" length="0" href="http://www.facebook.com/profile.php?id=100000601711657"/> 
+  </activity:actor> 
+  <gnip:matching_rules> 
+    <gnip:matching_rule rel="source">party</gnip:matching_rule> 
+    <gnip:matching_rule rel="source">neat</gnip:matching_rule> 
+  </gnip:matching_rules> 
+</entry>

data/spec/support/twitter_activity_stream.xml

@@ -0,0 +1,52 @@
+<entry xmlns="http://www.w3.org/2005/Atom" xmlns:gnip="http://www.gnip.com/schemas/2010">
+  <id>tag:search.twitter.com,2005:71230904948883456</id>
+  <published>2011-05-19T15:09:05+00:00</published>
+  <updated>2011-05-19T15:09:05+00:00</updated>
+  <summary type="html">@mrpotatochipman cool ;)</summary>
+  <link rel="alternate" type="text/html" href="http://twitter.com/_P3PP_CE/statuses/71230904948883456"/>
+  <source>
+    <link rel="self" type="application/json" href="http://stream.twitter.com/1/statuses/filter.json"/>
+    <title>Twitter - Stream - Track</title>
+    <updated>2011-05-19T15:09:08Z</updated>
+  </source>
+  <service:provider xmlns:service="http://activitystrea.ms/service-provider">
+    <name>Twitter</name>
+    <uri>http://www.twitter.com/</uri>
+    <icon/>
+  </service:provider>
+  <title>P3PP posted a note on Twitter</title>
+  <category term="StatusPosted" label="Status Posted"/>
+  <category term="NotePosted" label="Note Posted"/>
+  <activity:verb xmlns:activity="http://activitystrea.ms/spec/1.0/">http://activitystrea.ms/schema/1.0/post</activity:verb>
+  <activity:object xmlns:activity="http://activitystrea.ms/spec/1.0/">
+    <activity:object-type>http://activitystrea.ms/schema/1.0/note</activity:object-type>
+    <id>object:search.twitter.com,2005:71230904948883456</id>
+    <content type="html">@mrpotatochipman cool ;)</content>
+    <link rel="alternate" type="text/html" href="http://twitter.com/_P3PP_CE/statuses/71230904948883456"/>
+    <thr:in-reply-to xmlns:thr="http://purl.org/syndication/thread/1.0" type="text/html" href="http://twitter.com/mrpotatochipman/statuses/71229949155086336"/>
+  </activity:object>
+  <author>
+    <name>P3PP</name>
+    <uri>http://www.twitter.com/_P3PP_CE</uri>
+  </author>
+  <activity:author xmlns:activity="http://activitystrea.ms/spec/1.0/">
+    <activity:object-type>http://activitystrea.ms/schema/1.0/person</activity:object-type>
+    <gnip:friends xmlns:gnip="http://www.gnip.com/schemas/2010" followersCount="911" followingCount="839"/>
+    <link rel="alternate" type="text/html" length="0" href="http://www.twitter.com/_P3PP_CE"/>
+    <link rel="avatar" href="http://a0.twimg.com/profile_images/1352659419/l_15_normal.jpg"/>
+    <id>http://www.twitter.com/_P3PP_CE</id>
+  </activity:author>
+  <activity:actor xmlns:activity="http://activitystrea.ms/spec/1.0/">
+    <activity:object-type>http://activitystrea.ms/schema/1.0/person</activity:object-type>
+    <gnip:friends xmlns:gnip="http://www.gnip.com/schemas/2010" followersCount="911" followingCount="839"/>
+    <gnip:stats xmlns:gnip="http://www.gnip.com/schemas/2010" activityCount="22964" upstreamId="id:twitter.com:125163780"/>
+    <link rel="alternate" type="text/html" length="0" href="http://www.twitter.com/_P3PP_CE"/>
+    <link rel="avatar" href="http://a0.twimg.com/profile_images/1352659419/l_15_normal.jpg"/>
+    <id>http://www.twitter.com/_P3PP_CE</id>
+    <os:location xmlns:os="http://ns.opensocial.org/2008/opensocial">Back N Da LAND,Oh10</os:location>
+    <os:aboutMe xmlns:os="http://ns.opensocial.org/2008/opensocial">Jus A Laid Back Type Of Chick, Who Aint On No B.S  Mad Cool. #TeamGemini, #RMF, #BBN, #TFB, #TeamDroid #TeamSingle Reppn Im Owt ;) </os:aboutMe>
+  </activity:actor>
+  <gnip:matching_rules>
+    <gnip:matching_rule rel="inferred" tag="NEAT">cool</gnip:matching_rule>
+  </gnip:matching_rules>
+</entry>

data/spec/unit/sergio_hash_methods_spec.rb

@@ -0,0 +1,79 @@
+require 'spec_helper'
+
+describe Sergio::HashMethods do
+  context 'value_at_path' do
+    before do
+      @s = Class.new do
+        include Sergio::HashMethods
+      end.new
+    end
+
+    it 'gets the value from passed in hash at point in heirarchy specified by passed in array' do
+      v = @s.value_at_path([['thing'], ['stuff']], {'thing' => {'stuff' => '2'}})
+      v.should == '2'
+    end
+
+    it 'gets the value from passed in hash at point in heirarchy specified by passed in array if array is one element long' do
+      v = @s.value_at_path([['thing']], {'thing' => {'stuff' => '2'}})
+      v.should == {'stuff' => '2'}
+    end
+
+    it 'returns nil if value is not present in hash' do
+      v = @s.value_at_path(['thing', 'stuff'], {'thing' => {'guy' => '2'}})
+      v.should == nil
+    end
+  end
+
+  context 'hash_recursive_merge_to_arrays' do
+    before do
+      @s = Class.new do
+        include Sergio::HashMethods
+      end.new
+    end
+
+
+    it 'merges subhashes together' do
+      h1 = {:thing => {'guy' => 'cool'}}
+      h2 = {:thing => {'guys' => 'cool'}}
+      @s.hash_recursive_merge_to_arrays(h1, h2).should == {:thing => {'guy' => 'cool', 'guys' => 'cool'}}
+    end
+
+    it 'builds an array out of values on intersecting keys' do
+      h1 = {:thing => {'guy' => 'cool'}}
+      h2 = {:thing => {'guy' => 'cool'}}
+      @s.hash_recursive_merge_to_arrays(h1, h2).should == {:thing => {'guy' => ['cool', 'cool']}}
+    end
+
+    it 'appends to array if in value of left intersecting key' do
+      h1 = {:thing => {'guy' => ['cool', 'neat']}}
+      h2 = {:thing => {'guy' => 'cool'}}
+      @s.hash_recursive_merge_to_arrays(h1, h2).should == {:thing => {'guy' => ['cool', 'neat', 'cool']}}
+    end
+
+    it 'appends to array if in value of right intersecting key' do
+      h1 = {:thing => {'guy' => 'cool'}}
+      h2 = {:thing => {'guy' => ['cool', 'neat']}}
+      @s.hash_recursive_merge_to_arrays(h1, h2).should == {:thing => {'guy' => ['cool', 'neat', 'cool']}}
+    end
+  end
+
+  context 'hash_recursive_merge' do
+    before do
+      @s = Class.new do
+        include Sergio::HashMethods
+      end.new
+    end
+
+    it 'merges subhashes together' do
+      h1 = {:thing => {'guy' => 'cool'}}
+      h2 = {:thing => {'guys' => 'cool'}}
+      @s.hash_recursive_merge(h1, h2).should == {:thing => {'guy' => 'cool', 'guys' => 'cool'}}
+    end
+
+    it 'replaces intersecting key values with rightmost hash argument value' do
+      h1 = {:thing => {'guy' => 'cool'}}
+      h2 = {:thing => {'guy' => 'cools'}}
+      @s.hash_recursive_merge(h1, h2).should == {:thing => {'guy' => 'cools'}}
+    end
+  end
+end

data/spec/unit/sergio_spec.rb

@@ -0,0 +1,248 @@
+require 'spec_helper'
+
+describe Sergio do
+  context 'element' do
+    it 'parses an element' do
+      s = new_sergio do
+        element 'id'
+      end
+
+      @xml = "<id>1</id>"
+      @hash = s.new.parse(@xml)
+      @hash['id'].should == '1'
+    end
+
+    it 'parses duplicate elements into an array' do
+      s = new_sergio do
+        element 'parent' do
+          element 'id'
+        end
+      end
+
+      @xml = "<parent><id>1</id><id>2</id></parent>"
+      @hash = s.new.parse(@xml)
+      @hash['parent']['id'].should == ['1', '2']
+    end
+
+    it 'parses duplicate elements whose callbacks return a hash into an array' do
+      s = new_sergio do
+        element 'parent' do
+          element 'id' do |v|
+            {'v' => v}
+          end
+        end
+      end
+
+      @xml = "<parent><id>1</id><id>2</id></parent>"
+      @hash = s.new.parse(@xml)
+      @hash['parent']['id'].should == [{'v' => '1',}, {'v' => '2'}]
+    end
+
+    it 'parses a nested element' do
+      s = new_sergio do
+        element 'ip' do
+          element 'man'
+        end
+      end
+
+      @xml = "<ip><man>neat</man></ip>"
+      @hash = s.new.parse(@xml)
+      @hash['ip']['man'].should == 'neat'
+    end
+
+    it 'renames an element to second argument passed to #element if argument is provided' do
+      s = new_sergio do
+        element 'man', 'guy'
+      end
+
+      @xml = "<man>neat</man>"
+      @hash = s.new.parse(@xml)
+      @hash['guy'].should == 'neat'
+    end
+
+    it 'passes value into block if block has an arity of 1. And sets element value to block result' do
+      s = new_sergio do
+        element 'man' do |v|
+          v.reverse
+        end
+      end
+
+      @xml = "<man>neat</man>"
+      @hash = s.new.parse(@xml)
+      @hash['man'].should == 'taen'
+    end
+
+    it 'passes value and attributes into block if block has an arity of 2 and sets element value to block result' do
+      s = new_sergio do
+        element 'man' do |v, attrs|
+          {'u' => attrs['it'], 'v' => v.reverse}
+        end
+      end
+
+      @xml = "<man it='u'>neat</man>"
+      @hash = s.new.parse(@xml)
+      @hash['man'].should == {'u' => 'u', 'v' => 'taen'}
+    end
+
+    it 'renames a parent element to second argument passed to #element if argument is provided' do
+      s = new_sergio do
+        element 'parent', 'post' do
+          element 'id'
+        end
+      end
+
+      @xml = "<parent><id>1</id><id>2</id></parent>"
+      @hash = s.new.parse(@xml)
+      @hash['post'].should == {'id' => ['1', '2']}
+    end
+
+    it 'renames a child element to second argument passed to #element if argument is provided' do
+      s = new_sergio do
+        element 'parent', 'post' do
+          element 'id', 'di'
+        end
+      end
+
+      @xml = "<parent><id>1</id><id>2</id></parent>"
+      @hash = s.new.parse(@xml)
+      @hash['post'].should == {'di' => ['1', '2']}
+    end
+
+    it 'matches against attributes using :having argument' do
+      s = new_sergio do
+        element 'parent', 'post' do
+          element 'ya', 'kewl', :attribute => 'location', :having => {:href => 'cool', :poopy => 'true'}
+        end
+      end
+
+      @xml = "<parent><ha href='imahref'>neat</ha><ha href='cool'>rad</ha><ya href='cool' poopy='true' location='my house'>wee</ya></parent>"
+      @hash = s.new.parse(@xml)
+      @hash['post']['kewl'].should == 'my house'
+    end
+
+    it 'forces aggregation of matching results into an array even for one match if passed :as_array => true' do
+      s = new_sergio do
+        element 'parent', 'post' do
+          element 'ya', 'kewl', :attribute => 'location', :having => {:href => 'cool', :poopy => 'true'}, :as_array => true
+        end
+      end
+
+      @xml = "
+        <parent>
+          <ha href='imahref'>neat</ha>
+          <ha href='cool'>rad</ha>
+          <ya href='cool' poopy='true' location='my house'>wee</ya>
+        </parent>"
+      @hash = s.new.parse(@xml)
+      @hash['post']['kewl'].should == ['my house']
+    end
+
+    it 'matches against multiple elements within same parent' do
+      s = new_sergio do
+        element 'parent', 'post' do
+          element 'ha', 'link', :having => {:href => 'cool'} do |val|
+            val.reverse
+          end
+          element 'ya', 'kewl', :attribute => 'location', :having => {:href => 'cool', :poopy => 'true'}
+        end
+      end
+
+      @xml = "<parent>
+        <ha href='imahref'>neat</ha>
+        <ha href='cool'>rad</ha><ya href='cool' poopy='true' location='my house'>wee</ya>
+      </parent>"
+
+      @hash = s.new.parse(@xml)
+      @hash['post']['link'].should == 'dar'
+      @hash['post']['kewl'].should == 'my house'
+    end
+
+    it 'matches against multiple elements of the same type within same parent' do
+      s = new_sergio do
+        element 'p' do
+          element 'a', :attribute => 'href' do |v|
+            v.upcase
+          end
+          element 'a', :attribute => 'cool' do |v|
+            v.upcase
+          end
+        end
+      end
+
+      @xml = "<p><a href='cool'>hi</a><a cool='true'>hy</a></p>"
+      @hash = s.new.parse(@xml)
+      @hash['p']['a'].should == ['COOL','TRUE']
+    end
+
+    it 'uses value of attribute using :attribute argument' do
+      s = new_sergio do
+        element 'a', 'link', :attribute => 'href'
+      end
+
+      @xml = "<a href='neat'>neat</a>"
+      @hash = s.new.parse(@xml)
+      @hash['link'].should == 'neat'
+    end
+
+    it 'accepts an array as the first argument to specify a path to an element' do
+      s = new_sergio do
+        element ['a', 'b'], 'c', :attribute => 'y'
+      end
+
+      @xml = '<a><b y="what"></b></a>'
+      @hash = s.new.parse(@xml)
+      @hash['c'].should == 'what'
+    end
+
+    it 'accepts an array as the second argument to specify a path to an element to merge to' do
+      s = new_sergio do
+        element 'a', ['b', 'c'], :attribute => 'y'
+      end
+
+      @xml = '<a y="what"></a>'
+      @hash = s.new.parse(@xml)
+      @hash['b'].should == {'c' => 'what'}
+    end
+
+    it 'accepts an array for both arguments to specify a path to an element to get value from and to  merge to' do
+      s = new_sergio do
+        element 'p' do
+          element 'd'
+          element ['a', 'b'], ['b', 'c'], :attribute => 'y'
+          element 'a'
+        end
+      end
+
+      @xml = '<p><d>a</d><a y="what"><b y="hi"></b></a></p>'
+      @hash = s.new.parse(@xml)
+      @hash['p']['b'].should == {'c' => 'hi'}
+    end
+
+    it 'accepts a class which includes sergio as an argument' do
+      class Pozt
+        include Sergio
+
+        element 'b'
+      end
+
+      s = new_sergio do
+        element 'a', Pozt
+      end
+
+      @xml = '<a y="what"><b>hi</b></a>'
+      @hash = s.new.parse(@xml)
+      @hash['a']['b'].should == {'c' => 'what'}
+    end
+  end
+
+  context 'set_element' do
+    before do
+      @s = new_sergio
+    end
+
+    it 'sets the element at the appropriate point in the hierarchy' do
+      v = @s.new.sergio_parsed_document.set_element(['thing', 'stuff'], '1')
+      v.should == {'thing' => {'stuff' => '1'}}
+    end
+  end
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification 
+name: sergio
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Max Justus Spransy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-25 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 2.5.0
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: "\n      Sergio provides a declarative syntax for parsing unruly xml into nice pretty hashes.\n    "
+email: 
+- maxjustus@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Gemfile
+- Gemfile.lock
+- Rakefile
+- lib/sergio.rb
+- lib/sergio/hash_methods.rb
+- lib/sergio/sergio_config.rb
+- lib/sergio/sergio_element.rb
+- lib/sergio/sergio_parsed_document.rb
+- lib/sergio/sergio_sax.rb
+- spec/spec_helper.rb
+- spec/support/buzz_activity_stream.xml
+- spec/support/facebook_activity_stream.xml
+- spec/support/twitter_activity_stream.xml
+- spec/unit/sergio_hash_methods_spec.rb
+- spec/unit/sergio_spec.rb
+has_rdoc: true
+homepage: https://github.com/maxjustus/Sergio
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: sergio
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: SAXy xml to hash transformation.
+test_files: 
+- spec/spec_helper.rb
+- spec/support/buzz_activity_stream.xml
+- spec/support/facebook_activity_stream.xml
+- spec/support/twitter_activity_stream.xml
+- spec/unit/sergio_hash_methods_spec.rb
+- spec/unit/sergio_spec.rb