File: oga.rb

package info (click to toggle)
ruby-multi-xml 0.8.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 472 kB
  • sloc: ruby: 2,822; sh: 4; makefile: 2
file content (68 lines) | stat: -rw-r--r-- 1,844 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
require "oga"
require_relative "dom_parser"

module MultiXml
  module Parsers
    # XML parser using the Oga library
    #
    # @api private
    module Oga
      include DomParser
      extend self

      # Get the parse error class for this parser
      #
      # @api private
      # @return [Class] LL::ParserError
      def parse_error = LL::ParserError

      # Parse XML from an IO object
      #
      # @api private
      # @param io [IO] IO-like object containing XML
      # @return [Hash] Parsed XML as a hash
      # @raise [LL::ParserError] if XML is malformed
      def parse(io)
        doc = ::Oga.parse_xml(io)
        node_to_hash(doc.children.first)
      end

      # Collect child nodes into a hash (Oga-specific implementation)
      #
      # Oga uses different node types than Nokogiri/LibXML.
      #
      # @api private
      # @param node [Oga::XML::Element] Parent node
      # @param node_hash [Hash] Hash to populate
      # @return [void]
      def collect_children(node, node_hash)
        each_child(node) do |child|
          case child
          when ::Oga::XML::Element then node_to_hash(child, node_hash)
          when ::Oga::XML::Text, ::Oga::XML::Cdata then node_hash[TEXT_CONTENT_KEY] << child.text
          end
        end
      end

      private

      # Iterate over child nodes
      #
      # @param node [Oga::XML::Element] Parent node
      # @return [void]
      def each_child(node, &) = node.children.each(&)

      # Iterate over attribute nodes
      #
      # @param node [Oga::XML::Element] Element node
      # @return [void]
      def each_attr(node, &) = node.attributes.each(&)

      # Get the name of a node or attribute
      #
      # @param node [Oga::XML::Node] Node to get name from
      # @return [String] Node name
      def node_name(node) = node.name
    end
  end
end