libxml-ruby 0.7.0-x86-mswin32-60 → 0.8.0-x86-mswin32-60

data/benchmark/throughput.rb

@@ -0,0 +1,39 @@
+require 'rubygems'
+require 'hpricot'
+require 'libxml'
+require 'rexml/document'
+
+ITERATIONS = 3
+NESTED_ITERATIONS = 5
+
+def bm(name, filename, &block)
+  text = File.open(filename).read
+  length = text.length / 1024.0 / 1024.0
+  puts "#{filename}: #{name} (#{(length * 1024).round} kb)"
+  for j in 0 .. NESTED_ITERATIONS
+    s = Time.now.to_f
+    for i in 0 .. ITERATIONS
+      block.call(text)
+    end
+    timer = Time.now.to_f - s
+    puts "\t#{length * ITERATIONS / timer} MB/s"
+  end
+end
+
+def bm_suite(filenames)
+  filenames.each do |filename|    
+    bm("LIBXML THROUGHPUT:", filename) do |text|
+      XML::Document.file(filename)
+    end
+    
+    bm("HPRICOT THROUGHPUT:", filename) do |text|
+      Hpricot.XML(text)
+    end
+    
+    bm("REXML THROUGHPUT:", filename) do |text|
+      REXML::Document.new(text)
+    end
+  end
+end
+
+bm_suite("hamlet.xml")

data/benchmark/xml_benchmarks.rb

@@ -0,0 +1,222 @@
+# From: https://svn.concord.org/svn/projects/trunk/common/ruby/xml_benchmarks/
+#
+# Each test has an XML Parser open a 98k XML document 
+# and count one type of leaf element (466 entries).
+# This is repeated a total of 50 time sfor each Parser.
+#
+# These results were produced on:
+#   MacBook Pro
+#   2.33 GHz Intel Core 2 Duo
+#   4 GB memory
+# running MacOS X 10.5.2
+#
+# Ruby versions tested:
+#   MRI:   ruby 1.8.6 (2007-09-24 patchlevel 111) [universal-darwin9.0]
+#   JRuby: ruby 1.8.6 (2008-03-20 rev 6255) [i386-jruby1.1RC3] on Java 1.5.0_13
+#   JRuby: ruby 1.8.6 (2008-03-20 rev 6255) [i386-jruby1.1RC3] on Java 1.6.0_03 (Soylatte)
+#
+# Library versions MRI:
+#   libxml-ruby 0.5.2.0
+#   hpricot 0.6
+#
+# Library versions JRuby:
+#   hpricot 0.6.161
+#   jrexml 0.5.3
+#
+# Summary data: 100 iterations, timings from second set
+#
+# Platform and method                             total time
+# -----------------------------------------------------------
+# JRuby (Java 1.6.0) jdom_document_builder          0.363
+# MRI: libxml                                       0.389
+# JRuby (Java 1.6.0 server) jdom_document_builder   0.412
+# JRuby (server) jdom_document_builder              0.617
+# JRuby: jdom_document_builder                      1.451
+# MRI: hpricot                                      2.056
+# JRuby (Java 1.6.0 server) hpricot                 2.272
+# JRuby (Java 1.6.0) hpricot                        2.273
+# JRuby (server) hpricot                            3.447
+# JRuby: hpricot                                    6.198
+# JRuby (Java 1.6.0 server) rexml                   6.251
+# JRuby (Java 1.6.0) rexml                          6.356
+# MRI: rexml                                        7.624
+# JRuby (server) rexml                              9.609
+# JRuby: rexml                                     12.944
+# 
+# Detailed data:
+#
+# $ ruby ./xml_benchmarks.rb
+# 
+# Ruby version: MRI 1.8.6 (2007-09-24 rev 111), platform: universal-darwin9.0
+# 
+# 100 times: Open 98k XML document and count one type of leaf element (466 entries)
+# 
+# Rehearsal -------------------------------------------
+# rexml     7.650000   0.040000   7.690000 (  7.692767)
+# hpricot   2.100000   0.030000   2.130000 (  2.133564)
+# libxml    0.390000   0.030000   0.420000 (  0.419391)
+# --------------------------------- total: 10.240000sec
+# 
+#               user     system      total        real
+# rexml     7.600000   0.010000   7.610000 (  7.624436)
+# hpricot   2.040000   0.020000   2.060000 (  2.056690)
+# libxml    0.380000   0.010000   0.390000 (  0.389298)
+# 
+# $ jruby ./xml_benchmarks.rb
+# 
+# Ruby version: JRuby 1.8.6 (2008-03-20 rev 6255) [i386-jruby1.1RC3], platform: Java: version: 1.5.0_13
+# 
+# 100 times: Open 98k XML document and count one type of leaf element (466 entries)
+# 
+# Rehearsal ---------------------------------------------------------
+# rexml                  14.063000   0.000000  14.063000 ( 14.063000)
+# hpricot                 6.579000   0.000000   6.579000 (  6.579000)
+# jdom_document_builder   2.211000   0.000000   2.211000 (  2.211000)
+# ----------------------------------------------- total: 22.853000sec
+# 
+#                             user     system      total        real
+# rexml                  12.944000   0.000000  12.944000 ( 12.944000)
+# hpricot                 6.198000   0.000000   6.198000 (  6.198000)
+# jdom_document_builder   1.450000   0.000000   1.450000 (  1.451000)
+# 
+# $ jruby -J-server ./xml_benchmarks.rb
+# 
+# Ruby version: JRuby 1.8.6 (2008-03-20 rev 6255) [i386-jruby1.1RC3], platform: Java: version: 1.5.0_13
+# 
+# 100 times: Open 98k XML document and count one type of leaf element (466 entries)
+# 
+# Rehearsal ---------------------------------------------------------
+# rexml                  13.212000   0.000000  13.212000 ( 13.212000)
+# hpricot                 6.992000   0.000000   6.992000 (  6.993000)
+# jdom_document_builder   1.873000   0.000000   1.873000 (  1.873000)
+# ----------------------------------------------- total: 22.077000sec
+# 
+#                             user     system      total        real
+# rexml                   9.611000   0.000000   9.611000 (  9.609000)
+# hpricot                 3.446000   0.000000   3.446000 (  3.447000)
+# jdom_document_builder   0.616000   0.000000   0.616000 (  0.617000)
+# 
+#
+#               *** Now using: Java 1.6.0_03 (Soylatte) ***
+# 
+# $ jruby ./xml_benchmarks.rb
+# 
+# Ruby version: JRuby 1.8.6 (2008-03-20 rev 6255) [i386-jruby1.1RC3], platform: Java: version: 1.6.0_03-p3
+# 
+# 100 times: Open 98k XML document and count one type of leaf element (466 entries)
+# 
+# Rehearsal ---------------------------------------------------------
+# rexml                   9.976000   0.000000   9.976000 (  9.976000)
+# hpricot                 4.129000   0.000000   4.129000 (  4.129000)
+# jdom_document_builder   2.287000   0.000000   2.287000 (  2.287000)
+# ----------------------------------------------- total: 16.392000sec
+# 
+#                             user     system      total        real
+# rexml                   6.357000   0.000000   6.357000 (  6.356000)
+# hpricot                 2.274000   0.000000   2.274000 (  2.273000)
+# jdom_document_builder   0.363000   0.000000   0.363000 (  0.363000)
+# 
+# $ jruby -J-server ./xml_benchmarks.rb
+# 
+# Ruby version: JRuby 1.8.6 (2008-03-20 rev 6255) [i386-jruby1.1RC3], platform: Java: version: 1.6.0_03-p3
+# 
+# 100 times: Open 98k XML document and count one type of leaf element (466 entries)
+# 
+# Rehearsal ---------------------------------------------------------
+# rexml                   9.936000   0.000000   9.936000 (  9.935000)
+# hpricot                 4.074000   0.000000   4.074000 (  4.074000)
+# jdom_document_builder   1.355000   0.000000   1.355000 (  1.355000)
+# ----------------------------------------------- total: 15.365000sec
+# 
+#                             user     system      total        real
+# rexml                   6.251000   0.000000   6.251000 (  6.251000)
+# hpricot                 2.273000   0.000000   2.273000 (  2.272000)
+# jdom_document_builder   0.412000   0.000000   0.412000 (  0.412000)
+#
+
+require 'benchmark'
+require "rexml/document"
+require 'hpricot'
+
+if RUBY_PLATFORM =~ /java/ 
+    include Java 
+    import javax.xml.parsers.DocumentBuilder
+    import javax.xml.parsers.DocumentBuilderFactory
+    @dbf = DocumentBuilderFactory.new_instance
+    @ruby_info = "Ruby version: JRuby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE} rev #{RUBY_PATCHLEVEL}) [i386-jruby#{JRUBY_VERSION}]"
+    @ruby_info << ", platform: Java, version #{java.lang.System.getProperty('java.version')}"
+  else
+    require 'libxml'
+    @xml_parser = XML::Parser.new
+    @ruby_info = "Ruby version: MRI #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}"# rev #{RUBY_PATCHLEVEL})"
+    @ruby_info << ", platform: #{RUBY_PLATFORM}"
+end
+
+@bundle_with_466_sock_entries = File.read("sock_entries.xml")
+
+def rexml_count_socks
+  doc = REXML::Document.new(@bundle_with_466_sock_entries).root
+  socks = doc.elements.to_a('./sockEntries').length
+end
+
+unless RUBY_PLATFORM =~ /java/ 
+  def libxml_count_socks
+    @xml_parser.string = @bundle_with_466_sock_entries
+    doc = @xml_parser.parse.root
+    socks = doc.find('//sockEntries').length
+  end
+end
+
+def hpricot_count_socks
+  doc = Hpricot.XML(@bundle_with_466_sock_entries)
+  socks = doc.search("//sockEntries").length
+end
+
+if RUBY_PLATFORM =~ /java/ 
+  def jdom_document_builder_count_socks
+    doc = @dbf.new_document_builder.parse("bundle_with_466_sock_entries.xml").get_document_element   
+    socks = doc.getElementsByTagName("sockEntries")
+    socks.get_length
+  end
+end
+
+n = 100
+test_iterations = ARGV.first.to_i 
+test_iterations = 1 unless test_iterations > 1
+puts 
+puts @ruby_info
+puts
+puts "#{n} times: Open 98k XML document and count one type of leaf element (466 entries)"
+puts
+print "running benchmark "
+if test_iterations == 1 
+  puts "once.\n\n"
+else
+  puts "#{test_iterations} times.\n\n"
+end
+test_iterations.times do
+  Benchmark.bmbm do |x|
+    x.report("libxml") { n.times {libxml_count_socks} }  unless RUBY_PLATFORM =~ /java/ 
+    x.report("hpricot")  { n.times {hpricot_count_socks} }
+    x.report("rexml") { n.times {rexml_count_socks} }
+    x.report("jdom_document_builder")  { n.times {jdom_document_builder_count_socks} } if RUBY_PLATFORM =~ /java/ 
+  end
+  puts
+end
+
+#
+# jrexml doesn't appear to have any speedup in this test
+#
+# if RUBY_PLATFORM =~ /java/ 
+#   require 'jrexml'
+#   def rexml_with_jrexml_count_socks
+#     doc = REXML::Document.new(@bundle_with_466_sock_entries).root
+#     socks = doc.elements.to_a('./sockEntries').length
+#   end
+# 
+#   puts "\nNow add in JREXML to see if it speeds up rexml\n"
+#   Benchmark.bmbm do |x|
+#     x.report("rexml+jrexml") { n.times {rexml_with_jrexml_count_socks} }
+#   end
+#   puts
+# end

data/doc/classes/LibXML.html

@@ -0,0 +1,237 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Module: LibXML</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Module</strong></td>
+          <td class="class-name-in-header">LibXML</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/ext/libxml/libxml_c.html">
+                ext/libxml/libxml.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_attr_c.html">
+                ext/libxml/ruby_xml_attr.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_attributes_c.html">
+                ext/libxml/ruby_xml_attributes.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_document_c.html">
+                ext/libxml/ruby_xml_document.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_dtd_c.html">
+                ext/libxml/ruby_xml_dtd.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_html_parser_c.html">
+                ext/libxml/ruby_xml_html_parser.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_input_cbg_c.html">
+                ext/libxml/ruby_xml_input_cbg.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_node_c.html">
+                ext/libxml/ruby_xml_node.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_node_set_c.html">
+                ext/libxml/ruby_xml_node_set.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_ns_c.html">
+                ext/libxml/ruby_xml_ns.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_parser_c.html">
+                ext/libxml/ruby_xml_parser.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_parser_context_c.html">
+                ext/libxml/ruby_xml_parser_context.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_reader_c.html">
+                ext/libxml/ruby_xml_reader.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_sax_parser_c.html">
+                ext/libxml/ruby_xml_sax_parser.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_schema_c.html">
+                ext/libxml/ruby_xml_schema.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_state_c.html">
+                ext/libxml/ruby_xml_state.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_xinclude_c.html">
+                ext/libxml/ruby_xml_xinclude.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_xpath_c.html">
+                ext/libxml/ruby_xml_xpath.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_xpath_context_c.html">
+                ext/libxml/ruby_xml_xpath_context.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_xpath_object_c.html">
+                ext/libxml/ruby_xml_xpath_object.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_xpointer_c.html">
+                ext/libxml/ruby_xml_xpointer.c
+                </a>
+        <br />
+                <a href="../files/ext/libxml/ruby_xml_xpointer_context_c.html">
+                ext/libxml/ruby_xml_xpointer_context.c
+                </a>
+        <br />
+                <a href="../files/lib/libxml/attr_rb.html">
+                lib/libxml/attr.rb
+                </a>
+        <br />
+                <a href="../files/lib/libxml/attributes_rb.html">
+                lib/libxml/attributes.rb
+                </a>
+        <br />
+                <a href="../files/lib/libxml/document_rb.html">
+                lib/libxml/document.rb
+                </a>
+        <br />
+                <a href="../files/lib/libxml/node_rb.html">
+                lib/libxml/node.rb
+                </a>
+        <br />
+                <a href="../files/lib/libxml/node_set_rb.html">
+                lib/libxml/node_set.rb
+                </a>
+        <br />
+                <a href="../files/lib/libxml/parser_rb.html">
+                lib/libxml/parser.rb
+                </a>
+        <br />
+                <a href="../files/lib/libxml/parser_options_rb.html">
+                lib/libxml/parser_options.rb
+                </a>
+        <br />
+                <a href="../files/lib/libxml/properties_rb.html">
+                lib/libxml/properties.rb
+                </a>
+        <br />
+                <a href="../files/lib/libxml/tree_rb.html">
+                lib/libxml/tree.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+    <div id="description">
+      <p>
+This is for backwards compatibility and is DEPRECATED
+</p>
+
+    </div>
+
+
+   </div>
+
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+
+      Module <a href="LibXML/XML.html" class="link">LibXML::XML</a><br />
+
+    </div>
+
+
+
+
+      
+
+
+    <!-- if method_list -->
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>