jimmyz-happymapper 0.3.1

data/spec/happymapper_attribute_spec.rb

@@ -0,0 +1,17 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe HappyMapper::Attribute do
+  describe "initialization" do
+    before do
+      @attr = HappyMapper::Attribute.new(:foo, String)
+    end
+    
+    it 'should know that it is an attribute' do
+      @attr.attribute?.should be_true
+    end
+    
+    it 'should know that it is NOT an element' do
+      @attr.element?.should be_false
+    end
+  end
+end

data/spec/happymapper_element_spec.rb

@@ -0,0 +1,17 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe HappyMapper::Element do
+  describe "initialization" do
+    before do
+      @attr = HappyMapper::Element.new(:foo, String)
+    end
+    
+    it 'should know that it is an element' do
+      @attr.element?.should be_true
+    end
+    
+    it 'should know that it is NOT an attribute' do
+      @attr.attribute?.should be_false
+    end
+  end
+end

data/spec/happymapper_item_spec.rb

@@ -0,0 +1,94 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe HappyMapper::Item do
+  
+  describe "new instance" do
+    before do
+      @item = HappyMapper::Item.new(:foo, String, :tag => 'foobar')
+    end
+    
+    it "should accept a name" do
+      @item.name.should == 'foo'
+    end
+    
+    it 'should accept a type' do
+      @item.type.should == String
+    end
+    
+    it 'should accept :tag as an option' do
+      @item.tag.should == 'foobar'
+    end
+    
+    it "should have a method_name" do
+      @item.method_name.should == 'foo'
+    end
+  end
+  
+  describe "#method_name" do
+    it "should convert dashes to underscores" do
+      item = HappyMapper::Item.new(:'foo-bar', String, :tag => 'foobar')
+      item.method_name.should == 'foo_bar'
+    end
+  end
+  
+  describe "#xpath" do
+    it "should default to tag" do
+      item = HappyMapper::Item.new(:foo, String, :tag => 'foobar')
+      item.xpath.should == 'foobar'
+    end
+    
+    it "should prepend with .// if options[:deep] true" do
+      item = HappyMapper::Item.new(:foo, String, :tag => 'foobar', :deep => true)
+      item.xpath.should == './/foobar'
+    end
+    
+    it "should prepend namespace if namespace exists" do
+      item = HappyMapper::Item.new(:foo, String, :tag => 'foobar')
+      item.namespace = 'v2'
+      item.xpath.should == 'v2:foobar'
+    end
+  end
+  
+  describe "typecasting" do
+    it "should work with Strings" do
+      item = HappyMapper::Item.new(:foo, String)
+      [21, '21'].each do |a|
+        item.typecast(a).should == '21'
+      end
+    end
+    
+    it "should work with Integers" do
+      item = HappyMapper::Item.new(:foo, Integer)
+      [21, 21.0, '21'].each do |a|
+        item.typecast(a).should == 21
+      end
+    end
+    
+    it "should work with Floats" do
+      item = HappyMapper::Item.new(:foo, Float)
+      [21, 21.0, '21'].each do |a|
+        item.typecast(a).should == 21.0
+      end
+    end
+    
+    it "should work with Times" do
+      item = HappyMapper::Item.new(:foo, Time)
+      item.typecast('2000-01-01 01:01:01.123456').should == Time.local(2000, 1, 1, 1, 1, 1, 123456)
+    end
+    
+    it "should work with Dates" do
+      item = HappyMapper::Item.new(:foo, Date)
+      item.typecast('2000-01-01').should == Date.new(2000, 1, 1)
+    end
+    
+    it "should work with DateTimes" do
+      item = HappyMapper::Item.new(:foo, DateTime)
+      item.typecast('2000-01-01 00:00:00').should == DateTime.new(2000, 1, 1, 0, 0, 0)
+    end
+    
+    it "should work with Boolean" do
+      item = HappyMapper::Item.new(:foo, Boolean)
+      item.typecast('false').should == false
+    end
+  end
+end

data/spec/happymapper_spec.rb

@@ -0,0 +1,666 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require File.dirname(__FILE__) + '/xml_helper.rb'
+require 'pp'
+require 'uri'
+
+class Address
+  include HappyMapper
+  
+  tag 'address'
+  element :street, String
+  element :postcode, String
+  element :housenumber, String
+  element :city, String
+  element :country, String
+end
+
+class Feature
+  include HappyMapper
+  element :name, String, :tag => '.|.//text()'
+end
+
+class FeatureBullet
+  include HappyMapper
+
+  tag 'features_bullets'
+  has_many :features, Feature
+  element :bug, String
+end
+
+class Product
+  include HappyMapper
+
+  element :title, String
+  has_one :feature_bullets, FeatureBullet
+  has_one :address, Address
+end
+
+module FamilySearch
+  class AlternateIds
+    include HappyMapper
+    
+    namespace 'fsapi-v1' => 'http://api.familysearch.org/v1'
+    tag 'alternateIds'
+    has_many :ids, String, :tag => 'id'
+  end
+  
+  class Information
+    include HappyMapper
+    
+    namespace 'fsapi-v1' => 'http://api.familysearch.org/v1'
+    has_one :alternateIds, AlternateIds
+    element :gender, String 
+    element :living, Boolean
+  end
+  
+  class Person
+    include HappyMapper
+    
+    namespace_url 'http://api.familysearch.org/familytree/v1'
+    attribute :version, String
+    attribute :modified, Time
+    attribute :id, String
+    has_one :information, Information
+  end
+  
+  class Persons
+    include HappyMapper
+    
+    namespace_url 'http://api.familysearch.org/familytree/v1'
+    has_many :person, Person
+  end
+  
+  class FamilyTree
+    include HappyMapper
+    
+    tag 'familytree'
+    namespace_url 'http://api.familysearch.org/familytree/v1'
+    attribute :version, String
+    attribute :status_message, String, :tag => 'statusMessage'
+    attribute :status_code, String, :tag => 'statusCode'
+    has_one :persons, Persons
+  end
+end
+
+module FedEx
+  class Address
+    include HappyMapper
+    
+    tag 'Address'
+    namespace 'v2'
+    element :city, String, :tag => 'City'
+    element :state, String, :tag => 'StateOrProvinceCode'
+    element :zip, String, :tag => 'PostalCode'
+    element :countrycode, String, :tag => 'CountryCode'
+    element :residential, Boolean, :tag => 'Residential'
+  end
+  
+  class Event
+    include HappyMapper
+    
+    tag 'Events'
+    namespace 'v2'
+    element :timestamp, String, :tag => 'Timestamp'
+    element :eventtype, String, :tag => 'EventType'
+    element :eventdescription, String, :tag => 'EventDescription'
+    has_one :address, Address
+  end
+  
+  class PackageWeight
+    include HappyMapper
+    
+    tag 'PackageWeight'
+    namespace 'v2'
+    element :units, String, :tag => 'Units'
+    element :value, Integer, :tag => 'Value'
+  end
+  
+  class TrackDetails
+    include HappyMapper
+    
+    tag 'TrackDetails'
+    namespace 'v2'
+    element   :tracking_number, String, :tag => 'TrackingNumber'
+    element   :status_code, String, :tag => 'StatusCode'
+    element   :status_desc, String, :tag => 'StatusDescription'
+    element   :carrier_code, String, :tag => 'CarrierCode'
+    element   :service_info, String, :tag => 'ServiceInfo'
+    has_one   :weight, PackageWeight, :tag => 'PackageWeight'
+    element   :est_delivery,  String, :tag => 'EstimatedDeliveryTimestamp'
+    has_many  :events, Event
+  end 
+    
+  class Notification
+    include HappyMapper
+    
+    tag 'Notifications'
+    namespace 'v2'
+    element :severity, String, :tag => 'Severity'
+    element :source, String, :tag => 'Source'
+    element :code, Integer, :tag => 'Code'
+    element :message, String, :tag => 'Message'
+    element :localized_message, String, :tag => 'LocalizedMessage'
+  end
+  
+  class TransactionDetail
+    include HappyMapper
+    
+    tag 'TransactionDetail'
+    namespace 'v2'
+    element :cust_tran_id, String, :tag => 'CustomerTransactionId'
+  end
+  
+  class TrackReply
+    include HappyMapper
+    
+    tag 'TrackReply'
+    namespace 'v2'
+    element   :highest_severity, String, :tag => 'HighestSeverity'
+    element   :more_data, Boolean, :tag => 'MoreData'
+    has_many  :notifications, Notification, :tag => 'Notifications'
+    has_many  :trackdetails, TrackDetails, :tag => 'TrackDetails'
+    has_one   :tran_detail, TransactionDetail, :tab => 'TransactionDetail'
+  end
+end
+
+class Place
+  include HappyMapper
+  element :name, String
+end
+
+class Radar
+  include HappyMapper
+  has_many :places, Place
+end
+
+class Post
+  include HappyMapper
+  
+  attribute :href, String
+  attribute :hash, String
+  attribute :description, String
+  attribute :tag, String
+  attribute :time, Time
+  attribute :others, Integer
+  attribute :extended, String
+end
+
+class Posts
+  include HappyMapper
+  
+  attribute :user, String
+  attribute :tag, String
+  has_many :post, Post
+end
+
+class User  
+  include HappyMapper
+  
+  element :id, Integer
+  element :name, String
+  element :screen_name, String
+  element :location, String
+  element :description, String
+  element :profile_image_url, String
+  element :url, String
+  element :protected, Boolean
+  element :followers_count, Integer
+end
+
+class Status
+  include HappyMapper
+  
+  element :id, Integer
+  element :text, String
+	element :created_at, Time
+	element :source, String
+	element :truncated, Boolean
+	element :in_reply_to_status_id, Integer
+	element :in_reply_to_user_id, Integer
+	element :favorited, Boolean
+	element :non_existent, String, :tag => 'dummy', :namespace => 'fake'
+	has_one :user, User
+end
+
+class CurrentWeather
+  include HappyMapper
+  
+  tag 'ob'
+  namespace 'aws'
+  element :temperature, Integer, :tag => 'temp'
+  element :feels_like, Integer, :tag => 'feels-like'
+  element :current_condition, String, :tag => 'current-condition', :attributes => {:icon => String}
+end
+
+# for type coercion
+class ProductGroup < String; end
+
+module PITA
+  class Item
+    include HappyMapper
+    
+    tag 'Item' # if you put class in module you need tag
+    element :asin, String, :tag => 'ASIN'
+    element :detail_page_url, URI, :tag => 'DetailPageURL', :parser => :parse
+    element :manufacturer, String, :tag => 'Manufacturer', :deep => true
+    element :point, String, :tag => 'point', :namespace => 'georss'
+    element :product_group, ProductGroup, :tag => 'ProductGroup', :deep => true, :parser => :new, :raw => true
+  end
+
+  class Items
+    include HappyMapper
+    
+    tag 'Items' # if you put class in module you need tag
+    element :total_results, Integer, :tag => 'TotalResults'
+    element :total_pages, Integer, :tag => 'TotalPages'
+    has_many :items, Item
+  end
+end
+
+module GitHub
+  class Commit
+    include HappyMapper
+
+    tag "commit"
+    element :url, String
+    element :tree, String
+    element :message, String
+    element :id, String
+    element :'committed-date', Date
+  end
+end
+
+describe HappyMapper do
+  
+  describe "being included into another class" do
+    before do
+      Foo.instance_variable_set("@attributes", {})
+      Foo.instance_variable_set("@elements", {})
+    end
+    class Foo; include HappyMapper end
+    
+    it "should set attributes to an array" do
+      Foo.attributes.should == []
+    end
+    
+    it "should set @elements to a hash" do
+      Foo.elements.should == []
+    end
+    
+    it "should allow adding an attribute" do
+      lambda {
+        Foo.attribute :name, String
+      }.should change(Foo, :attributes)
+    end
+    
+    it "should allow adding an attribute containing a dash" do
+      lambda {
+        Foo.attribute :'bar-baz', String
+      }.should change(Foo, :attributes)
+    end
+
+    it "should be able to get all attributes in array" do
+      Foo.attribute :name, String
+      Foo.attributes.size.should == 1
+    end
+    
+    it "should allow adding an element" do
+      lambda {
+        Foo.element :name, String
+      }.should change(Foo, :elements)
+    end
+
+    it "should allow adding an element containing a dash" do
+      lambda {
+        Foo.element :'bar-baz', String
+      }.should change(Foo, :elements)
+
+    end
+    
+    it "should be able to get all elements in array" do
+      Foo.element(:name, String)
+      Foo.elements.size.should == 1
+    end
+    
+    it "should allow has one association" do
+      Foo.has_one(:user, User)
+      element = Foo.elements.first
+      element.name.should == 'user'
+      element.type.should == User
+      element.options[:single] = true
+    end
+    
+    it "should allow has many association" do
+      Foo.has_many(:users, User)
+      element = Foo.elements.first
+      element.name.should == 'users'
+      element.type.should == User
+      element.options[:single] = false
+    end
+
+    it "should default tag name to lowercase class" do
+      Foo.tag_name.should == 'foo'
+    end
+    
+    it "should default tag name of class in modules to the last constant lowercase" do
+      module Bar; class Baz; include HappyMapper; end; end
+      Bar::Baz.tag_name.should == 'baz'
+    end
+    
+    it "should allow setting tag name" do
+      Foo.tag('FooBar')
+      Foo.tag_name.should == 'FooBar'
+    end
+    
+    it "should allow setting a namespace" do
+      Foo.namespace(namespace = "foo")
+      Foo.namespace.should == namespace
+    end
+    
+    # This is important for allowing serializing of elements with namespaces
+    it "should allow setting a full namespace (prefix and url) via a hash" do
+      Foo.namespace(namespace = {'example-v1' => 'http://example.com/v1'})
+      Foo.namespace.should == 'example-v1'
+      Foo.namespace_url.should == 'http://example.com/v1'
+    end
+    
+    # Prefixes might change for a given namespace. It is safer to namespace by url.
+    it "should allow setting a namespace url" do
+      Foo.namespace_url(url = 'http://example.com/namespace')
+      Foo.namespace_url.should == url
+    end
+
+    it "should provide #parse" do
+      Foo.should respond_to(:parse)
+    end
+  end
+  
+  describe "#attributes" do
+    it "should only return attributes for the current class" do
+      Post.attributes.size.should == 7
+      Status.attributes.size.should == 0
+    end
+  end
+  
+  describe "#elements" do
+    it "should only return elements for the current class" do
+      Post.elements.size.should == 0
+      Status.elements.size.should == 10
+    end
+  end
+  
+  it "should parse xml attributes into ruby objects" do
+    posts = Post.parse(fixture_file('posts.xml'))
+    posts.size.should == 20
+    first = posts.first
+    first.href.should == 'http://roxml.rubyforge.org/'
+    first.hash.should == '19bba2ab667be03a19f67fb67dc56917'
+    first.description.should == 'ROXML - Ruby Object to XML Mapping Library'
+    first.tag.should == 'ruby xml gems mapping'
+    first.time.should == Time.utc(2008, 8, 9, 5, 24, 20)
+    first.others.should == 56
+    first.extended.should == 'ROXML is a Ruby library designed to make it easier for Ruby developers to work with XML. Using simple annotations, it enables Ruby classes to be custom-mapped to XML. ROXML takes care of the marshalling and unmarshalling of mapped attributes so that developers can focus on building first-class Ruby classes.'
+  end
+  
+  it "should parse xml elements to ruby objcts" do
+    statuses = Status.parse(fixture_file('statuses.xml'))
+    statuses.size.should == 20
+    first = statuses.first
+    first.id.should == 882281424
+    first.created_at.should == Time.utc(2008, 8, 9, 5, 38, 12)
+    first.source.should == 'web'
+    first.truncated.should be_false
+    first.in_reply_to_status_id.should == 1234
+    first.in_reply_to_user_id.should == 12345
+    first.favorited.should be_false
+    first.user.id.should == 4243
+    first.user.name.should == 'John Nunemaker'
+    first.user.screen_name.should == 'jnunemaker'
+    first.user.location.should == 'Mishawaka, IN, US'
+    first.user.description.should == 'Loves his wife, ruby, notre dame football and iu basketball'
+    first.user.profile_image_url.should == 'http://s3.amazonaws.com/twitter_production/profile_images/53781608/Photo_75_normal.jpg'
+    first.user.url.should == 'http://addictedtonew.com'
+    first.user.protected.should be_false
+    first.user.followers_count.should == 486
+  end
+  
+  it "should parse xml containing the desired element as root node" do
+    address = Address.parse(fixture_file('address.xml'), :single => true)
+    address.street.should == 'Milchstrasse'
+    address.postcode.should == '26131'
+    address.housenumber.should == '23'
+    address.city.should == 'Oldenburg'
+    address.country.should == 'Germany'
+  end
+
+  it "should parse xml with default namespace (amazon)" do
+    file_contents = fixture_file('pita.xml')
+    items = PITA::Items.parse(file_contents, :single => true)
+    items.total_results.should == 22
+    items.total_pages.should == 3
+    first  = items.items[0]
+    second = items.items[1]
+    first.asin.should == '0321480791'
+    first.point.should == '38.5351715088 -121.7948684692'
+    first.detail_page_url.should be_a_kind_of(URI)
+    first.detail_page_url.to_s.should == 'http://www.amazon.com/gp/redirect.html%3FASIN=0321480791%26tag=ws%26lcode=xm2%26cID=2025%26ccmID=165953%26location=/o/ASIN/0321480791%253FSubscriptionId=dontbeaswoosh'
+    first.manufacturer.should == 'Addison-Wesley Professional'
+    first.product_group.should == '<ProductGroup>Book</ProductGroup>'
+    second.asin.should == '047022388X'
+    second.manufacturer.should == 'Wrox'
+  end
+
+  it "should parse xml that has attributes of elements" do
+    items = CurrentWeather.parse(fixture_file('current_weather.xml'))
+    first = items[0]
+    first.temperature.should == 51
+    first.feels_like.should == 51
+    first.current_condition.should == 'Sunny'
+    first.current_condition.icon.should == 'http://deskwx.weatherbug.com/images/Forecast/icons/cond007.gif'
+  end
+
+  it "should parse xml with nested elements" do
+    radars = Radar.parse(fixture_file('radar.xml'))
+    first = radars[0]
+    first.places.size.should == 1
+    first.places[0].name.should == 'Store'
+    second = radars[1]
+    second.places.size.should == 0
+    third = radars[2]
+    third.places.size.should == 2
+    third.places[0].name.should == 'Work'
+    third.places[1].name.should == 'Home'
+  end
+  
+  it "should parse xml that has elements with dashes" do
+    commit = GitHub::Commit.parse(fixture_file('commit.xml'))
+    commit.message.should == "move commands.rb and helpers.rb into commands/ dir"
+    commit.url.should == "http://github.com/defunkt/github-gem/commit/c26d4ce9807ecf57d3f9eefe19ae64e75bcaaa8b"
+    commit.id.should == "c26d4ce9807ecf57d3f9eefe19ae64e75bcaaa8b"
+    commit.committed_date.should == Date.parse("2008-03-02T16:45:41-08:00")
+    commit.tree.should == "28a1a1ca3e663d35ba8bf07d3f1781af71359b76"
+  end
+  
+  it "should parse xml with no namespace" do
+    product = Product.parse(fixture_file('product_no_namespace.xml'), :single => true)
+    product.title.should == "A Title"
+    product.feature_bullets.bug.should == 'This is a bug'
+    product.feature_bullets.features.size.should == 2
+    product.feature_bullets.features[0].name.should == 'This is feature text 1'
+    product.feature_bullets.features[1].name.should == 'This is feature text 2'
+  end
+  
+  it "should parse xml with default namespace" do
+    product = Product.parse(fixture_file('product_default_namespace.xml'), :single => true)
+    product.title.should == "A Title"
+    product.feature_bullets.bug.should == 'This is a bug'
+    product.feature_bullets.features.size.should == 2
+    product.feature_bullets.features[0].name.should == 'This is feature text 1'
+    product.feature_bullets.features[1].name.should == 'This is feature text 2'
+  end
+  
+  it "should parse xml with single namespace" do
+    product = Product.parse(fixture_file('product_single_namespace.xml'), :single => true)
+    product.title.should == "A Title"
+    product.feature_bullets.bug.should == 'This is a bug'
+    product.feature_bullets.features.size.should == 2
+    product.feature_bullets.features[0].name.should == 'This is feature text 1'
+    product.feature_bullets.features[1].name.should == 'This is feature text 2'
+  end
+  
+  it "should parse xml with multiple namespaces" do
+    track = FedEx::TrackReply.parse(fixture_file('multiple_namespaces.xml'))
+    track.highest_severity.should == 'SUCCESS'
+    track.more_data.should be_false
+    notification = track.notifications.first
+    notification.code.should == 0
+    notification.localized_message.should == 'Request was successfully processed.'
+    notification.message.should == 'Request was successfully processed.'
+    notification.severity.should == 'SUCCESS'
+    notification.source.should == 'trck'
+    detail = track.trackdetails.first
+    detail.carrier_code.should == 'FDXG'
+    detail.est_delivery.should == '2009-01-02T00:00:00'
+    detail.service_info.should == 'Ground-Package Returns Program-Domestic'
+    detail.status_code.should == 'OD'
+    detail.status_desc.should == 'On FedEx vehicle for delivery'
+    detail.tracking_number.should == '9611018034267800045212'
+    detail.weight.units.should == 'LB'
+    detail.weight.value.should == 2
+    events = detail.events
+    events.size.should == 10
+    first_event = events[0]
+    first_event.eventdescription.should == 'On FedEx vehicle for delivery'
+    first_event.eventtype.should == 'OD'
+    first_event.timestamp.should == '2009-01-02T06:00:00'
+    first_event.address.city.should == 'WICHITA'
+    first_event.address.countrycode.should == 'US'
+    first_event.address.residential.should be_false
+    first_event.address.state.should == 'KS'
+    first_event.address.zip.should == '67226'
+    last_event = events[-1]
+    last_event.eventdescription.should == 'In FedEx possession'
+    last_event.eventtype.should == 'IP'
+    last_event.timestamp.should == '2008-12-27T09:40:00'
+    last_event.address.city.should == 'LONGWOOD'
+    last_event.address.countrycode.should == 'US'
+    last_event.address.residential.should be_false
+    last_event.address.state.should == 'FL'
+    last_event.address.zip.should == '327506398'
+    track.tran_detail.cust_tran_id.should == '20090102-111321'
+  end
+  
+  it "should parse family search xml" do
+    tree = FamilySearch::FamilyTree.parse(fixture_file('family_tree.xml'))
+    tree.version.should == '1.0.20071213.942'
+    tree.status_message.should == 'OK'
+    tree.status_code.should == '200'
+    tree.persons.person.size.should == 1
+    tree.persons.person.first.version.should == '1199378491000'
+    tree.persons.person.first.modified.should == Time.utc(2008, 1, 3, 16, 41, 31) # 2008-01-03T09:41:31-07:00
+    tree.persons.person.first.id.should == 'KWQS-BBQ'
+    # namespaced elements (by url)
+    tree.persons.person.first.information.alternateIds.ids.should_not be_kind_of(String)
+    tree.persons.person.first.information.alternateIds.ids.size.should == 8
+    tree.persons.person.first.information.gender.should == 'Male'
+    tree.persons.person.first.information.living.should == false
+  end
+  
+  it "should not set values for missing attributes" do
+    posts = Post.parse(fixture_file("partial_posts.xml"))
+    first = posts.first
+    first.href.should be_nil
+    first.hash.should be_nil
+    first.description.should be_nil
+    first.tag.should be_nil
+    first.time.should be_nil
+    first.others.should be_nil
+    first.extended.should be_nil
+  end
+  
+  describe "serializing to xml" do
+    
+    it "should return xml with elements representing the objects" do
+      address = Address.parse(fixture_file('address.xml'), :single => true)
+      xml = address.to_xml
+      xml.should be_kind_of(String)
+      # Would love to use libxml-ruby if xml_helper.rb were converted
+      doc = REXML::Document.new xml 
+      doc.should have_nodes("/address", 1)
+      doc.should have_nodes("/address/street", 1)
+      doc.should match_xpath("/address/street","Milchstrasse")
+      doc.should match_xpath("/address/housenumber","23")
+      doc.should match_xpath("/address/postcode","26131")
+      doc.should match_xpath("/address/city","Oldenburg")
+      doc.should match_xpath("/address/country","Germany")
+    end
+    
+    it "should return xml with non-primitive elements from ruby objects" do
+      posts = Posts.parse(fixture_file('posts.xml'))
+      xml = posts.to_xml
+      doc = REXML::Document.new xml
+      doc.should have_nodes("/posts",1)
+      doc.should have_nodes("/posts/post",20)
+    end
+    
+    it "should return xml with attributes representing 'attribute' objects" do
+      posts = Posts.parse(fixture_file('posts.xml'))
+      xml = posts.to_xml
+      doc = REXML::Document.new xml
+      doc.should have_nodes("/posts/post",20)
+      doc.should match_xpath("/posts/post[1]/@href","http://roxml.rubyforge.org/")
+      doc.should match_xpath("/posts/post[1]/@hash","19bba2ab667be03a19f67fb67dc56917")
+      doc.should match_xpath("/posts/post[1]/@description","ROXML - Ruby Object to XML Mapping Library")
+      doc.should match_xpath("/posts/post[1]/@tag","ruby xml gems mapping")
+      doc.should match_xpath("/posts/post[1]/@others","56")
+      doc.should match_xpath("/posts/post[1]/@extended","ROXML is a Ruby library designed to make it easier for Ruby developers to work with XML. Using simple annotations, it enables Ruby classes to be custom-mapped to XML. ROXML takes care of the marshalling and unmarshalling of mapped attributes so that developers can focus on building first-class Ruby classes.")      
+    end
+    
+    it "should be able to create new objects and serialize to xml" do
+      posts = Posts.new
+      posts.user = 'jimmyz'
+      posts.tag = 'happymapper'
+      posts.post << Post.new
+      posts.post << Post.new
+      xml = posts.to_xml
+      doc = REXML::Document.new xml
+      doc.should have_nodes("/posts",1)
+      doc.should have_nodes("/posts/post", 2)
+      doc.should match_xpath("/posts/@user",'jimmyz')
+      doc.should match_xpath("/posts/@tag",'happymapper')
+    end
+    
+    it "should not serialize attributes or elements that are nil" do
+      posts = Posts.new
+      xml = posts.to_xml
+      doc = REXML::Document.new xml
+      doc.should have_nodes("/posts",1)
+      doc.should have_nodes("/posts/post",0)
+      doc.should have_nodes("/posts/@user",0)
+    end
+    
+    describe "with namespace url and prefix" do
+      before(:all) do
+        ft = FamilySearch::FamilyTree.parse(fixture_file('family_tree.xml'))
+        xml = ft.to_xml
+        @doc = REXML::Document.new xml
+        @namespaces = {
+          'fsapi-v1' => 'http://api.familysearch.org/v1', 
+          'fs' => 'http://api.familysearch.org/familytree/v1'
+        }
+      end
+      
+      it "should add namespaces to the root element that is being serialized" do
+        @doc.should match_xpath("/fs:familytree/@xmlns:fsapi-v1",'http://api.familysearch.org/v1',@namespaces)
+      end
+
+      it "should serialize elements with a namespace url and prefix" do
+        base_xpath = "/fs:familytree/fs:persons/fs:person[1]"
+        @doc.should have_nodes("#{base_xpath}/fsapi-v1:information",1,@namespaces)
+        @doc.should have_nodes("#{base_xpath}/fsapi-v1:information/fsapi-v1:alternateIds",1,@namespaces)
+        @doc.should have_nodes("#{base_xpath}/fsapi-v1:information/fsapi-v1:alternateIds/fsapi-v1:id",8,@namespaces)
+      end
+    end
+    
+  end
+end