jexml 0.1.0-jruby

data/History.txt

@@ -0,0 +1,4 @@
+=== 0.1.0 2010-02-01
+
+* Initial release, extracted from code developed for another project.
+* Represents the functionality required for this project; later releases with flesh out to cover additional JDK functionality as required.

data/Manifest.txt

@@ -0,0 +1,28 @@
+History.txt
+Manifest.txt
+README.rdoc
+Rakefile
+lib/core_ext/blank.rb
+lib/jdom.LICENSE.txt
+lib/jdom.jar
+lib/jexml.rb
+lib/jexml/document.rb
+lib/jexml/element.rb
+lib/jexml/node.rb
+script/console
+script/destroy
+script/generate
+tasks/jruby.rake
+test/mydoc.xml
+test/mydoc_unformatted.xml
+test/mydoc_updated_item.xml
+test/test_format.rb
+test/test_helper.rb
+test/test_new_doc_file.rb
+test/test_new_doc_string.rb
+test/test_query_item_names.rb
+test/test_query_item_stock_number.rb
+test/test_query_item_upcs.rb
+test/test_query_sections.rb
+test/test_update_change_item.rb
+test/test_validate_bad_xml.rb

data/README.rdoc

@@ -0,0 +1,108 @@
+= jexml
+
+* http://github.com/gboersma/jexml
+
+== Description
+
+JEXML is a JRuby gem that provides a thin Ruby wrapper around the XML APIs in the JDK.
+
+== Features
+
+* Most compelling feature is the JDK support for XML document validation.
+* Full XPath support.
+* Supports parsing and updating XML documents.
+* Currently only DOM support; SAX support not yet implemented.
+* 3 to 5 times better performance than REXML under JRuby.
+* Uses JDOM to properly format a document, due to bug in JDK.
+
+The implementation approach is to keep the Ruby classes as thin as possible. Currently, it
+represents what was required for a specific project; the interface will get fleshed out
+to more completely cover JDK functionality in later releases.
+
+Check out Nick Sieger's JREXML gem at http://github.com/nicksieger/jrexml/
+for a different approach for improving REXML performance under JRuby.
+This is a better way to go if you want to maintain REXML compatibility
+and do not need XML document validation.
+
+== Synopsis
+
+Create a new JEXML::Document object, either from a File:
+
+  file = File.new("mydoc.xml")
+  doc = JEXML::Document.new file
+
+or a String:
+
+  str = File.new("mydoc.xml").read
+  doc = JEXML::Document.new str
+
+Use the methods on Document and XPath expressions to access nodes within the document:
+
+  doc.nodes("//inventory/section").each do |node|
+    puts "Found section #{node.name}..."
+  end
+
+To validate the XML (i.e. against the DTD):
+
+  str = File.new("mydoc.xml").read
+  doc = JEXML::Document.validate(str)
+
+To generate formatted XML as a String for a document:
+
+  doc.format
+
+which only accepts a boolean parameter to indicate if the XML declaration should be omitted.
+
+There are also methods for updating a document and nodes within a document. Check out the rdocs.
+
+== Requirements
+
+JRuby / Java. Tested on JRuby 1.4.0 using Java 1.6.0_17 under Mac OS/X.
+
+This product includes software developed by the JDOM Project (http://www.jdom.org/).
+The JDOM 1.1.1 library is included as part of the gem.
+
+Includes software developed by the ActiveSupport Project (http://as.rubyonrails.org/). MIT license.
+The core_ext/blank.rb is included as part of the gem (unmodified from ActiveSupport 2.2.2).
+
+== Install
+
+Install the gem under JRuby:
+
+    jruby -S gem install jexml
+
+And require 'jexml'.
+
+    gem 'jexml'
+    require 'jexml'
+
+== Source
+
+You can get the JEXML source using Git:
+
+    git clone git://github.com/gboersma/jexml.git
+
+== License
+
+(The MIT License)
+
+Copyright (c) 2010 Gerald Boersma (gerald.boersma@gmail.com)
+
+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/Rakefile

@@ -0,0 +1,28 @@
+require 'rubygems'
+gem 'hoe', '>= 2.1.0'
+require 'hoe'
+require 'fileutils'
+require './lib/jexml'
+
+Hoe.plugin :newgem
+# Hoe.plugin :website
+# Hoe.plugin :cucumberfeatures
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.spec 'jexml' do
+  self.developer 'Gerald Boersma', 'gerald.boersma@gmail.com'
+  self.post_install_message = 'PostInstall.txt' # TODO remove if post-install message not required
+  self.rubyforge_name       = self.name # TODO this is default value
+  # self.extra_deps         = [['activesupport','>= 2.0.2']]
+
+  self.spec_extras['platform'] = 'jruby' # JRuby gem created, e.g. jexml-X.Y.Z-jruby.gem
+
+end
+
+require 'newgem/tasks'
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# remove_task :default
+# task :default => [:spec, :features]

data/lib/core_ext/blank.rb

@@ -0,0 +1,58 @@
+class Object
+  # An object is blank if it's false, empty, or a whitespace string.
+  # For example, "", "   ", +nil+, [], and {} are blank.
+  #
+  # This simplifies
+  #
+  #   if !address.nil? && !address.empty?
+  #
+  # to
+  #
+  #   if !address.blank?
+  def blank?
+    respond_to?(:empty?) ? empty? : !self
+  end
+    
+  # An object is present if it's not blank.
+  def present?
+    !blank?
+  end
+end
+
+class NilClass #:nodoc:
+  def blank?
+    true
+  end
+end
+
+class FalseClass #:nodoc:
+  def blank?
+    true
+  end
+end
+
+class TrueClass #:nodoc:
+  def blank?
+    false
+  end
+end
+
+class Array #:nodoc:
+  alias_method :blank?, :empty?
+end
+
+class Hash #:nodoc:
+  alias_method :blank?, :empty?
+end
+
+class String #:nodoc:
+  def blank?
+    self !~ /\S/
+  end
+end
+
+class Numeric #:nodoc:
+  def blank?
+    false
+  end
+end

data/lib/jdom.LICENSE.txt

@@ -0,0 +1,56 @@
+/*-- 
+
+ $Id: LICENSE.txt,v 1.11 2004/02/06 09:32:57 jhunter Exp $
+
+ Copyright (C) 2000-2004 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+ 
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 
+ 1. Redistributions of source code must retain the above copyright
+    notice, this list of conditions, and the following disclaimer.
+ 
+ 2. Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions, and the disclaimer that follows 
+    these conditions in the documentation and/or other materials 
+    provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+    derived from this software without prior written permission.  For
+    written permission, please contact <request_AT_jdom_DOT_org>.
+ 
+ 4. Products derived from this software may not be called "JDOM", nor
+    may "JDOM" appear in their name, without prior written permission
+    from the JDOM Project Management <request_AT_jdom_DOT_org>.
+ 
+ In addition, we request (but do not require) that you include in the 
+ end-user documentation provided with the redistribution and/or in the 
+ software itself an acknowledgement equivalent to the following:
+     "This product includes software developed by the
+      JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos 
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED.  IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many 
+ individuals on behalf of the JDOM Project and was originally 
+ created by Jason Hunter <jhunter_AT_jdom_DOT_org> and
+ Brett McLaughlin <brett_AT_jdom_DOT_org>.  For more information
+ on the JDOM Project, please see <http://www.jdom.org/>. 
+
+ */
+

data/lib/jexml.rb

@@ -0,0 +1,20 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+module JEXML
+  VERSION = '0.1.0'
+end
+
+# Always need Java.
+require 'java'
+
+# We use JDOM for formatting. Java SDK formatting is broken.
+require "jdom.jar"
+
+# Handy extension borrowed from Active Support.
+require 'core_ext/blank'
+
+# JEXML components.
+require 'jexml/node'
+require 'jexml/element'
+require 'jexml/document'

data/lib/jexml/document.rb

@@ -0,0 +1,116 @@
+module JEXML
+  # Wraps an underlying org.w3c.dom.Document (http://java.sun.com/javase/6/docs/api/org/w3c/dom/Document.html).
+  class Document < Node
+    # Create a new Document from either a file or a String containing the XML content.
+    def self.new(source)
+      if source.kind_of?(File)
+        new_from_string(source.read)
+      elsif source.kind_of?(String)
+        new_from_string(source)
+      else
+        super
+      end
+    end
+
+    # Create a new Document from a String containing the XML content.
+    # This uses a non-validating parser.
+    def self.new_from_string(str)
+      is = java.io.ByteArrayInputStream.new(java.lang.String.new(str).getBytes)
+      factory = javax.xml.parsers.DocumentBuilderFactory.newInstance
+      factory.setNamespaceAware(true)
+      builder = factory.newDocumentBuilder
+      doc = builder.parse(is)
+      # Create a new object where the document is the node.
+      Node.create(doc)
+    end
+
+    # Validate the XML in the provided string.
+    # Will raise an exception with the validation error if not valid.
+    # This uses a validating parser.
+    def self.validate(str)
+      is = java.io.ByteArrayInputStream.new(java.lang.String.new(str).getBytes)
+      factory = javax.xml.parsers.DocumentBuilderFactory.newInstance
+      factory.setValidating(true)
+      factory.setNamespaceAware(true)
+      builder = factory.newDocumentBuilder
+      builder.setErrorHandler(MyErrorHandler.new)
+      builder.parse(is)
+    end
+
+    
+    # Initialize the Ruby Document object with the corresponding Java Document object.
+    def initialize(java_node = nil)
+      # If a java_node is not specified, create a new one.
+      if java_node == nil
+        factory = javax.xml.parsers.DocumentBuilderFactory.newInstance
+        builder = factory.newDocumentBuilder
+        java_node = builder.newDocument
+      end
+
+      # Create the node as normal.
+      super(java_node)
+    end
+
+    # Return the document in nice format (as a String).
+    # Because the Java JDK cannot properly format the XML, we will give it to JDOM and have it do it.
+    # Set the optional parameter omit_xml_decl to false to generate the XML declaration for the document.
+    def format(omit_xml_decl = true)
+      builder = org.jdom.input.DOMBuilder.new
+      doc = builder.build(@java_node)
+      out = org.jdom.output.XMLOutputter.new
+      format = org.jdom.output.Format.getPrettyFormat
+      format.setOmitDeclaration(omit_xml_decl)
+      out.setFormat(format)
+      out.outputString(doc)
+    end
+
+    # Get the root element for this document.
+    def root
+      Node.create(@java_node.getDocumentElement)
+    end
+
+    # Import the specified node into this document.
+    def import_node(src_node)
+      Node.create(@java_node.importNode(src_node.java_node, true))  
+    end
+
+    # Create an element with the specified tag name, attributes, and text content.
+    def create_element(tag_name, attrs = {}, text = nil)
+      element = Node.create(@java_node.createElement(tag_name))
+      if attrs != nil
+        attrs.each do |name, value|
+          element.set_attribute(name.to_s, value.to_s)
+        end
+      end
+      element.text = text if text != nil
+      element
+    end
+
+    # Create a CDATA node with the specified contents.
+    def create_cdata_node(contents)
+      Node.create(@java_node.createCDATASection(contents))
+    end
+
+    # Set the provided element as the root of the document.
+    # This assumes that the element is an element, and that the
+    # document does not yet have any children.
+    def root=(element)
+      @java_node.appendChild(element.java_node)
+    end
+  end
+
+  # Implementation class for catching validation errors.
+  class MyErrorHandler < org.xml.sax.helpers.DefaultHandler
+    def fatalError(e)
+      raise "#{e}"
+    end
+
+    def error(e)
+      raise "#{e}"
+    end
+
+    def warning(e)
+      raise "#{e}"
+    end
+  end
+end

data/lib/jexml/element.rb

@@ -0,0 +1,21 @@
+module JEXML
+  # Wraps an underlying org.w3c.dom.Element (http://java.sun.com/javase/6/docs/api/org/w3c/dom/Element.html).
+  class Element < Node
+    # Get the value of the attribute with the specified name.
+    def attribute(name)
+      value = java_node.getAttribute(name.to_s)
+      # For some reason, the Java SDK returns a blank string if an attribute is not found.
+      # Let's map that back to the more meaningful nil value.
+      if not value.blank?
+        value
+      else
+        nil
+      end
+    end
+
+    # Get the value of the attribute with the specified name.
+    def set_attribute(name, value)
+      java_node.setAttribute(name.to_s, value)
+    end
+  end
+end

data/lib/jexml/node.rb

@@ -0,0 +1,161 @@
+module JEXML
+  # Wraps an underlying org.w3c.dom.Node (http://java.sun.com/javase/6/docs/api/org/w3c/dom/Node.html).
+  # Generic Ruby representation of an underlying Java node, if no special handling provided.
+  class Node
+    # Allow read access to the underlying Java Node object.
+    attr_reader :java_node
+
+    # Instantiate the correct JEXML object depending on the type of the Node object. 
+    def self.create(java_node)
+      # Comparing to the code values rather than the constants in Node can be dangerous.
+      # Possible that the actual values can change. However, unlikely.
+      # Difficult to get to the Interface constants using JRuby.
+      if java_node.getNodeType == 1
+        # Element
+        Element.new(java_node)
+      elsif java_node.getNodeType == 9
+        # Document
+        Document.new(java_node)
+      else
+        # No special handling. Treat as a generic node.
+        Node.new(java_node)
+      end
+    end
+
+    # Initialize the Ruby Node object with the corresponding Java Node object.
+    def initialize(java_node)
+      @java_node = java_node
+      @nodeset_constant = javax.xml.xpath.XPathConstants.java_class.declared_field('NODESET').static_value
+      @xpath_factory = javax.xml.xpath.XPathFactory.newInstance
+    end
+
+    # Search for nodes within the context of this node according to the XPath expression.
+    def nodes(xpath)
+      nodes = []
+      xpath_expr = @xpath_factory.newXPath.compile(xpath)
+      xpath_nodes = xpath_expr.evaluate(@java_node, @nodeset_constant)
+      (0..xpath_nodes.getLength - 1).each do |index|
+        xpath_node = xpath_nodes.item(index)
+        nodes << Node.create(xpath_node)
+      end
+      nodes
+    end
+
+    # Return the first matching node, if any, for the provided XPath expression.
+    def node(xpath)
+      nodes = nodes(xpath)
+      nodes.size > 0 ? nodes[0] : nil
+    end
+
+    # Get all the child nodes of this node.
+    # If a name is specified, only the child nodes with the same name are returned.
+    def child_nodes(name = nil)
+      nodes = []
+      child_nodes = @java_node.getChildNodes
+      (0..child_nodes.getLength - 1).each do |index|
+        child_node = child_nodes.item(index)
+        if name != nil
+          nodes << Node.create(child_node) if child_node.getNodeName == name
+        else
+          nodes << Node.create(child_node)
+        end
+      end
+      nodes
+    end
+
+    # Get the first child node with the specified name.
+    def first_child_node(name = nil)
+      child_nodes = child_nodes(name)
+      child_nodes.size > 0 ? child_nodes[0] : nil
+    end
+
+    # Remove all the child nodes for this node with the specified name.
+    def remove_child_nodes(name)
+      @java_node.getChildNodes.each do |child_node|
+        @java_node.removeChild(child_node) if child_node.getNodeName == name
+      end
+    end
+
+    # Replace the specified node with the new one provided.
+    def replace_child_node(old_node, new_node)
+      @java_node.replaceChild(new_node.java_node, old_node.java_node)
+    end
+
+    # Add the provided node as a child of this node.
+    def add_child_node(node)
+      @java_node.appendChild(node.java_node)
+    end
+
+    # Get the elements of this node according to the provided XPath expression.
+    def elements(xpath)
+      extract_elements(nodes(xpath))
+    end
+
+    # Get the first element of this node according to the provided XPath expression.
+    def element(xpath)
+      elements = elements(xpath)
+      elements.size > 0 ? elements[0] : nil
+    end
+
+    # Get the child elements of this node with the specified name (if provided).
+    def child_elements(name = nil)
+      extract_elements(child_nodes(name))
+    end
+
+    # Get the first child elements of this node with the specified name (if provided).
+    def first_child_element(name = nil)
+      child_elements = child_elements(name)
+      child_elements.size > 0 ? child_elements[0] : nil
+    end
+
+    # Get the name of the node.
+    def name
+      @java_node.getNodeName
+    end
+
+    # Get the value of the node.
+    def value
+      @java_node.getNodeValue  
+    end
+
+    # Get the type code for the node.
+    def type_code
+      @java_node.getNodeType
+    end
+
+    # Get the text content for the node.
+    def text
+      @java_node.getTextContent
+    end
+
+    # Set the text content for the node.
+    def text=(text)
+      @java_node.setTextContent(text)
+    end
+
+    # Normalize the node.
+    def normalize
+      @java_node.normalize
+    end
+
+    # Append the specified node to the children of this node.
+    def <<(node)
+      @java_node.appendChild(node.java_node)
+    end
+
+    # Get the owner document for this node.
+    def document
+      Node.create(@java_node.getOwnerDocument)
+    end
+    
+    private
+
+    def extract_elements(nodes)
+      elements = []
+      nodes.each do |node|
+        elements << node if node.class == JEXML::Element
+      end
+      elements
+    end
+  end
+end

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/jexml.rb'}"
+puts "Loading jexml gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/tasks/jruby.rake

@@ -0,0 +1,7 @@
+if RUBY_PLATFORM =~ /java/
+  require 'java'
+else
+  puts "Java RubyGem only! You are not running within jruby."
+  puts "Try: jruby -S rake #{ARGV.join(' ')}"
+  exit(1)
+end

data/test/mydoc.xml

@@ -0,0 +1,27 @@
+<inventory title="OmniCorp Store #45x10^3">
+  <section name="health">
+    <item upc="123456789" stock="12">
+      <name>Invisibility Cream</name>
+      <price>14.50</price>
+      <description>Makes you invisible</description>
+    </item>
+    <item upc="445322344" stock="18">
+      <name>Levitation Salve</name>
+      <price>23.99</price>
+      <description>Levitate yourself for up to 3 hours per application</description>
+    </item>
+  </section>
+  <section name="food">
+    <item upc="485672034" stock="653">
+      <name>Blork and Freen Instameal</name>
+      <price>4.95</price>
+      <description>A tasty meal in a tablet; just add water</description>
+    </item>
+    <item upc="132957764" stock="44">
+      <name>Grob winglets</name>
+      <price>3.56</price>
+      <description>Tender winglets of Grob. Just add water</description>
+    </item>
+  </section>
+</inventory>
+        

data/test/mydoc_unformatted.xml

@@ -0,0 +1,2 @@
+<inventory title="OmniCorp Store #45x10^3"><section name="health"><item upc="123456789" stock="12"><name>Invisibility Cream</name><price>14.50</price><description>Makes you invisible</description></item><item upc="445322344" stock="18"><name>Levitation Salve</name><price>23.99</price><description>Levitate yourself for up to 3 hours per application</description></item></section><section name="food"><item upc="485672034" stock="653"><name>Blork and Freen Instameal</name><price>4.95</price><description>A tasty meal in a tablet; just add water</description></item><item upc="132957764" stock="44"><name>Grob winglets</name><price>3.56</price><description>Tender winglets of Grob. Just add water</description></item></section></inventory>
+        

data/test/mydoc_updated_item.xml

@@ -0,0 +1,27 @@
+<inventory title="OmniCorp Store #45x10^3">
+  <section name="health">
+    <item upc="123456789" stock="12">
+      <name>Invisibility Cream</name>
+      <price>14.50</price>
+      <description>Makes you invisible</description>
+    </item>
+    <item upc="445322344" stock="18">
+      <name>Levitation Salve</name>
+      <price>23.99</price>
+      <description>Levitate yourself for up to 3 hours per application</description>
+    </item>
+  </section>
+  <section name="food">
+    <item upc="485672034" stock="653">
+      <name>Blork and Freen Instameal</name>
+      <price>4.95</price>
+      <description>A tasty meal in a tablet; just add water</description>
+    </item>
+    <item upc="132957765" stock="45">
+      <name>Grob leglets</name>
+      <price>3.57</price>
+      <description>Tender leglets of Grob. Just add water</description>
+    </item>
+  </section>
+</inventory>
+        

data/test/test_format.rb

@@ -0,0 +1,14 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestFormat < Test::Unit::TestCase
+  def setup
+    file = File.new("test/mydoc_unformatted.xml")
+    @doc = JEXML::Document.new(file)
+  end
+  
+  def test_truth
+    formatted_xml = @doc.format
+    file = File.new("test/mydoc.xml")
+    formatted_xml == file.read
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'stringio'
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/jexml'

data/test/test_new_doc_file.rb

@@ -0,0 +1,12 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestNewDocFile < Test::Unit::TestCase
+  def setup
+    file = File.new("test/mydoc.xml")
+    @doc = JEXML::Document.new(file)
+  end
+  
+  def test_truth
+    @doc != nil and @doc.root.attribute("title") == "OmniCorp Store #45x10^3" 
+  end
+end

data/test/test_new_doc_string.rb

@@ -0,0 +1,12 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestNewDocString < Test::Unit::TestCase
+  def setup
+    file = File.new("test/mydoc.xml")
+    @doc = JEXML::Document.new(file.read)
+  end
+  
+  def test_truth
+    @doc != nil and @doc.root.attribute("title") == "OmniCorp Store #45x10^3"
+  end
+end

data/test/test_query_item_names.rb

@@ -0,0 +1,16 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestQueryItemNames < Test::Unit::TestCase
+  def setup
+    file = File.new("test/mydoc.xml")
+    @doc = JEXML::Document.new(file.read)
+  end
+  
+  def test_truth
+    item_names = @doc.nodes("//inventory/section/item").collect do |node|
+      name_node = node.first_child_node("name")
+      name_node.text
+    end
+    item_names == ["Invisibility Cream", "Levitation Salve", "Blork and Freen Instameal", "Grob winglets"]
+  end
+end

data/test/test_query_item_stock_number.rb

@@ -0,0 +1,24 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestQueryItemStockNumber < Test::Unit::TestCase
+  def setup
+    file = File.new("test/mydoc.xml")
+    @doc = JEXML::Document.new(file.read)
+  end
+  
+  def test_truth
+    item_upcs = @doc.nodes("//inventory/section/item[@stock='44']").collect do |node|
+      node.attribute("upc")
+    end
+    item_upcs += @doc.nodes("//inventory/section/item[@stock='653']").collect do |node|
+      node.attribute("upc")
+    end
+    item_upcs += @doc.nodes("//inventory/section/item[@stock='18']").collect do |node|
+      node.attribute("upc")
+    end
+    item_upcs += @doc.nodes("//inventory/section/item[@stock='12']").collect do |node|
+      node.attribute("upc")
+    end
+    item_upcs == ["123456789", "445322344", "485672034", "132957764"].reverse
+  end
+end

data/test/test_query_item_upcs.rb

@@ -0,0 +1,15 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestQueryItemUpcs < Test::Unit::TestCase
+  def setup
+    file = File.new("test/mydoc.xml")
+    @doc = JEXML::Document.new(file.read)
+  end
+  
+  def test_truth
+    item_upcs = @doc.nodes("//inventory/section/item").collect do |node|
+      node.attribute("upc")
+    end
+    item_upcs == ["123456789", "445322344", "485672034", "132957764"]
+  end
+end

data/test/test_query_sections.rb

@@ -0,0 +1,15 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestQuerySections < Test::Unit::TestCase
+  def setup
+    file = File.new("test/mydoc.xml")
+    @doc = JEXML::Document.new(file.read)
+  end
+  
+  def test_truth
+    sections = @doc.nodes("//inventory/section").collect do |node|
+      node.attribute("name")
+    end
+    sections == ["health", "food"]
+  end
+end

data/test/test_update_change_item.rb

@@ -0,0 +1,21 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestUpdateChangeItem < Test::Unit::TestCase
+  def setup
+    file = File.new("test/mydoc.xml")
+    @doc = JEXML::Document.new(file)
+  end
+  
+  def test_truth
+    item_node = @doc.node("//inventory/section/item[@upc='132957764']")
+    item_node.set_attribute("upc", "132957765")
+    item_node.set_attribute("stock", "45")
+    name_node = item_node.first_child_node("name")
+    name_node.text = "Grob leglets"
+    price_node = item_node.first_child_node("price")
+    price_node.text = "3.57"
+    description_node = item_node.first_child_node("description")
+    description_node.text = "Tender leglets of Grob. Just add water"
+    @doc.format == File.new("test/mydoc_updated_item.xml").read
+  end
+end

data/test/test_validate_bad_xml.rb

@@ -0,0 +1,17 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestValidateBadXml < Test::Unit::TestCase
+  def setup
+  end
+  
+  def test_truth
+    error = false
+    begin
+      xml = "This is bad XML."
+      JEXML::Document.validate(xml)
+    rescue
+      error = true
+    end
+    error
+  end
+end

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification 
+name: jexml
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: jruby
+authors: 
+  - Gerald Boersma
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-03 00:00:00 -08:00
+default_executable: 
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: rubyforge
+    type: :development
+    version_requirement: 
+    version_requirements: !ruby/object:Gem::Requirement 
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: 2.0.3
+      version: 
+  - !ruby/object:Gem::Dependency 
+    name: gemcutter
+    type: :development
+    version_requirement: 
+    version_requirements: !ruby/object:Gem::Requirement 
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: 0.3.0
+      version: 
+  - !ruby/object:Gem::Dependency 
+    name: hoe
+    type: :development
+    version_requirement: 
+    version_requirements: !ruby/object:Gem::Requirement 
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: 2.5.0
+      version: 
+description: JEXML is a JRuby gem that provides a thin Ruby wrapper around the XML APIs in the JDK.
+email: 
+  - gerald.boersma@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+  - History.txt
+  - Manifest.txt
+  - lib/jdom.LICENSE.txt
+files: 
+  - History.txt
+  - Manifest.txt
+  - README.rdoc
+  - Rakefile
+  - lib/core_ext/blank.rb
+  - lib/jdom.LICENSE.txt
+  - lib/jdom.jar
+  - lib/jexml.rb
+  - lib/jexml/document.rb
+  - lib/jexml/element.rb
+  - lib/jexml/node.rb
+  - script/console
+  - script/destroy
+  - script/generate
+  - tasks/jruby.rake
+  - test/mydoc.xml
+  - test/mydoc_unformatted.xml
+  - test/mydoc_updated_item.xml
+  - test/test_format.rb
+  - test/test_helper.rb
+  - test/test_new_doc_file.rb
+  - test/test_new_doc_string.rb
+  - test/test_query_item_names.rb
+  - test/test_query_item_stock_number.rb
+  - test/test_query_item_upcs.rb
+  - test/test_query_sections.rb
+  - test/test_update_change_item.rb
+  - test/test_validate_bad_xml.rb
+has_rdoc: true
+homepage: http://github.com/gboersma/jexml
+licenses: []
+
+post_install_message: PostInstall.txt
+rdoc_options: 
+  - --main
+  - README.rdoc
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: jexml
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: JEXML is a JRuby gem that provides a thin Ruby wrapper around the XML APIs in the JDK.
+test_files: 
+  - test/test_format.rb
+  - test/test_helper.rb
+  - test/test_new_doc_file.rb
+  - test/test_new_doc_string.rb
+  - test/test_query_item_names.rb
+  - test/test_query_item_stock_number.rb
+  - test/test_query_item_upcs.rb
+  - test/test_query_sections.rb
+  - test/test_update_change_item.rb
+  - test/test_validate_bad_xml.rb