Class: DBus::IntrospectXMLParser

Inherits:
Object
  • Object
show all
Defined in:
lib/dbus/xml.rb

Overview

D-Bus introspect XML parser class

This class parses introspection XML of an object and constructs a tree of Node, Interface, Method, Signal instances.

Defined Under Namespace

Classes: AbstractXML, NokogiriParser, REXMLParser

Class Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(xml) ⇒ IntrospectXMLParser

Creates a new parser for XML data in string xml.



29
30
31
 
# File 'lib/dbus/xml.rb', line 29

def initialize(xml)
  @xml = xml
end

Class Attribute Details

.backend ⇒ Object

Returns the value of attribute backend.



26
27
28
 
# File 'lib/dbus/xml.rb', line 26

def backend
  @backend
end

Instance Method Details

#parse ⇒ Array(Array<Interface>,Array<String>)

Returns a pair: [list of Interfaces, list of direct subnode names].

Returns:

  • (Array(Array<Interface>,Array<String>)) —

    a pair: [list of Interfaces, list of direct subnode names]



103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
 
# File 'lib/dbus/xml.rb', line 103

def parse
  # Using a Hash instead of a list helps merge split-up interfaces,
  # a quirk observed in ModemManager (I#41).
  interfaces = Hash.new do |hash, missing_key|
    hash[missing_key] = Interface.new(missing_key)
  end
  subnodes = []
  t = Time.now

  d = IntrospectXMLParser.backend.new(@xml)
  d.each("node/node") do |e|
    subnodes << e["name"]
  end
  d.each("node/interface") do |e|
    i = interfaces[e["name"]]
    e.each("method") do |me|
      m = Method.new(me["name"])
      parse_methsig(me, m)
      i << m
    end
    e.each("signal") do |se|
      s = Signal.new(se["name"])
      parse_methsig(se, s)
      i << s
    end
  end
  d = Time.now - t
  if d > 2
    DBus.logger.debug "Some XML took more that two secs to parse. Optimize me!"
  end
  [interfaces.values, subnodes]
end