Class: DBus::MatchRule

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

Overview

D-Bus match rule class

FIXME

Constant Summary collapse

FILTERS =

The list of possible match filters. TODO argN, argNpath

[:sender, :interface, :member, :path, :destination, :type].freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ MatchRule

Create a new match rule



34
35
36
 
# File 'lib/dbus/matchrule.rb', line 34

def initialize
  @sender = @interface = @member = @path = @destination = @type = nil
end

Instance Attribute Details

#destination ⇒ Object

The destination filter.



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

def destination
  @destination
end

#interface ⇒ Object

The interface filter.



23
24
25
 
# File 'lib/dbus/matchrule.rb', line 23

def interface
  @interface
end

#member ⇒ Object

The member filter.



25
26
27
 
# File 'lib/dbus/matchrule.rb', line 25

def member
  @member
end

#path ⇒ Object

The path filter.



27
28
29
 
# File 'lib/dbus/matchrule.rb', line 27

def path
  @path
end

#sender ⇒ Object

The sender filter.



21
22
23
 
# File 'lib/dbus/matchrule.rb', line 21

def sender
  @sender
end

#type ⇒ Object

The type type that is matched.



31
32
33
 
# File 'lib/dbus/matchrule.rb', line 31

def type
  @type
end

Instance Method Details

#from_s(str) ⇒ Object

Parses a match rule string s and sets the filters on the object.



58
59
60
61
62
63
64
65
66
67
68
 
# File 'lib/dbus/matchrule.rb', line 58

def from_s(str)
  str.split(",").each do |eq|
    next unless eq =~ /^(.*)='([^']*)'$/
    # "
    name = Regexp.last_match(1)
    val = Regexp.last_match(2)
    raise MatchRuleException, name unless FILTERS.member?(name.to_sym)
    method(name + "=").call(val)
  end
  self
end

#from_signal(intf, signal) ⇒ Object

Sets the match rule to filter for the given signal and the given interface intf.



72
73
74
75
76
77
78
79
 
# File 'lib/dbus/matchrule.rb', line 72

def from_signal(intf, signal)
  signal = signal.name unless signal.is_a?(String)
  self.type = "signal"
  self.interface = intf.name
  self.member = signal
  self.path = intf.object.path
  self
end

#match(msg) ⇒ Object

Determines whether a message msg matches the match rule.



82
83
84
85
86
87
88
89
90
91
92
93
94
95
 
# File 'lib/dbus/matchrule.rb', line 82

def match(msg)
  if @type
    if { Message::SIGNAL => "signal", Message::METHOD_CALL => "method_call",
         Message::METHOD_RETURN => "method_return",
         Message::ERROR => "error" }[msg.message_type] != @type
      return false
    end
  end
  return false if @interface && @interface != msg.interface
  return false if @member && @member != msg.member
  return false if @path && @path != msg.path
  # FIXME: sender and destination are ignored
  true
end

#to_s ⇒ Object

Returns a match rule string version of the object. E.g.: “type=‘signal’,sender=‘org.freedesktop.DBus’,” + “interface=‘org.freedesktop.DBus’,member=‘Foo’,” + “path=‘/bar/foo’,destination=‘:452345.34’,arg2=‘bar’”



51
52
53
54
55
 
# File 'lib/dbus/matchrule.rb', line 51

def to_s
  present_rules = FILTERS.select { |sym| method(sym).call }
  present_rules.map! { |sym| "#{sym}='#{method(sym).call}'" }
  present_rules.join(",")
end