nokogiri-happymapper 0.3.3

data/History

@@ -0,0 +1,59 @@
+== 0.2.5
+* 1 minor tweak
+  * Classes can now be strings instead of constants so you don't have to worry about class definition order (this was all for technicalpickles, enjoy!)
+  
+== 0.2.4
+* 1 minor tweak
+  * Added a patch that allows even crazy namespaces to work
+  
+== 0.2.3
+* 1 minor tweak
+  * bumped the version of libxml-ruby to 1.1.3
+  
+== 0.2.2
+* 2 minor tweaks
+  * removed GC.start (libxml recommended this) as setting nodes to nil should be enough, specs run 3-4x faster (Brandon Keepers)
+  * renamed get_tag_name to tag_name (Brandon Keepers)
+  * removed libxml helpers as they are no longer needed
+  
+== 0.2.1
+* 1 minor fix, 3 major enhancements
+  * fixed warnings about using XML::Parser (mojodna)
+  * Improved namespace support, now handles multiple namespaces and allows namespaces to be set item wide or on a per element basis (mojodna)
+  * Auto detect root nodes (mojodna)
+  * Type coercion (mojodna)
+  
+== 0.2.0
+* 1 major enhancement, 2 minor ehancements
+  * Automatic handling of namespaces (part by Robert Lowrey and rest by John Nunemaker)
+  * Added :root option to tag method. This allows setting an object as the root element, which sets xpath to use / and sets single to true
+  * Now defaulting tag names for classes in modules to last constant downcased
+  
+== 0.1.7 2009-01-29
+* 1 minor enhancement
+  * Support dashes in elements (Josh Nichols)
+  
+== 0.1.6 2009-01-17
+* 1 minor enhancement:
+  * added support for nested collection elements (Justin Marney)
+
+== 0.1.5 2009-01-05
+* 1 major enhancement:
+  * Updated to latest version of libxml-ruby (lightningdb)
+  
+== 0.1.4 2009-01-05
+* 1 major enhancement:
+  * Fixed parsing when the object is the root node. (Garret Alfert)
+
+== 0.1.3 2008-12-31
+* 1 major enhancement:
+  * Added parsing of attributes of elements that are also mapped, see current_weather.rb for example (jeremyf)
+
+== 0.1.2 2008-12-12
+* 1 major enhancement:
+  * Fixed that :deep only worked for first item (dvrensk)
+  
+== 0.1.0 2008-11-16
+
+* 1 major enhancement:
+  * Initial release

data/License

@@ -0,0 +1,20 @@
+Copyright (c) 2008 John Nunemaker
+
+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/Manifest

@@ -0,0 +1,45 @@
+History
+License
+Manifest
+README
+Rakefile
+TODO
+examples/amazon.rb
+examples/current_weather.rb
+examples/dashed_elements.rb
+examples/family_tree.rb
+examples/post.rb
+examples/twitter.rb
+lib/happymapper.rb
+lib/happymapper/attribute.rb
+lib/happymapper/element.rb
+lib/happymapper/item.rb
+lib/happymapper/text_node.rb
+lib/happymapper/version.rb
+nokogiri-happymapper.gemspec
+spec/fixtures/address.xml
+spec/fixtures/analytics.xml
+spec/fixtures/commit.xml
+spec/fixtures/current_weather.xml
+spec/fixtures/dictionary.xml
+spec/fixtures/family_tree.xml
+spec/fixtures/lastfm.xml
+spec/fixtures/multiple_namespaces.xml
+spec/fixtures/multiple_primitives.xml
+spec/fixtures/pita.xml
+spec/fixtures/posts.xml
+spec/fixtures/product_default_namespace.xml
+spec/fixtures/product_no_namespace.xml
+spec/fixtures/product_single_namespace.xml
+spec/fixtures/quarters.xml
+spec/fixtures/radar.xml
+spec/fixtures/statuses.xml
+spec/happymapper_attribute_spec.rb
+spec/happymapper_element_spec.rb
+spec/happymapper_item_spec.rb
+spec/happymapper_spec.rb
+spec/happymapper_text_node_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+website/css/common.css
+website/index.html

data/README

@@ -0,0 +1,61 @@
+= happymapper
+
+== DESCRIPTION:
+
+Object to xml mapping library. I have included examples to help get you going. The specs
+should also point you in the right direction.
+
+This is a custom version of HappyMapper, available there:
+http://github.com/dam5s/happymapper/
+
+== FEATURES:
+
+* Easy to define xml attributes and elements for an object
+* Fast because it uses nokogiri under the hood
+* Automatic conversion of xml to defined objects
+* Reusable classes via a node finding mechanism that searches by 1. specified tag,
+2. name of element, 3. class name. (gemspec was upgraded to 0.3.0 for this change)
+
+== EXAMPLES:
+
+Here is a simple example that maps Twitter statuses and users.
+
+  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
+    has_one :user, User
+  end
+
+See examples directory in the gem for more examples.
+
+http://github.com/dam5s/happymapper/tree/master/examples/
+
+== INSTALL:
+
+* sudo gem install nokogiri-happymapper -s http://gemcutter.org
+
+== TICKETS:
+
+http://github.com/dam5s/happymapper/issues/

data/Rakefile

@@ -0,0 +1,28 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+require 'spec/rake/spectask'
+require "lib/happymapper/version"
+
+Echoe.new('nokogiri-happymapper', HappyMapper::Version) do |p|
+  p.description     = "object to xml mapping library, using nokogiri (fork from John Nunemaker's Happymapper)"
+  p.install_message = "May you have many happy mappings!"
+  p.url             = "http://github.com/dam5s/happymapper"
+  p.author          = "Damien Le Berrigaud, John Nunemaker, David Bolton, Roland Swingler"
+  p.email           = "damien@meliondesign.com"
+  p.extra_deps      = ['nokogiri >=1.4.0']
+  p.need_tar_gz     = false
+end
+
+desc 'Preps the gem for a new release'
+task :prepare do
+  %w[manifest build_gemspec].each do |task|
+    Rake::Task[task].invoke
+  end
+end
+
+Rake::Task[:default].prerequisites.clear
+task :default => :spec
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList["spec/**/*_spec.rb"]
+end

data/examples/amazon.rb

@@ -0,0 +1,34 @@
+dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require File.join(dir, 'happymapper')
+
+file_contents = File.read(dir + '/../spec/fixtures/pita.xml')
+
+# The document `pita.xml` contains both a default namespace and the 'georss'
+# namespace (for the 'point' element).
+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, String, :tag => 'DetailPageURL'
+    element :manufacturer, String, :tag => 'Manufacturer', :deep => true
+    # this is the only element that exists in a different namespace, so it
+    # must be explicitly specified
+    element :point, String, :tag => 'point', :namespace => 'georss'
+  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
+
+item = PITA::Items.parse(file_contents, :single => true)
+item.items.each do |i|
+  puts i.asin, i.detail_page_url, i.manufacturer, ''
+end

data/examples/current_weather.rb

@@ -0,0 +1,21 @@
+dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require File.join(dir, 'happymapper')
+
+file_contents = File.read(dir + '/../spec/fixtures/current_weather.xml')
+
+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
+
+CurrentWeather.parse(file_contents).each do |current_weather|
+  puts "temperature: #{current_weather.temperature}"
+  puts "feels_like: #{current_weather.feels_like}"
+  puts "current_condition: #{current_weather.current_condition}"
+  puts "current_condition.icon: #{current_weather.current_condition.icon}"
+end

data/examples/dashed_elements.rb

@@ -0,0 +1,20 @@
+dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require File.join(dir, 'happymapper')
+
+file_contents = File.read(dir + '/../spec/fixtures/commit.xml')
+
+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
+
+commit = GitHub::Commit.parse(file_contents)
+puts commit.committed_date, commit.url, commit.id

data/examples/family_tree.rb

@@ -0,0 +1,48 @@
+dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require File.join(dir, 'happymapper')
+
+file_contents = File.read(dir + '/../spec/fixtures/family_tree.xml')
+
+module FamilySearch
+  class AlternateIds
+    include HappyMapper
+    
+    tag 'alternateIds'
+    has_many :ids, String, :tag => 'id'
+  end
+  
+  class Information
+    include HappyMapper
+    
+    has_one :alternateIds, AlternateIds
+  end
+  
+  class Person
+    include HappyMapper
+    
+    attribute :version, String
+    attribute :modified, Time
+    attribute :id, String
+    has_one :information, Information
+  end
+  
+  class Persons
+    include HappyMapper
+    has_many :person, Person
+  end
+  
+  class FamilyTree
+    include HappyMapper
+    
+    tag 'familytree'
+    attribute :version, String
+    attribute :status_message, String, :tag => 'statusMessage'
+    attribute :status_code, String, :tag => 'statusCode'
+    has_one :persons, Persons
+  end
+end
+
+familytree = FamilySearch::FamilyTree.parse(file_contents)
+familytree.persons.person.each do |p|
+  puts p.id, p.information.alternateIds.ids, ''
+end

data/examples/post.rb

@@ -0,0 +1,19 @@
+dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require File.join(dir, 'happymapper')
+
+file_contents = File.read(dir + '/../spec/fixtures/posts.xml')
+
+class Post
+  include HappyMapper
+  
+  attribute :href, String
+  attribute :hash, String
+  attribute :description, String
+  attribute :tag, String
+  attribute :time, DateTime
+  attribute :others, Integer
+  attribute :extended, String
+end
+
+posts = Post.parse(file_contents)
+posts.each { |post| puts post.description, post.href, post.extended, '' }

data/examples/twitter.rb

@@ -0,0 +1,37 @@
+dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require File.join(dir, 'happymapper')
+
+file_contents = File.read(dir + '/../spec/fixtures/statuses.xml')
+
+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
+	has_one :user, User
+end
+
+statuses = Status.parse(file_contents)
+statuses.each do |status|
+  puts status.user.name, status.user.screen_name, status.text, status.source, ''
+end

data/lib/happymapper.rb

@@ -0,0 +1,157 @@
+dir = File.dirname(__FILE__)
+
+require 'date'
+require 'time'
+require 'rubygems'
+require 'nokogiri'
+
+class Boolean; end
+class XmlContent; end
+
+module HappyMapper
+
+  DEFAULT_NS = "happymapper"
+
+  def self.included(base)
+    base.instance_variable_set("@attributes", {})
+    base.instance_variable_set("@elements", {})
+    base.extend ClassMethods
+  end
+
+  module ClassMethods
+    def attribute(name, type, options={})
+      attribute = Attribute.new(name, type, options)
+      @attributes[to_s] ||= []
+      @attributes[to_s] << attribute
+      attr_accessor attribute.method_name.intern
+    end
+
+    def attributes
+      @attributes[to_s] || []
+    end
+
+    def element(name, type, options={})
+      element = Element.new(name, type, options)
+      @elements[to_s] ||= []
+      @elements[to_s] << element
+      attr_accessor element.method_name.intern
+    end
+
+    def elements
+      @elements[to_s] || []
+    end
+
+    def text_node(name, type, options={})
+      @text_node = TextNode.new(name, type, options)
+      attr_accessor @text_node.method_name.intern
+    end
+
+    def has_xml_content
+      attr_accessor :xml_content
+    end
+    
+    def has_one(name, type, options={})
+      element name, type, {:single => true}.merge(options)
+    end
+
+    def has_many(name, type, options={})
+      element name, type, {:single => false}.merge(options)
+    end
+
+    # Specify a namespace if a node and all its children are all namespaced
+    # elements. This is simpler than passing the :namespace option to each
+    # defined element.
+    def namespace(namespace = nil)
+      @namespace = namespace if namespace
+      @namespace
+    end
+
+    def tag(new_tag_name)
+      @tag_name = new_tag_name.to_s unless new_tag_name.nil? || new_tag_name.to_s.empty?
+    end
+
+    def tag_name
+      @tag_name ||= to_s.split('::')[-1].downcase
+    end
+
+    def parse(xml, options = {})
+      # locally scoped copy of namespace for this parse run
+      namespace = @namespace
+
+      if xml.is_a?(Nokogiri::XML::Node)
+        node = xml
+      else
+        if xml.is_a?(Nokogiri::XML::Document)
+          node = xml.root
+        else
+          xml = Nokogiri::XML(xml)
+          node = xml.root
+        end
+
+        root = node.name == tag_name
+      end
+
+      # This is the entry point into the parsing pipeline, so the default
+      # namespace prefix registered here will propagate down
+      namespaces = options[:namespaces] || xml.namespaces
+      if namespaces.has_key?("xmlns")
+        namespace ||= DEFAULT_NS
+        namespaces[namespace] = namespaces.delete("xmlns")
+      elsif namespaces.has_key?(DEFAULT_NS)
+        namespace ||= DEFAULT_NS
+      end
+
+      xpath = root ? '/' : './/'
+      xpath += "#{namespace}:" if namespace
+      #puts "parse: #{xpath}"
+
+      nodes = []
+      # when finding nodes, do it in this order:
+      # 1. specified tag
+      # 2. name of element
+      # 3. tag_name (derived from class name by default)
+      [options[:tag], options[:name], tag_name].compact.each do |xpath_ext|
+        nodes = node.xpath(xpath + xpath_ext.to_s, namespaces)
+        break if nodes && nodes.size > 0
+      end
+
+      collection = nodes.collect do |n|
+        obj = new
+
+        attributes.each do |attr|
+          obj.send("#{attr.method_name}=",
+                    attr.from_xml_node(n, namespace, namespaces))
+        end
+
+        elements.each do |elem|
+          obj.send("#{elem.method_name}=", 
+                    elem.from_xml_node(n, namespace, namespaces))
+        end
+
+        obj.send("#{@text_node.method_name}=", 
+                  @text_node.from_xml_node(n, namespace, namespaces)) if @text_node
+
+        if obj.respond_to?('xml_content=')
+          n = n.children if n.respond_to?(:children)
+          obj.xml_content = n.to_xml 
+        end
+        
+        obj
+      end
+
+      # per http://libxml.rubyforge.org/rdoc/classes/LibXML/XML/Document.html#M000354
+      nodes = nil
+
+      if options[:single] || root
+        collection.first
+      else
+        collection
+      end
+    end
+  end
+end
+
+require File.join(dir, 'happymapper/item')
+require File.join(dir, 'happymapper/attribute')
+require File.join(dir, 'happymapper/element')
+require File.join(dir, 'happymapper/text_node')