libxml-ruby 5.0.6 → 6.0.0

data/test/test_xpath_expression.rb

@@ -1,37 +1,37 @@
-# encoding: UTF-8
-
-require_relative './test_helper'
-
-
-class TestXPathExpression < Minitest::Test
-  def setup
-    xp = LibXML::XML::Parser.string('<ruby_array uga="booga" foo="bar"><fixnum>one</fixnum><fixnum>two</fixnum></ruby_array>')
-    @doc = xp.parse
-  end
-  
-  def teardown
-    @doc = nil
-  end
-
-  def test_nodes
-    expr = LibXML::XML::XPath::Expression.compile('/ruby_array/fixnum')
-    set = @doc.find(expr)
-    assert_instance_of(LibXML::XML::XPath::Object, set)
-    assert_equal(2, set.size)
-  end
-
-  def test_find_class
-    expr = LibXML::XML::XPath::Expression.new('/ruby_array/fixnum')
-    set = @doc.find(expr)
-    assert_instance_of(LibXML::XML::XPath::Object, set)
-    assert_equal(2, set.size)
-  end
-
-  def test_find_invalid
-    error = assert_raises(TypeError) do
-      @doc.find(999)
-    end
-    assert_equal('Argument should be an instance of a String or XPath::Expression',
-                 error.to_s)
-  end
-end
+# encoding: UTF-8
+
+require_relative './test_helper'
+
+
+class TestXPathExpression < Minitest::Test
+  def setup
+    xp = LibXML::XML::Parser.string('<ruby_array uga="booga" foo="bar"><fixnum>one</fixnum><fixnum>two</fixnum></ruby_array>')
+    @doc = xp.parse
+  end
+  
+  def teardown
+    @doc = nil
+  end
+
+  def test_nodes
+    expr = LibXML::XML::XPath::Expression.compile('/ruby_array/fixnum')
+    set = @doc.find(expr)
+    assert_instance_of(LibXML::XML::XPath::Object, set)
+    assert_equal(2, set.size)
+  end
+
+  def test_find_class
+    expr = LibXML::XML::XPath::Expression.new('/ruby_array/fixnum')
+    set = @doc.find(expr)
+    assert_instance_of(LibXML::XML::XPath::Object, set)
+    assert_equal(2, set.size)
+  end
+
+  def test_find_invalid
+    error = assert_raises(TypeError) do
+      @doc.find(999)
+    end
+    assert_equal('Argument should be an instance of a String or XPath::Expression',
+                 error.to_s)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: libxml-ruby
 version: !ruby/object:Gem::Version
-  version: 5.0.6
+  version: 6.0.0
 platform: ruby
 authors:
 - Ross Bamform
@@ -13,7 +13,7 @@ authors:
 - Ryan Johnson
 bindir: bin
 cert_chain: []
-date: 2026-04-03 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger
@@ -57,22 +57,33 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: |2
-      The Libxml-Ruby project provides Ruby language bindings for the GNOME
-      Libxml2 XML toolkit. It is free software, released under the MIT License.
-      Libxml-ruby's primary advantage over REXML is performance - if speed
-      is your need, these are good libraries to consider, as demonstrated
-      by the informal benchmark below.
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: "    libxml-Ruby provides Ruby language bindings for libxml2 It is free
+  software, \n    released under the MIT License. libxml-ruby provides DOM, SAX, Reader,
+  and \n    Writer APIs along with XPath support and validation via DTD, RelaxNG,
+  and XML Schema.\n"
 executables: []
 extensions:
 - ext/libxml/extconf.rb
 extra_rdoc_files: []
 files:
-- HISTORY
+- CHANGELOG.md
 - LICENSE
-- README.rdoc
+- README.md
 - Rakefile
-- ext/libxml/extconf.h
 - ext/libxml/extconf.rb
 - ext/libxml/libxml.c
 - ext/libxml/libxml_ruby.def
@@ -85,7 +96,6 @@ files:
 - ext/libxml/ruby_xml_attr_decl.h
 - ext/libxml/ruby_xml_attributes.c
 - ext/libxml/ruby_xml_attributes.h
-- ext/libxml/ruby_xml_cbg.c
 - ext/libxml/ruby_xml_document.c
 - ext/libxml/ruby_xml_document.h
 - ext/libxml/ruby_xml_dtd.c
@@ -118,6 +128,8 @@ files:
 - ext/libxml/ruby_xml_parser_options.h
 - ext/libxml/ruby_xml_reader.c
 - ext/libxml/ruby_xml_reader.h
+- ext/libxml/ruby_xml_registry.c
+- ext/libxml/ruby_xml_registry.h
 - ext/libxml/ruby_xml_relaxng.c
 - ext/libxml/ruby_xml_relaxng.h
 - ext/libxml/ruby_xml_sax2_handler.c
@@ -148,14 +160,17 @@ files:
 - ext/libxml/ruby_xml_xpath_object.c
 - ext/libxml/ruby_xml_xpath_object.h
 - ext/vc/libxml_ruby.sln
+- ext/vc/libxml_ruby/libxml_ruby.vcxproj
+- ext/xcode/libxml-ruby.xcodeproj/project.pbxproj
+- ext/xcode/libxml-ruby.xcodeproj/project.xcworkspace/contents.xcworkspacedata
+- ext/xcode/libxml-ruby.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
+- ext/xcode/libxml-ruby.xcodeproj/xcshareddata/xcschemes/libxml-ruby.xcscheme
 - lib/libxml-ruby.rb
-- lib/libxml.rb
 - lib/libxml/attr.rb
 - lib/libxml/attr_decl.rb
 - lib/libxml/attributes.rb
 - lib/libxml/document.rb
 - lib/libxml/error.rb
-- lib/libxml/hpricot.rb
 - lib/libxml/html_parser.rb
 - lib/libxml/namespace.rb
 - lib/libxml/namespaces.rb
@@ -168,15 +183,7 @@ files:
 - lib/libxml/schema/element.rb
 - lib/libxml/schema/type.rb
 - lib/libxml/tree.rb
-- lib/xml.rb
-- lib/xml/libxml.rb
 - libxml-ruby.gemspec
-- script/benchmark/depixelate
-- script/benchmark/hamlet.xml
-- script/benchmark/parsecount
-- script/benchmark/sock_entries.xml
-- script/benchmark/throughput
-- script/test
 - test/c14n/given/doc.dtd
 - test/c14n/given/example-1.xml
 - test/c14n/given/example-2.xml
@@ -232,7 +239,6 @@ files:
 - test/test_attr_decl.rb
 - test/test_attributes.rb
 - test/test_canonicalize.rb
-- test/test_deprecated_require.rb
 - test/test_document.rb
 - test/test_document_write.rb
 - test/test_dtd.rb
@@ -242,6 +248,7 @@ files:
 - test/test_helper.rb
 - test/test_html_parser.rb
 - test/test_html_parser_context.rb
+- test/test_input_callbacks.rb
 - test/test_namespace.rb
 - test/test_namespaces.rb
 - test/test_node.rb
@@ -279,7 +286,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -294,7 +301,6 @@ test_files:
 - test/test_attr_decl.rb
 - test/test_attributes.rb
 - test/test_canonicalize.rb
-- test/test_deprecated_require.rb
 - test/test_document.rb
 - test/test_document_write.rb
 - test/test_dtd.rb
@@ -304,6 +310,7 @@ test_files:
 - test/test_helper.rb
 - test/test_html_parser.rb
 - test/test_html_parser_context.rb
+- test/test_input_callbacks.rb
 - test/test_namespace.rb
 - test/test_namespaces.rb
 - test/test_node.rb

data/README.rdoc

@@ -1,208 +0,0 @@
-= LibXML Ruby
-
-== Overview
-The libxml gem provides Ruby language bindings for GNOME's Libxml2
-XML toolkit. It is free software, released under the MIT License.
-
-We think libxml-ruby is the best XML library for Ruby because:
-
-* Speed - Its much faster than REXML and Hpricot
-* Features - It provides an amazing number of featues
-* Conformance - It passes all 1800+ tests from the OASIS XML Tests Suite
-
-== Requirements
-libxml-ruby requires Ruby 3.0.0 or higher.  It depends on libxml2 to
-function properly.  libxml2, in turn, depends on:
-
-* libm      (math routines: very standard)
-* libz      (zlib)
-* libiconv
-
-If you are running Linux or Unix you'll need a C compiler so the
-extension can be compiled when it is installed.  If you are running
-Windows, then install the x64-mingw-ucr gem or build it yourself using (Ruby
-for Windows)[https://rubyinstaller.org/] or directly with msys2[https://msys2.github.io/]
-and ucrt64.
-
-== Installation
-The easiest way to install libxml-ruby is via RubyGems.  To install:
-
-<tt>gem install libxml-ruby</tt>
-
-If the extension compile process cannot find libxml2, you may need to indicate
-the location of the libxml2 configuration utility as it is used to find the
-required header and include files.  (If you need to indicate a location for the
-libxml2 library or header files different than reported by <tt>xml2-config</tt>,
-see the additional configuration options.)
-
-This may be done with RubyGems:
-
-<tt>gem install libxml-ruby -- --with-xml2-dir=/path/to/xml2-config</tt>
-
-Or bundler:
-
-<tt>bundle config build.libxml-ruby --with-xml2-config=/path/to/xml2-config</tt>
-
-<tt>bundle install libxml-ruby</tt>
-
-If you are running Windows, then install the libxml-ruby-x64-mingw32 gem.
-The gem includes prebuilt extensions for Ruby 3.2 and 3.3.
-
-The gem also includes a Microsoft VC++ solution and XCode project - these
-are very useful for debugging.
-
-libxml-ruby's source codes lives on GitHub[https://github.com/xml4r/libxml-ruby].
-
-== Getting Started
-Using libxml is easy. First decide what parser you want to use:
-
-* Generally you'll want to use the LibXML::XML::Parser which provides a tree based API.
-* For larger documents that don't fit into memory, or if you prefer an input based API, use the LibXML::XML::Reader.
-* To parse HTML files use LibXML::XML::HTMLParser.
-* If you are masochistic, then use the LibXML::XML::SaxParser, which provides a callback API.
-
-Once you have chosen a parser, choose a datasource.  Libxml can parse files, strings, URIs
-and IO streams.  For each data source you can specify an LibXML::XML::Encoding, a base uri and
-various parser options.  For more information, refer the LibXML::XML::Parser.document,
-LibXML::XML::Parser.file, LibXML::XML::Parser.io or LibXML:::XML::Parser.string methods (the
-same methods are defined on all four parser classes).
-
-== Advanced Functionality
-Beyond the basics of parsing and processing XML and HTML documents,
-libxml provides a wealth of additional functionality.
-
-Most commonly, you'll want to use its LibXML::XML::XPath support, which makes
-it easy to find data inside an XML document.  Although not as popular,
-LibXML::XML::XPointer provides another API for finding data inside an XML document.
-
-Often times you'll need to validate data before processing it. For example,
-if you accept user generated content submitted over the Web, you'll
-want to verify that it does not contain malicious code such as embedded scripts.
-This can be done using libxml's powerful set of validators:
-
-* DTDs (LibXML::XML::Dtd)
-* Relax Schemas (LibXML::XML::RelaxNG)
-* XML Schema (LibXML::XML::Schema)
-
-Finally, if you'd like to use XSL Transformations to process data, then install
-the {libxslt gem}[https://github.com/xml4r/libxslt-rubygem].
-
-== Usage
-For information about using libxml-ruby please refer to its
-documentation[https://xml4r.github.io/libxml-ruby]. Some tutorials are also
-available[https://github.com/xml4r/libxml-ruby/wiki].
-
-All libxml classes are in the LibXML::XML module. The easiest
-way to use libxml is to <tt>require 'xml'</tt>.  This will mixin
-the LibXML module into the global namespace, allowing you to
-write code like this:
-
-  require 'xml'
-  document = XML::Document.new
-
-However, when creating an application or library you plan to
-redistribute, it is best to not add the LibXML module to the global
-namespace, in which case you can either write your code like this:
-
-  require 'libxml'
-  document = LibXML::XML::Document.new
-
-Or you can utilize a namespace for your own work and include LibXML into it.
-For example:
-
-  require 'libxml'
-
-  module MyApplication
-    include LibXML
-
-    class MyClass
-      def some_method
-        document = XML::Document.new
-      end
-    end
-  end
-
-For simplicity's sake, the documentation uses the xml module in its examples.
-
-== Tests
-
-To run tests you first need to build the shared libary:
-
-  rake compile
-
-Once you have build the shared libary, you can then run tests using rake:
-
-  rake test
-
-+Build status: {rdoc-image:https://github.com/xml4r/libxml-ruby/actions/workflows/mri.yml/badge.svg}[https://github.com/xml4r/libxml-ruby/actions/workflows/mri.yml]
-
-== Performance
-
-In addition to being feature rich and conformation, the main reason
-people use libxml-ruby is for performance.  Here are the results
-of a couple simple benchmarks recently blogged about on the
-Web (you can find them in the benchmark directory of the
-libxml distribution).
-
-From http://depixelate.com/2008/4/23/ruby-xml-parsing-benchmarks
-
-               user     system      total        real
- libxml    0.032000   0.000000   0.032000 (  0.031000)
- Hpricot   0.640000   0.031000   0.671000 (  0.890000)
- REXML     1.813000   0.047000   1.860000 (  2.031000)
-
-From https://svn.concord.org/svn/projects/trunk/common/ruby/xml_benchmarks/
-
-               user     system      total        real
- libxml    0.641000   0.031000   0.672000 (  0.672000)
- hpricot   5.359000   0.062000   5.421000 (  5.516000)
- rexml    22.859000   0.047000  22.906000 ( 23.203000) 
-
-
-== Documentation
-Documentation is available via rdoc, and is installed automatically with the
-gem.
-
-libxml-ruby's {online
-documentation}[https://xml4r.github.io/libxml-ruby/rdoc/index.html] is generated
-using Hanna, which is a development gem dependency.
-
-Note that older versions of Rdoc, which ship with Ruby 1.8.x, will report
-a number of errors.  To avoid them, install Rdoc 2.1 or higher.  Once you have
-installed the gem, you'll have to disable the version of Rdoc that Ruby 1.8.x
-includes.  An easy way to do that is rename the directory
-<tt>ruby/lib/ruby/1.8/rdoc</tt> to
-<tt>ruby/lib/ruby/1.8/rdoc_old</tt>.
-
-== Support
-If you have any questions about using libxml-ruby, please report an issue
-on GitHub[https://github.com/xml4r/libxml-ruby/issues].
-
-== Memory Management
-libxml-ruby automatically manages memory associated with the
-underlying libxml2 library.  The bindings create a one-to-one mapping between
-Ruby objects and libxml documents and libxml parent nodes (ie, nodes that do not
-have a parent and do not belong to a document).  In these cases,
-the bindings manage the memory.  They do this by installing a free
-function and storing a back pointer to the Ruby object from the xmlnode
-using the _private member on libxml structures.  When the Ruby object
-goes out of scope, the underlying libxml structure is freed.  Libxml
-itself then frees all child nodes (recursively).
-
-For all other nodes (the vast majority), the bindings create temporary
-Ruby objects that get freed once they go out of scope. Thus there can be
-more than one Ruby object pointing to the same xml node. To mostly hide
-this from a programmer on the Ruby side, the <tt>#eql?</tt> and <tt>#==</tt> methods are
-overriden to check if two Ruby objects wrap the same xmlnode.  If they do,
-then the methods return true.  During the mark phase, each of these temporary
-objects marks its owning document, thereby keeping the Ruby document object
-alive and thus the xmldoc tree.
-
-In the sweep phase of the garbage collector, or when a program ends,
-there is no order to how Ruby objects are freed.  In fact, the Ruby document
-object is almost always freed before any Ruby objects that wrap child nodes.
-However, this is ok because those Ruby objects do not have a free function
-and are no longer in scope (since if they were the document would not be freed).
-
-== License
-See LICENSE for license information.

data/ext/libxml/extconf.h

@@ -1,4 +0,0 @@
-#ifndef EXTCONF_H
-#define EXTCONF_H
-#define HAVE_ZLIB_H 1
-#endif

data/ext/libxml/ruby_xml_cbg.c

@@ -1,85 +0,0 @@
-#include "ruby_libxml.h"
-#include <string.h>
-#include <libxml/xmlIO.h>
-
-/*
- int         xmlRegisterInputCallbacks       (xmlInputMatchCallback matchFunc,
-                                              xmlInputOpenCallback openFunc,
-                                              xmlInputReadCallback readFunc,
-                                              xmlInputCloseCallback closeFunc);
-
-
- int         (*xmlInputMatchCallback)        (char const *filename);
- void*       (*xmlInputOpenCallback)         (char const *filename);
- int         (*xmlInputReadCallback)         (void *context,
- char *buffer,
- int len);
- int         (*xmlInputCloseCallback)        (void *context);
- */
-
-typedef struct deb_doc_context
-{
-  char *buffer;
-  char *bpos;
-  int remaining;
-} deb_doc_context;
-
-int deb_Match(char const *filename)
-{
-  fprintf(stderr, "deb_Match: %s\n", filename);
-  if (!xmlStrncasecmp(BAD_CAST filename, BAD_CAST "deb://", 6))
-  {
-    return (1);
-  }
-  return (0);
-}
-
-void* deb_Open(char const *filename)
-{
-  deb_doc_context *deb_doc;
-  VALUE res;
-
-  deb_doc = (deb_doc_context*) malloc(sizeof(deb_doc_context));
-
-  res = rb_funcall(rb_funcall(rb_mKernel, rb_intern("const_get"), 1,
-      rb_str_new2("DEBSystem")), rb_intern("document_query"), 1, rb_str_new2(filename));
-  deb_doc->buffer = strdup(StringValuePtr(res));
-  //deb_doc->buffer = strdup("<serepes>serepes</serepes>");
-
-  deb_doc->bpos = deb_doc->buffer;
-  deb_doc->remaining = (int)strlen(deb_doc->buffer);
-  return deb_doc;
-}
-
-int deb_Read(void *context, char *buffer, int len)
-{
-  deb_doc_context *deb_doc;
-  int ret_len;
-  deb_doc = (deb_doc_context*) context;
-
-  if (len >= deb_doc->remaining)
-  {
-    ret_len = deb_doc->remaining;
-  }
-  else
-  {
-    ret_len = len;
-  }
-  deb_doc->remaining -= ret_len;
-  strncpy(buffer, deb_doc->bpos, ret_len);
-  deb_doc->bpos += ret_len;
-
-  return ret_len;
-}
-
-int deb_Close(void *context)
-{
-  free(((deb_doc_context*) context)->buffer);
-  free(context);
-  return 1;
-}
-
-void deb_register_cbg(void)
-{
-  xmlRegisterInputCallbacks(deb_Match, deb_Open, deb_Read, deb_Close);
-}

data/lib/libxml/hpricot.rb

@@ -1,78 +0,0 @@
-# encoding: UTF-8
-
-## Provide hpricot API for libxml.  Provided by Michael Guterl,
-## inspired by http://thebogles.com/blog/an-hpricot-style-interface-to-libxml
-#
-#class String
-#  def to_libxml_doc
-#    xp = XML::Parser.new
-#    xp.string = self
-#    xp.parse
-#  end
-#end
-#
-#module LibXML
-#  module XML
-#    class Document
-#      alias :search :find
-#    end
-#
-#    class Node
-#      # find the child node with the given xpath
-#      def at(xpath)
-#        self.find_first(xpath)
-#      end
-#
-#      # find the array of child nodes matching the given xpath
-#      def search(xpath)
-#        results = self.find(xpath).to_a
-#        if block_given?
-#          results.each do |result|
-#            yield result
-#          end
-#        end
-#        return results
-#      end
-#
-#      def /(xpath)
-#        search(xpath)
-#      end
-#
-#      # return the inner contents of this node as a string
-#      def inner_xml
-#        child.to_s
-#      end
-#
-#      # alias for inner_xml
-#      def inner_html
-#        inner_xml
-#      end
-#
-#      # return this node and its contents as an xml string
-#      def to_xml
-#        self.to_s
-#      end
-#
-#      # alias for path
-#      def xpath
-#        self.path
-#      end
-#
-#      def find_with_default_ns(xpath_expr, namespace=nil)
-#        find_base(xpath_expr, namespace || default_namespaces)
-#      end
-#
-#      def find_first_with_default_ns(xpath_expr, namespace=nil)
-#        find_first_base(xpath_expr, namespace || default_namespaces)
-#      end
-#
-##      alias_method :find_base, :find unless method_defined?(:find_base)
-##      alias_method :find, :find_with_default_ns
-##      alias_method :find_first_base, :find_first unless method_defined?(:find_first_base)
-##      alias_method :find_first, :find_first_with_default_ns
-##      alias :child? :first?
-##      alias :children? :first?
-##      alias :child :first
-#    end
-#  end
-#end

data/lib/libxml.rb

@@ -1,5 +0,0 @@
-# encoding: UTF-8
-#
-# This include is deprecated, use libxml-ruby instead!
-
-require 'libxml-ruby'

data/lib/xml/libxml.rb

@@ -1,10 +0,0 @@
-# encoding: UTF-8
-
-# This is here for backward compatibility.
-#
-# TODO: DEPRECATE!
-
-require 'libxml.rb'
-
-include LibXML
-

data/lib/xml.rb

@@ -1,14 +0,0 @@
-# encoding: UTF-8
-
-# This file loads libxml and adds the LibXML namespace
-# to the toplevel for conveneience. The end result
-# is to have XML:: universally exposed.
-#
-# It is recommend that you only load this file for libs
-# that do not have their own namespace, eg. administrative
-# scripts, personal programs, etc. For other applications
-# require 'libxml' instead and include LibXML into your 
-# app/libs namespace.
-
-require 'libxml'
-include LibXML