libxml-ruby 3.2.2-x64-mingw-ucrt

data/lib/libxml/node.rb

@@ -0,0 +1,323 @@
+# encoding: UTF-8
+
+require 'stringio'
+
+module LibXML
+  module XML
+    class Node
+      # Determines whether this node has attributes
+      def attributes?
+        attributes.length > 0
+      end
+      
+      # Create a shallow copy of the node.  To create
+      # a deep copy call Node#copy(true)
+      def clone
+        copy(false)
+      end
+
+      # call-seq:
+      #    node.inner_xml -> "string"
+      #    node.inner_xml(:indent => true, :encoding => 'UTF-8', :level => 0) -> "string"
+      #
+      # Converts a node's children to a string representation.  To include
+      # the node, use XML::Node#to_s.  For more information about
+      # the supported options, see XML::Node#to_s.
+      def inner_xml(options = Hash.new)
+        io = nil
+        self.each do |node|
+          xml = node.to_s(options)
+          # Create the string IO here since we now know the encoding
+          io = create_string_io(xml) unless io
+          io << xml
+        end
+
+        io ? io.string : nil
+      end
+      
+      # :call-seq:
+      #   node.dup -> XML::Node
+      #
+      # Create a shallow copy of the node.  To create
+      # a deep copy call Node#copy(true)
+      def dup
+        copy(false)
+      end
+    
+      # call-seq:
+      #   node.context(namespaces=nil) -> XPath::Context
+      #
+      # Returns a new XML::XPathContext for the current node.
+      #
+      # Namespaces is an optional array of XML::NS objects
+      def context(nslist = nil)
+        if not self.doc
+          raise(TypeError, "A node must belong to a document before a xpath context can be created")
+        end
+
+        context = XPath::Context.new(self.doc)
+        context.node = self
+        context.register_namespaces_from_node(self)
+        context.register_namespaces_from_node(self.doc.root)
+        context.register_namespaces(nslist) if nslist
+        context
+      end
+
+      # call-seq:
+      #   node.find(namespaces=nil) -> XPath::XPathObject
+      #
+      # Return nodes matching the specified xpath expression.
+      # For more information, please refer to the documentation
+      # for XML::Document#find.
+      #
+      # Namespaces is an optional array of XML::NS objects
+      def find(xpath, nslist = nil)
+        self.context(nslist).find(xpath)
+      end
+    
+      # call-seq:
+      #   node.find_first(namespaces=nil) -> XML::Node
+      #
+      # Return the first node matching the specified xpath expression.
+      # For more information, please refer to the documentation
+      # for the #find method.
+      def find_first(xpath, nslist = nil)
+        find(xpath, nslist).first
+      end
+
+      # call-seq:
+      #   node.namespacess -> XML::Namespaces
+      #   
+      # Returns this node's XML::Namespaces object,
+      # which is used to access the namespaces
+      # associated with this node.
+      def namespaces
+        @namespaces ||= XML::Namespaces.new(self)
+      end
+      
+      # -------  Traversal  ----------------
+      # Iterates over this node's attributes.
+      #
+      #  doc = XML::Document.new('model/books.xml')
+      #  doc.root.each_attr {|attr| puts attr}
+      def each_attr
+        attributes.each do |attr|
+          yield(attr)
+        end
+      end
+      
+      # Iterates over this node's child elements (nodes
+      # that have a node_type == ELEMENT_NODE).
+      #
+      #  doc = XML::Document.new('model/books.xml')
+      #  doc.root.each_element {|element| puts element}
+      def each_element
+        each do |node|
+          yield(node) if node.node_type == ELEMENT_NODE
+        end
+      end
+      
+      # Determines whether this node has a parent node
+      def parent?
+        not parent.nil?
+      end
+    
+      # Determines whether this node has a first node
+      def first?
+        not first.nil?
+      end
+    
+      # Returns this node's children as an array.
+      def children
+        entries
+      end
+    
+      # Determines whether this node has a next node
+      def next?
+        not self.next.nil?
+      end
+    
+      # Determines whether this node has a previous node
+      def prev?
+        not prev.nil?
+      end
+    
+      # Determines whether this node has a last node
+      def last?
+        not last.nil?
+      end
+
+
+      # -------  Node Types  ----------------
+      
+      # Returns this node's type name    
+      def node_type_name
+        case node_type
+          # Most common choices first
+          when ATTRIBUTE_NODE
+            'attribute'
+          when DOCUMENT_NODE
+            'document_xml'
+          when ELEMENT_NODE
+            'element'
+          when TEXT_NODE
+            'text'
+          
+          # Now the rest  
+          when ATTRIBUTE_DECL
+            'attribute_decl'
+          when CDATA_SECTION_NODE
+            'cdata'
+          when COMMENT_NODE
+            'comment'
+          when DOCB_DOCUMENT_NODE
+            'document_docbook'
+          when DOCUMENT_FRAG_NODE
+            'fragment'
+          when DOCUMENT_TYPE_NODE
+            'doctype'
+          when DTD_NODE
+            'dtd'
+          when ELEMENT_DECL
+            'elem_decl'
+          when ENTITY_DECL
+            'entity_decl'
+          when ENTITY_NODE
+            'entity'
+          when ENTITY_REF_NODE
+            'entity_ref'
+          when HTML_DOCUMENT_NODE
+            'document_html'
+          when NAMESPACE_DECL
+            'namespace'
+          when NOTATION_NODE
+            'notation'
+          when PI_NODE
+            'pi'
+          when XINCLUDE_START
+            'xinclude_start'
+          when XINCLUDE_END
+            'xinclude_end'
+          else
+            raise(UnknownType, "Unknown node type: %n", node.node_type);
+        end
+      end
+      
+      # Specifies if this is an attribute node
+      def attribute?
+        node_type == ATTRIBUTE_NODE
+      end
+      
+      # Specifies if this is an attribute declaration node
+      def attribute_decl?
+        node_type == ATTRIBUTE_DECL
+      end
+
+      # Specifies if this is an CDATA node
+      def cdata?
+        node_type == CDATA_SECTION_NODE
+      end
+
+      # Specifies if this is an comment node
+      def comment?
+        node_type == COMMENT_NODE
+      end
+
+      # Specifies if this is an docbook node
+      def docbook_doc?
+        node_type == DOCB_DOCUMENT_NODE
+      end
+
+      # Specifies if this is an doctype node
+      def doctype?
+        node_type == DOCUMENT_TYPE_NODE
+      end
+
+      # Specifies if this is an document node
+      def document?
+        node_type == DOCUMENT_NODE
+      end
+
+      # Specifies if this is an DTD node
+      def dtd?
+        node_type == DTD_NODE
+      end
+
+      # Specifies if this is an element node
+      def element?
+        node_type == ELEMENT_NODE
+      end
+
+      # Specifies if this is an entity node
+      def entity?
+        node_type == ENTITY_NODE
+      end
+
+      # Specifies if this is an element declaration node
+      def element_decl?
+        node_type == ELEMENT_DECL
+      end
+
+      # Specifies if this is an entity reference node
+      def entity_ref?
+        node_type == ENTITY_REF_NODE
+      end
+
+      # Specifies if this is a fragment node
+      def fragment?
+        node_type == DOCUMENT_FRAG_NODE
+      end
+
+      # Specifies if this is a html document node
+      def html_doc?
+        node_type == HTML_DOCUMENT_NODE
+      end
+
+      # Specifies if this is a namespace node (not if it
+      # has a namepsace)
+      def namespace?
+        node_type == NAMESPACE_DECL
+      end
+
+      # Specifies if this is a notation node
+      def notation?
+        node_type == NOTATION_NODE
+      end
+
+      # Specifies if this is a processiong instruction node
+      def pi?
+        node_type == PI_NODE
+      end
+
+      # Specifies if this is a text node
+      def text?
+        node_type == TEXT_NODE
+      end
+      
+      # Specifies if this is an xinclude end node
+      def xinclude_end?
+        node_type == XINCLUDE_END
+      end
+      
+      # Specifies if this is an xinclude start node
+      def xinclude_start?
+        node_type == XINCLUDE_START
+      end
+
+      alias :child? :first?  
+      alias :children? :first?  
+      alias :child :first
+      alias :each_child :each
+
+      private
+
+      def create_string_io(xml)
+        result = StringIO.new("")
+        if defined?(::Encoding)
+          result.set_encoding(xml.encoding)
+        end
+        result
+      end
+    end
+  end
+end

data/lib/libxml/parser.rb

@@ -0,0 +1,101 @@
+# encoding: UTF-8
+
+module LibXML
+  module XML
+    class Parser
+      # call-seq:
+      #    XML::Parser.document(document) -> XML::Parser
+      #
+      # Creates a new parser for the specified document.
+      #
+      # Parameters:
+      #
+      #  document - A preparsed document.
+      def self.document(doc)
+        context = XML::Parser::Context.document(doc)
+        self.new(context)
+      end
+
+      # call-seq:
+      #    XML::Parser.file(path) -> XML::Parser
+      #    XML::Parser.file(path, :encoding => XML::Encoding::UTF_8,
+      #                           :options => XML::Parser::Options::NOENT) -> XML::Parser
+      #
+      # Creates a new parser for the specified file or uri.
+      #
+      # You may provide an optional hash table to control how the
+      # parsing is performed.  Valid options are:
+      #
+      #  encoding - The document encoding, defaults to nil. Valid values
+      #             are the encoding constants defined on XML::Encoding.
+      #  options - Parser options.  Valid values are the constants defined on
+      #            XML::Parser::Options.  Mutliple options can be combined
+      #            by using Bitwise OR (|).
+      def self.file(path, options = {})
+        context = XML::Parser::Context.file(path)
+        context.encoding = options[:encoding] if options[:encoding]
+        context.options = options[:options] if options[:options]
+        self.new(context)
+      end
+
+      # call-seq:
+      #    XML::Parser.io(io) -> XML::Parser
+      #    XML::Parser.io(io, :encoding => XML::Encoding::UTF_8,
+      #                       :options => XML::Parser::Options::NOENT
+      #                       :base_uri="http://libxml.org") -> XML::Parser
+      #
+      # Creates a new parser for the specified io object.
+      #
+      # Parameters:
+      #
+      #  io - io object that contains the xml to parser
+      #  base_uri - The base url for the parsed document.
+      #  encoding - The document encoding, defaults to nil. Valid values
+      #             are the encoding constants defined on XML::Encoding.
+      #  options - Parser options.  Valid values are the constants defined on
+      #            XML::Parser::Options.  Mutliple options can be combined
+      #            by using Bitwise OR (|).
+      def self.io(io, options = {})
+        context = XML::Parser::Context.io(io)
+        context.base_uri = options[:base_uri] if options[:base_uri]
+        context.encoding = options[:encoding] if options[:encoding]
+        context.options = options[:options] if options[:options]
+        self.new(context)
+      end
+
+      # call-seq:
+      #    XML::Parser.string(string)
+      #    XML::Parser.string(string, :encoding => XML::Encoding::UTF_8,
+      #                               :options => XML::Parser::Options::NOENT
+      #                               :base_uri="http://libxml.org") -> XML::Parser
+      #
+      # Creates a new parser by parsing the specified string.
+      #
+      # You may provide an optional hash table to control how the
+      # parsing is performed.  Valid options are:
+      #
+      #  base_uri - The base url for the parsed document.
+      #  encoding - The document encoding, defaults to nil. Valid values
+      #             are the encoding constants defined on XML::Encoding.
+      #  options - Parser options.  Valid values are the constants defined on
+      #            XML::Parser::Options.  Mutliple options can be combined
+      #            by using Bitwise OR (|).
+      def self.string(string, options = {})
+        context = XML::Parser::Context.string(string)
+        context.base_uri = options[:base_uri] if options[:base_uri]
+        context.encoding = options[:encoding] if options[:encoding]
+        context.options = options[:options] if options[:options]
+        self.new(context)
+      end
+
+      def self.register_error_handler(proc)
+        warn('Parser.register_error_handler is deprecated.  Use Error.set_handler instead')
+        if proc.nil?
+          Error.reset_handler
+        else
+          Error.set_handler(&proc)
+        end
+      end
+    end
+  end
+end

data/lib/libxml/sax_callbacks.rb

@@ -0,0 +1,180 @@
+# encoding: UTF-8
+
+module LibXML
+  module XML
+    class SaxParser
+      module Callbacks
+        # Called for a CDATA block event.
+        def on_cdata_block(cdata)
+        end
+
+        # Called for a characters event.
+        def on_characters(chars)
+        end
+
+        # Called for a comment event.
+        def on_comment(msg)
+        end
+
+        # Called for a end document event.
+        def on_end_document
+        end
+
+        # Called for a end element event.
+        def on_end_element_ns(name, prefix, uri)
+        end
+
+        # Called for parser errors.
+        def on_error(msg)
+        end
+
+        # Called for an external subset event.
+        def on_external_subset(name, external_id, system_id)
+        end
+
+        # Called for an external subset notification event.
+        def on_has_external_subset
+        end
+
+        # Called for an internal subset notification event.
+        def on_has_internal_subset
+        end
+
+        # Called for an internal subset event.
+        def on_internal_subset(name, external_id, system_id)
+        end
+
+        # Called for 'is standalone' event.
+        def on_is_standalone
+        end
+
+        # Called for an processing instruction event.
+        def on_processing_instruction(target, data)
+        end
+
+        # Called for a reference event.
+        def on_reference(name)
+        end
+
+        # Called for a start document event.
+        def on_start_document
+        end
+
+        # Called for a start element event.
+        def on_start_element_ns(name, attributes, prefix, uri, namespaces)
+        end
+      end
+
+      module VerboseCallbacks
+        # Called for a CDATA block event.
+        def on_cdata_block(cdata)
+          STDOUT << "on_cdata_block" << "\n" <<
+                    "  cdata " << cdata << "\n"
+          STDOUT.flush
+        end
+
+        # Called for a characters event.
+        def on_characters(chars)
+          STDOUT << "on_characters" << "\n" <<
+                    "  chars " << chars << "\n" 
+          STDOUT.flush
+        end
+
+        # Called for a comment event.
+        def on_comment(comment)
+          STDOUT << "on_comment" << "\n" <<
+                    "  comment: " << comment << "\n"
+          STDOUT.flush
+        end
+
+        # Called for a end document event.
+        def on_end_document
+          STDOUT << "on_end_document\n"
+          STDOUT.flush
+        end
+
+        # Called for a end element event.
+        def on_end_element_ns(name, prefix, uri)
+          STDOUT << "on_end_element_ns" << "\n" <<
+                    "  name: " << name << "\n" <<
+                    "  prefix: " << prefix << "\n" <<
+                    "  uri: " << uri << "\n"
+          STDOUT.flush
+        end
+
+        # Called for parser errors.
+        def on_error(error)
+          STDOUT << "on_error" << "\n"
+                    "  error " << error << "\n"
+          STDOUT.flush
+        end
+
+        # Called for an external subset event.
+        def on_external_subset(name, external_id, system_id)
+          STDOUT << "on_external_subset" << "\n"
+                    "  external_id " << external_id << "\n" <<
+                    "  system_id   " << system_id << "\n"
+          STDOUT.flush
+        end
+
+        # Called for an external subset notification event.
+        def on_has_external_subset
+          STDOUT << "on_has_internal_subset\n"
+          STDOUT.flush
+        end
+
+        # Called for an internal subset notification event.
+        def on_has_internal_subset
+          STDOUT << "on_has_internal_subset\n"
+          STDOUT.flush
+        end
+
+        # Called for an internal subset event.
+        def on_internal_subset(name, external_id, system_id)
+          STDOUT << "on_internal_subset" << "\n"
+                    "  external_id " << external_id << "\n" <<
+                    "  system_id   " << system_id << "\n"
+          STDOUT.flush
+        end
+
+        # Called for 'is standalone' event.
+        def on_is_standalone
+          STDOUT << "on_is_standalone\n"
+          STDOUT.flush
+        end
+
+        # Called for an processing instruction event.
+        def on_processing_instruction(target, data)
+          STDOUT << "on_characters" << "\n"
+                    "  target: " << target << "\n" <<
+                    "  data:   " << data << "\n"
+          STDOUT.flush
+        end
+
+        # Called for a reference event.
+        def on_reference(name)
+          STDOUT << "on_reference:" << "\n" <<
+                    "  name:" << name << "\n"
+          STDOUT.flush
+        end
+
+        # Called for a start document event.
+        def on_start_document
+          STDOUT << "on_start_document\n"
+          STDOUT.flush
+        end
+
+        # Called for a start element event.
+        def on_start_element_ns(name, attributes, prefix, uri, namespaces)
+          STDOUT << "on_start_element_ns" << "\n" <<
+                    "  name: " << name << "\n" <<
+                    "  attr: " << (attributes || Hash.new).inspect << "\n" <<
+                    "  prefix: " << prefix << "\n" <<
+                    "  uri: " << uri << "\n" <<
+                    "  ns_defs: " << (namespaces || Hash.new).inspect << "\n"
+          STDOUT.flush
+        end
+      end
+    end
+  end
+end

data/lib/libxml/sax_parser.rb

@@ -0,0 +1,41 @@
+# encoding: UTF-8
+
+module LibXML
+  module XML
+    class SaxParser
+      # call-seq:
+      #    XML::SaxParser.file(path) -> XML::SaxParser
+      #
+      # Creates a new parser by parsing the specified file or uri.
+      def self.file(path)
+        context = XML::Parser::Context.file(path)
+        self.new(context)
+      end
+
+      # call-seq:
+      #    XML::SaxParser.io(io) -> XML::SaxParser
+      #    XML::SaxParser.io(io, :encoding => XML::Encoding::UTF_8) -> XML::SaxParser
+      #
+      # Creates a new reader by parsing the specified io object.
+      #
+      # Parameters:
+      #
+      #  encoding - The document encoding, defaults to nil. Valid values
+      #             are the encoding constants defined on XML::Encoding.
+      def self.io(io, options = {})
+        context = XML::Parser::Context.io(io)
+        context.encoding = options[:encoding] if options[:encoding]
+        self.new(context)
+      end
+
+      # call-seq:
+      #    XML::SaxParser.string(string)
+      #
+      # Creates a new parser by parsing the specified string.
+      def self.string(string)
+        context = XML::Parser::Context.string(string)
+        self.new(context)
+      end
+    end
+  end
+end

data/lib/libxml/schema/attribute.rb

@@ -0,0 +1,19 @@
+# encoding: UTF-8
+
+module LibXML
+  module XML
+    class Schema::Attribute
+      REQUIRED = 1
+      OPTIONAL = 2
+
+      def default
+        node['default']
+      end
+
+      def required?
+        occurs == REQUIRED
+      end
+
+    end
+  end
+end

data/lib/libxml/schema/element.rb

@@ -0,0 +1,19 @@
+# encoding: UTF-8
+
+module LibXML
+  module XML
+    class Schema::Element
+      def required?
+        !min_occurs.zero?
+      end
+
+      def array?
+        max_occurs > 1
+      end
+
+      def elements
+        type.elements
+      end
+    end
+  end
+end

data/lib/libxml/schema/type.rb

@@ -0,0 +1,21 @@
+module LibXML
+  module XML
+    class Schema::Type
+      def kind_name
+        Schema::Types.constants.find { |k| Schema::Types.const_get(k) == kind }
+      end
+
+      def annonymus_subtypes
+        elements.select { |_, e| e.type.name.nil? }
+      end
+
+      def annonymus_subtypes_recursively(parent=nil)
+        annonymus_subtypes.map do |element_name, e|
+          [{[parent, element_name].compact.join('::') => e.type},
+           e.type.annonymus_subtypes_recursively(element_name)]
+        end.flatten
+      end
+
+    end
+  end
+end