xml_node_stream 1.0.0 → 2.0.0

data/xml_node_stream.gemspec

@@ -1,68 +1,39 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
-# -*- encoding: utf-8 -*-
+Gem::Specification.new do |spec|
+  spec.name = "xml_node_stream"
+  spec.version = File.read(File.expand_path("../VERSION", __FILE__)).strip
+  spec.authors = ["Brian Durand"]
+  spec.email = ["bbdurand@gmail.com"]
 
-Gem::Specification.new do |s|
-  s.name = %q{xml_node_stream}
-  s.version = "1.0.0"
+  spec.summary = "Memory-efficient XML parser that reduces memory allocation when parsing large XML documents while maintaining a simple, easy-to-use interface."
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Brian Durand"]
-  s.date = %q{2010-02-07}
-  s.email = %q{brian@embellishedvisions.com}
-  s.extra_rdoc_files = [
-    "README.rdoc"
-  ]
-  s.files = [
-    "MIT_LICENSE",
-     "README.rdoc",
-     "Rakefile",
-     "VERSION",
-     "init.rb",
-     "lib/xml_node_stream.rb",
-     "lib/xml_node_stream/node.rb",
-     "lib/xml_node_stream/parser.rb",
-     "lib/xml_node_stream/parser/base.rb",
-     "lib/xml_node_stream/parser/libxml_parser.rb",
-     "lib/xml_node_stream/parser/nokogiri_parser.rb",
-     "lib/xml_node_stream/parser/rexml_parser.rb",
-     "lib/xml_node_stream/selector.rb",
-     "spec/node_spec.rb",
-     "spec/parser_spec.rb",
-     "spec/selector_spec.rb",
-     "spec/spec_helper.rb",
-     "spec/test.xml",
-     "spec/xml_node_stream_spec.rb",
-     "xml_node_stream.gemspec"
-  ]
-  s.homepage = %q{http://github.com/bdurand/xml_node_stream}
-  s.rdoc_options = ["--charset=UTF-8"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.5}
-  s.summary = %q{Simple XML parser wrapper that provides the benefits of stream parsing with the ease of using document nodes.}
-  s.test_files = [
-    "spec/node_spec.rb",
-     "spec/parser_spec.rb",
-     "spec/selector_spec.rb",
-     "spec/spec_helper.rb",
-     "spec/xml_node_stream_spec.rb"
-  ]
+  spec.homepage = "https://github.com/bdurand/xml_node_stream"
+  spec.license = "MIT"
 
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
+  spec.metadata = {
+    "homepage_uri" => spec.homepage,
+    "source_code_uri" => spec.homepage,
+    "changelog_uri" => "#{spec.homepage}/blob/main/CHANGELOG.md"
+  }
 
-    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
-      s.add_development_dependency(%q<jeweler>, [">= 0"])
-    else
-      s.add_dependency(%q<rspec>, [">= 1.2.9"])
-      s.add_dependency(%q<jeweler>, [">= 0"])
-    end
-  else
-    s.add_dependency(%q<rspec>, [">= 1.2.9"])
-    s.add_dependency(%q<jeweler>, [">= 0"])
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  ignore_files = %w[
+    .
+    AGENTS.md
+    Appraisals
+    Gemfile
+    Gemfile.lock
+    Rakefile
+    bin/
+    gemfiles/
+    spec/
+    benchmark/
+  ]
+  spec.files = Dir.chdir(File.expand_path("..", __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| ignore_files.any? { |path| f.start_with?(path) } }
   end
-end
 
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler"
+end

metadata

@@ -1,52 +1,40 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: xml_node_stream
-version: !ruby/object:Gem::Version 
-  version: 1.0.0
+version: !ruby/object:Gem::Version
+  version: 2.0.0
 platform: ruby
-authors: 
+authors:
 - Brian Durand
-autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2010-02-07 00:00:00 -06:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: rspec
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.2.9
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: jeweler
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
-    version: 
-description: 
-email: brian@embellishedvisions.com
+      - !ruby/object:Gem::Version
+        version: '0'
+email:
+- bbdurand@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
-- README.rdoc
-files: 
-- MIT_LICENSE
-- README.rdoc
-- Rakefile
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- MIT-LICENSE
+- README.md
 - VERSION
-- init.rb
 - lib/xml_node_stream.rb
+- lib/xml_node_stream/http_stream.rb
 - lib/xml_node_stream/node.rb
 - lib/xml_node_stream/parser.rb
 - lib/xml_node_stream/parser/base.rb
@@ -54,44 +42,30 @@ files:
 - lib/xml_node_stream/parser/nokogiri_parser.rb
 - lib/xml_node_stream/parser/rexml_parser.rb
 - lib/xml_node_stream/selector.rb
-- spec/node_spec.rb
-- spec/parser_spec.rb
-- spec/selector_spec.rb
-- spec/spec_helper.rb
-- spec/test.xml
-- spec/xml_node_stream_spec.rb
 - xml_node_stream.gemspec
-has_rdoc: true
-homepage: http://github.com/bdurand/xml_node_stream
-licenses: []
-
-post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
-require_paths: 
+homepage: https://github.com/bdurand/xml_node_stream
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/bdurand/xml_node_stream
+  source_code_uri: https://github.com/bdurand/xml_node_stream
+  changelog_uri: https://github.com/bdurand/xml_node_stream/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
+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'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: 
-rubygems_version: 1.3.5
-signing_key: 
-specification_version: 3
-summary: Simple XML parser wrapper that provides the benefits of stream parsing with the ease of using document nodes.
-test_files: 
-- spec/node_spec.rb
-- spec/parser_spec.rb
-- spec/selector_spec.rb
-- spec/spec_helper.rb
-- spec/xml_node_stream_spec.rb
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Memory-efficient XML parser that reduces memory allocation when parsing large
+  XML documents while maintaining a simple, easy-to-use interface.
+test_files: []

data/README.rdoc

@@ -1,61 +0,0 @@
-= XML Node Stream
-
-This gem provides a very easy to use XML parser the provides the benefits of both stream parsing (i.e. SAX) and document parsing (i.e. DOM). In addition, it provides a unified parsing language for each of the major Ruby XML parsers (REXML, Nokogiri, and LibXML) so that your code doesn't have to be bound to a particular XML library.
-
-== Stream Parsing
-
-The primary purpose of this gem is to facilitate parsing large XML files (i.e. several megabytes in size). Often, reading these files into a document structure is not feasible because the whole document must be read into memory. Stream/SAX parsing solves this issue by reading in the file incrementally and providing callbacks for various events. This method can be quite painful to deal with for any sort of complex document structure.
-
-This gem attempts to solve both of these issues by combining the best features of both. Parsing is performed by a stream parser which construct document style nodes and calls back to the application code with these nodes. When your application is done with a node, it can release it to free up memory and keep your heap from bloating.
-
-In order to keep the interface simple and universal, only XML elements and text nodes are supported. XML processing instructions and comments will be ignored.
-
-== Examples
-
-Suppose we have file with every book in the world in it:
-
-  <books>
-    <book isbn="123456">
-      <title>Moby Dick</title>
-      <author>Herman Melville</author>
-      <categories>
-        <category>Fiction</category>
-        <category>Adventure</category>
-      </categories>
-    </book>
-    <book isbn="98765643">
-      <title>The Decline and Fall of the Roman Empire</title>
-      <author>Edward Gibbon</author>
-      <category>
-        <category>History</category>
-        <category>Ancient</category>
-      </categories>
-    </book>
-    ...
-  </books>
-
-And we want to get them into our Books data model:
-
-  XmlNodeStream.parse('/tmp/books.xml') do |node|
-    if node.path == '/books/book'
-      book = Book.new
-      book.isbn = node['isbn']
-      book.title = node.find('title').value
-      book.author = node.find('author/text()')
-      book.categories = node.select('categories/category/text()')
-      book.save
-      node.release!
-    end
-  end
-
-== Releasing Nodes
-
-In the above example, what prevents memory bloat when parsing a large document is the call to node.release!. This call will remove the node from the node tree. The general practice is to look for the higher level nodes you are interested in and then release them immediately. If there are nodes you don't care about at all, those can be released immediately as well.
-
-A sample 77Mb XML document parsed into Nokogiri consumes over 800Mb of memory. Parsing the same document with XmlNodeStream and releasing top level nodes as they're processed uses less than 1Mb.
-
-== XPath
-
-You can use a subset of the XPath language to navigate nodes. The only parts of XPath implemented are the paths themselves and the text() function. The text() function is useful for getting the value of node directly from the find or select methods without having to do a nil check on the nodes. For instance, in the above example we can get the name of an author with node.find('author/text()') instead of node.find('author').value if node.find('author').
-
-The rest of the XPath language is not implemented since it is a programming language and there is really no need for it since we already have Ruby at our disposal which is far more powerful than XPath. See the Selector class for details.

data/Rakefile

@@ -1,42 +0,0 @@
-require 'rubygems'
-require 'rake'
-require 'rake/rdoctask'
-
-desc 'Default: run unit tests.'
-task :default => :test
-
-begin
-  require 'spec/rake/spectask'
-  desc 'Test xml_node_stream.'
-  Spec::Rake::SpecTask.new(:test) do |t|
-    t.spec_files = 'spec/**/*_spec.rb'
-  end
-rescue LoadError
-  tast :test do
-    STDERR.puts "You must have rspec >= 1.2.9 to run the tests"
-  end
-end
-
-desc 'Generate documentation for xml_node_stream.'
-Rake::RDocTask.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.options << '--title' << 'XML Node Stream' << '--line-numbers' << '--inline-source' << '--main' << 'README.rdoc'
-  rdoc.rdoc_files.include('README.rdoc')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
-
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gem|
-    gem.name = "xml_node_stream"
-    gem.summary = %Q{Simple XML parser wrapper that provides the benefits of stream parsing with the ease of using document nodes.}
-    gem.email = "brian@embellishedvisions.com"
-    gem.homepage = "http://github.com/bdurand/xml_node_stream"
-    gem.authors = ["Brian Durand"]
-    gem.add_development_dependency('rspec', '>= 1.2.9')
-    gem.add_development_dependency('jeweler')
-  end
-
-  Jeweler::GemcutterTasks.new
-rescue LoadError
-end

data/init.rb

@@ -1 +0,0 @@
-require "#{File.dirname(__FILE__)}/lib/xml_node_stream"

data/spec/node_spec.rb

@@ -1,140 +0,0 @@
-require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
-
-describe XmlNodeStream::Node do
-  
-  it "should have a name" do
-    node = XmlNodeStream::Node.new("tag")
-    node.name.should == "tag"
-  end
-  
-  it "should have attributes" do
-    node = XmlNodeStream::Node.new("tag")
-    node.attributes.should == {}
-    node["attr1"].should == nil
-    node = XmlNodeStream::Node.new("tag", nil, "attr1" => "val1", "attr2" => "val2")
-    node.attributes.should == {"attr1" => "val1", "attr2" => "val2"}
-    node["attr1"].should == "val1"
-  end
-  
-  it "should have a value" do
-    node = XmlNodeStream::Node.new("tag")
-    node.value.should == nil
-    node = XmlNodeStream::Node.new("tag", nil, nil, "value")
-    node.value.should == "value"
-  end
-  
-  it "should have a parent and children" do
-    parent = XmlNodeStream::Node.new("tag")
-    parent.parent.should == nil
-    parent.children.should == []
-    child_1 = XmlNodeStream::Node.new("child", parent)
-    child_2 = XmlNodeStream::Node.new("child")
-    parent.add_child(child_2)
-    parent.children.should == [child_1, child_2]
-    child_1.parent.should == parent
-    child_2.parent.should == parent
-  end
-  
-  it "should be able to remove children" do
-    parent = XmlNodeStream::Node.new("tag")
-    child_1 = XmlNodeStream::Node.new("child", parent)
-    child_2 = XmlNodeStream::Node.new("child", parent)
-    parent.children.should == [child_1, child_2]
-    parent.remove_child(child_1)
-    parent.children.should == [child_2]
-    child_1.parent.should == nil
-  end
-  
-  it "should release itself from its parent" do
-    parent = XmlNodeStream::Node.new("tag")
-    child_1 = XmlNodeStream::Node.new("child", parent)
-    child_2 = XmlNodeStream::Node.new("child", parent)
-    parent.children.should == [child_1, child_2]
-    child_1.release!
-    parent.children.should == [child_2]
-    child_1.parent.should == nil
-  end
-  
-  it "should have ancestors" do
-    parent = XmlNodeStream::Node.new("tag")
-    child = XmlNodeStream::Node.new("child", parent)
-    grandchild = XmlNodeStream::Node.new("grandchild", child)
-    parent.ancestors.should == []
-    child.ancestors.should == [parent]
-    grandchild.ancestors.should == [child, parent]
-  end
-  
-  it "should have descendants" do
-    parent = XmlNodeStream::Node.new("tag")
-    child_1 = XmlNodeStream::Node.new("child", parent)
-    child_2 = XmlNodeStream::Node.new("child", parent)
-    grandchild_1 = XmlNodeStream::Node.new("grandchild", child_1)
-    grandchild_2 = XmlNodeStream::Node.new("grandchild", child_1)
-    parent.descendants.should == [child_1, child_2, grandchild_1, grandchild_2]
-    child_1.descendants.should == [grandchild_1, grandchild_2]
-    grandchild_1.descendants.should == []
-  end
-  
-  it "should have a root node" do
-    parent = XmlNodeStream::Node.new("tag")
-    child = XmlNodeStream::Node.new("child", parent)
-    grandchild = XmlNodeStream::Node.new("grandchild", child)
-    parent.root.should == parent
-    child.root.should == parent
-    grandchild.root.should == parent
-  end
-  
-  it "should have a path" do
-    parent = XmlNodeStream::Node.new("tag")
-    child = XmlNodeStream::Node.new("child", parent)
-    grandchild = XmlNodeStream::Node.new("grandchild", child)
-    parent.path.should == "/tag"
-    child.path.should == "/tag/child"
-    grandchild.path.should == "/tag/child/grandchild"
-  end
-  
-  it "should be able to select related nodes using a selector" do
-    parent = XmlNodeStream::Node.new("tag")
-    child_1 = XmlNodeStream::Node.new("child", parent)
-    child_2 = XmlNodeStream::Node.new("child", parent)
-    grandchild_1 = XmlNodeStream::Node.new("grandchild", child_1, nil, "val1")
-    grandchild_2 = XmlNodeStream::Node.new("grandchild", child_1, nil, "val2")
-    parent.select("nothing").should == []
-    parent.select("child").should == [child_1, child_2]
-    parent.select("child/grandchild").should == [grandchild_1, grandchild_2]
-    parent.select("child/grandchild/text()").should == ["val1", "val2"]
-    grandchild_1.select("../..").should == [parent]
-  end
-  
-  it "should be able to find the first related node using a selector" do
-    parent = XmlNodeStream::Node.new("tag")
-    child_1 = XmlNodeStream::Node.new("child", parent)
-    child_2 = XmlNodeStream::Node.new("child", parent)
-    grandchild_1 = XmlNodeStream::Node.new("grandchild", child_1, nil, "val1")
-    grandchild_2 = XmlNodeStream::Node.new("grandchild", child_1, nil, "val2")
-    parent.find("nothing").should == nil
-    parent.find("child").should == child_1
-    parent.find("child/grandchild").should == grandchild_1
-    parent.find("child/grandchild/text()").should == "val1"
-    grandchild_1.find("../..").should == parent
-  end
-  
-  it "should append text which strips whitespace from the start and end of the value" do
-    node = XmlNodeStream::Node.new("tag")
-    node.append("   ")
-    node.append(" \t\r\nhello ")
-    node.append(" there\n")
-    node.finish!
-    node.value.should == "hello  there"
-  end
-  
-  it "should append cdata which preserves all whitespace" do
-    node = XmlNodeStream::Node.new("tag")
-    node.append_cdata("   ")
-    node.append(" \t\r\nhello ")
-    node.append_cdata(" there\n")
-    node.finish!
-    node.value.should == "    \t\r\nhello  there\n"
-  end
-  
-end

data/spec/parser_spec.rb

@@ -1,148 +0,0 @@
-require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
-
-describe XmlNodeStream::Parser do
-  
-  before :each do
-    @text_xml_path = File.expand_path(File.join(File.dirname(__FILE__), 'test.xml'))
-  end
-  
-  it "should parse a document in a string" do
-    validate_text_xml(XmlNodeStream::Parser.parse(File.read(@text_xml_path)))
-  end
-  
-  it "should parse a document in a file path string" do
-    validate_text_xml(XmlNodeStream::Parser.parse(@text_xml_path))
-  end
-  
-  it "should parse a document in a file path" do
-    validate_text_xml(XmlNodeStream::Parser.parse(Pathname.new(@text_xml_path)))
-  end
-  
-  it "should parse a document in a url string" do
-    uri = URI.parse("http://test.host/test.xml")
-    URI.should_receive(:parse).with("http://test.host/test.xml").and_return(uri)
-    File.open(@text_xml_path) do |stream|
-      uri.should_receive(:open).and_return(stream)
-      validate_text_xml(XmlNodeStream::Parser.parse("http://test.host/test.xml"))
-    end
-  end
-  
-  it "should parse a document in a URI" do
-    uri = URI.parse("http://test.host/test.xml")
-    stream = mock(:stream)
-    File.open(@text_xml_path) do |stream|
-      uri.should_receive(:open).and_return(stream)
-      validate_text_xml(XmlNodeStream::Parser.parse(uri))
-    end
-  end
-  
-  it "should parse a document in a stream" do
-    io = StringIO.new(File.read(@text_xml_path))
-    io.should_not_receive(:close)
-    validate_text_xml(XmlNodeStream::Parser.parse(io))
-  end
-  
-  it "should call a block with each element in a document" do
-    nodes = []
-    XmlNodeStream::Parser.parse(@text_xml_path) do |node|
-      nodes << node.path
-    end
-    nodes.should == %w(
-      /library/authors/author/name
-      /library/authors/author
-      /library/authors/author/name
-      /library/authors/author
-      /library/authors/author/name
-      /library/authors/author
-      /library/authors
-      /library/collection/section/book/title
-      /library/collection/section/book/author
-      /library/collection/section/book/abstract
-      /library/collection/section/book/volumes
-      /library/collection/section/book
-      /library/collection/section
-      /library/collection/section/book/title
-      /library/collection/section/book/author
-      /library/collection/section/book/abstract
-      /library/collection/section/book
-      /library/collection/section/book/title
-      /library/collection/section/book/author
-      /library/collection/section/book/abstract
-      /library/collection/section/book
-      /library/collection/section/book/title
-      /library/collection/section/book/alternate_title
-      /library/collection/section/book/author
-      /library/collection/section/book/abstract
-      /library/collection/section/book
-      /library/collection/section
-      /library/collection
-      /library
-    )
-  end
-  
-  XmlNodeStream::Parser::SUPPORTED_PARSERS.each do |parser_name|
-    context "with #{parser_name}" do
-      before :all do
-        @save_parser_name = XmlNodeStream::Parser.parser_name
-        XmlNodeStream::Parser.parser_name = parser_name
-      end
-      
-      after :all do
-        XmlNodeStream::Parser.parser_name = @save_parser_name
-      end
-      
-      it "should parse a document" do
-        begin
-          validate_text_xml(XmlNodeStream::Parser.parse(@text_xml_path))
-        rescue NotImplementedError
-          pending("#{parser_name} is not installed for testing")
-        end
-      end
-    end
-  end
-  
-  def validate_text_xml (root)
-    validate(root, :name => "library", :children => ["authors", "collection"])
-    
-    validate(root.children[0], :name => "authors", :children => ["author"] * 3)
-    validate(root.children[0].children[0], :name => "author", :attributes => {"id" => "1"}, :children => ["name"])
-    validate(root.children[0].children[0].children[0], :name => "name", :value => "Edward Gibbon")
-    validate(root.children[0].children[1], :name => "author", :attributes => {"id" => "2"}, :children => ["name"])
-    validate(root.children[0].children[1].children[0], :name => "name", :value => "Herman Melville")
-    validate(root.children[0].children[2], :name => "author", :attributes => {"id" => "3"}, :children => ["name"])
-    validate(root.children[0].children[2].children[0], :name => "name", :value => "Jack London")
-    
-    validate(root.children[1], :name => "collection", :children => ["section"] * 2)
-    history = root.children[1].children[0]
-    fiction = root.children[1].children[1]
-    
-    validate(history, :name => "section", :attributes => {"id" => "100", "name" => "History"}, :children => ["book"])
-    validate(history.children[0], :name => "book", :attributes => {"id" => "1"}, :children => ["title", "author", "abstract", "volumes"])
-    validate(history.children[0].children[0], :name => "title", :value => "The Decline & Fall of the Roman Empire")
-    validate(history.children[0].children[1], :name => "author", :value => nil, :attributes => {"id" => "1"})
-    validate(history.children[0].children[2], :name => "abstract", :value => "History of the fall of Rome.")
-    validate(history.children[0].children[3], :name => "volumes", :value => "6")
-    
-    validate(fiction, :name => "section", :attributes => {"id" => "200", "name" => "Fiction"}, :children => ["book"] * 3)
-    validate(fiction.children[0], :name => "book", :attributes => {"id" => "2"}, :children => ["title", "author", "abstract"])
-    validate(fiction.children[0].children[0], :name => "title", :value => "Call of the Wild")
-    validate(fiction.children[0].children[1], :name => "author", :value => nil, :attributes => {"id" => "3"})
-    validate(fiction.children[0].children[2], :name => "abstract", :value => "\n          A dog goes to Alaska.\n        ")
-    validate(fiction.children[1], :name => "book", :attributes => {"id" => "3"}, :children => ["title", "author", "abstract"])
-    validate(fiction.children[1].children[0], :name => "title", :value => "White Fang")
-    validate(fiction.children[1].children[1], :name => "author", :value => nil, :attributes => {"id" => "3"})
-    validate(fiction.children[1].children[2], :name => "abstract", :value => "Dogs, wolves, etc.")
-    validate(fiction.children[2], :name => "book", :attributes => {"id" => "4"}, :children => ["title", "alternate_title", "author", "abstract"])
-    validate(fiction.children[2].children[0], :name => "title", :value => "Moby Dick")
-    validate(fiction.children[2].children[1], :name => "alternate_title", :value => "The Whale")
-    validate(fiction.children[2].children[2], :name => "author", :value => nil, :attributes => {"id" => "2"})
-    validate(fiction.children[2].children[3], :name => "abstract", :value => "A mad captain seeks a mysterious white whale.")
-  end
-  
-  def validate (node, options)
-    node.name.should == options[:name]
-    node.attributes.should == (options[:attributes] || {})
-    node.value.should == (options.include?(:value) ? options[:value] : "")
-    node.children.collect{|c| c.name}.should == (options[:children] || [])
-  end
-end