rbus 0.1.0

data/spec/marshal_spec.rb

@@ -0,0 +1,91 @@
+#--
+# 
+# R-Bus is a native Ruby implementation of the D-Bus protocol.
+# Copyright (C) 2007 Kristoffer Lundén (kristoffer.lunden@gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+# MA  02110-1301, USA.  A copy of the GNU General Public License is
+# also available at http://www.gnu.org/copyleft/gpl.html.
+#
+#++
+#
+require File.dirname(__FILE__) + '/helpers/spec_helper'
+
+class Array
+  include(RBus::MarshalMixin)
+end
+
+module RBus
+
+  context "Boolean" do
+    setup do
+      @true = [1].pack('I')  
+      @false = [0].pack('I')      
+    end
+    
+    specify "should encode false" do
+      [false].dbus_marshal('b').should == @false
+    end
+    specify "should encode 0" do
+      [0].dbus_marshal('b').should == @false
+    end
+    specify "should encode true" do
+      [true].dbus_marshal('b').should == @true
+    end
+    specify "should encode 1" do
+      [1].dbus_marshal('b').should == @true
+    end
+    specify "should encode most anything 'true' as per Ruby rules" do
+      [rand(255), 'string'].each do |val|
+        [val].dbus_marshal('b').should == @true
+      end
+    end
+    specify "should encode nil as false as per Ruby rules" do
+      [nil].dbus_marshal('b').should == @false
+    end 
+  end
+
+  context "Byte" do
+    specify "should encode byte" do
+      num = rand(255)
+      [num].dbus_marshal('y').should == [num].pack('C')
+    end
+    specify "should encode byte series" do
+      [1,2,3,4,5].dbus_marshal('yyyyy').should == [1,2,3,4,5].pack('C*')
+    end
+  end
+
+  context "Numbers" do
+    setup do
+      @uint16 = rand(2**16-1)
+      @int16  = rand(2**15-1) * [-1,1][rand(2)]
+      @uint32 = rand(2**32-1)
+      @int32  = rand(2**31-1) * [-1,1][rand(2)]
+      @double = rand(2**1023-1) * [-1,1][rand(2)]
+    end
+    specify "should encode uint16" do
+      [@uint16].dbus_marshal('q').should == [@uint16].pack('S')
+    end
+  end
+  
+  context "Mixed basic types" do
+    setup do
+      
+    end
+    specify "should encode bool, byte, uint32" do
+      [1,2,3].dbus_marshal('byu').should == [1,2,3].pack('ICxxxI')
+    end
+  end  
+end

data/spec/message_spec.rb

@@ -0,0 +1,61 @@
+#--
+# 
+# R-Bus is a native Ruby implementation of the D-Bus protocol.
+# Copyright (C) 2007 Kristoffer Lundén (kristoffer.lunden@gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+# MA  02110-1301, USA.  A copy of the GNU General Public License is
+# also available at http://www.gnu.org/copyleft/gpl.html.
+#
+#++
+#
+require File.dirname(__FILE__) + '/helpers/spec_helper'
+
+module RBus
+  context "Message::Base" do
+    setup do
+      Message::SerialGenerator.stub!(:get_unique).and_return(1)
+      @message = Message::Base.new
+    end
+  
+    specify "should be a Message object" do
+      @message.should_be_instance_of(Message::Base)
+    end
+  end
+  
+  context "Message::SerialGenerator" do
+    setup do
+      @serials = Array.new(42).map!{Message::SerialGenerator.get_unique}
+    end
+    specify "single-threaded should give an ordered series" do
+      @serials.sort.should == @serials
+    end
+    specify "single-threaded should give unique values" do
+      @serials.uniq.should == @serials
+    end
+    specify "multi-threaded should still give all unique values" do
+      threads = []
+      serials = []
+      1337.times do
+        threads << Thread.new do
+          select(nil,nil,nil,rand)
+          serials << Message::SerialGenerator.get_unique
+        end
+      end
+      threads.each {|thr| thr.join }
+      serials.uniq.should == serials      
+    end
+  end
+end

data/spec/observers_spec.rb

@@ -0,0 +1,28 @@
+#--
+# 
+# R-Bus is a native Ruby implementation of the D-Bus protocol.
+# Copyright (C) 2007 Kristoffer Lundén (kristoffer.lunden@gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+# MA  02110-1301, USA.  A copy of the GNU General Public License is
+# also available at http://www.gnu.org/copyleft/gpl.html.
+#
+#++
+#
+module RBus
+  module Message
+
+  end
+end

data/spec/proxy_spec.rb

@@ -0,0 +1,120 @@
+#--
+# 
+# R-Bus is a native Ruby implementation of the D-Bus protocol.
+# Copyright (C) 2007 Kristoffer Lundén (kristoffer.lunden@gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+# MA  02110-1301, USA.  A copy of the GNU General Public License is
+# also available at http://www.gnu.org/copyleft/gpl.html.
+#
+#++
+#
+require File.dirname(__FILE__) + '/helpers/spec_helper'
+
+module RBus
+
+  context "Proxy" do
+    setup do
+      @well_known_name = 'org.rubyforge.rbus'
+      @object_path = '/org/rubyforge/rbus'
+      @message_loop = mock('MessageLoop')
+      @message_loop.stub!(:send_message)
+      @bus = mock('Bus')
+      @bus.stub!(:message_loop).and_return(@message_loop)
+      @proxy = Proxy.new(@bus, @well_known_name, @object_path)
+    end
+    
+    specify "should send Hello message" do
+      @message_loop.should_receive(:send_message) {|m,b|
+        m.should_be_an_instance_of(MethodCall)
+        m.member.should == 'Hello'
+        b.should == nil
+      }
+      @proxy.Hello()
+    end
+
+    specify "should send message with arg == string" do
+      @message_loop.should_receive(:send_message) {|m,b|
+        m.should_be_an_instance_of(MethodCall)
+        m.member.should == 'Hola'
+        m.arguments.should == ['a string']
+        b.should == nil
+      }
+      @proxy.Hola('a string')
+    end
+    
+    specify "should send message with multiple args" do
+      @message_loop.should_receive(:send_message) {|m,b|
+        m.should_be_an_instance_of(MethodCall)
+        m.member.should == 'Hola'
+        m.arguments.should == ['a string',2,3,[2,3]]
+        b.should == nil
+      }
+      @proxy.Hola('a string', 2,3,[2,3])
+    end
+    
+    specify "should send Hello message with async block" do
+      @message_loop.should_receive(:send_message) {|m,b|
+        m.should_be_an_instance_of(MethodCall)
+        m.member.should == 'Hello'
+        b.call('Reverse').should == 'esreveR'
+      }
+      @proxy.Hello() {|v|v.reverse}
+    end
+    
+    specify "should send message with arg == string and async block" do
+      @message_loop.should_receive(:send_message) {|m,b|
+        m.should_be_an_instance_of(MethodCall)
+        m.member.should == 'Hola'
+        m.arguments.should == ['a string']
+        b.call('Reverse').should == 'esreveR'
+      }
+      @proxy.Hola('a string') {|v|v.reverse}
+    end
+    
+    specify "should send Hello message with interface" do
+      @message_loop.should_receive(:send_message) {|m,b|
+        m.should_be_an_instance_of(MethodCall)
+        m.member.should == 'Hello'
+        m.interface.should == 'org.freedesktop.dbus.Hello'
+        b.should == nil
+      }
+      @proxy.interface!('org.freedesktop.dbus.Hello').Hello()
+    end
+    
+    specify "should send Hello message with interface and async block" do
+      @message_loop.should_receive(:send_message) {|m,b|
+        m.should_be_an_instance_of(MethodCall)
+        m.member.should == 'Hello'
+        m.interface.should == 'org.freedesktop.dbus.Hello'
+        b.call('Reverse').should == 'esreveR'
+      }
+      @proxy.interface!('org.freedesktop.dbus.Hello').Hello() {|v|v.reverse}
+    end
+    
+    specify "should raise on illegal method name (?)" do
+      lambda{@proxy.illegal?}.should_raise(InvalidNameException)
+    end
+    
+    specify "should raise on illegal method name (!)" do
+      lambda{@proxy.illegal!}.should_raise(InvalidNameException)
+    end
+    
+    specify "should raise on too long name (>255)" do
+      lambda{@proxy.abcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijkabcdefghijk}.should_raise(InvalidNameException)
+    end
+    
+  end
+end

data/spec/transport_spec.rb

@@ -0,0 +1,187 @@
+#--
+# 
+# R-Bus is a native Ruby implementation of the D-Bus protocol.
+# Copyright (C) 2007 Kristoffer Lundén (kristoffer.lunden@gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+# MA  02110-1301, USA.  A copy of the GNU General Public License is
+# also available at http://www.gnu.org/copyleft/gpl.html.
+#
+#++
+#
+require File.dirname(__FILE__) + '/helpers/spec_helper'
+
+module RBus
+
+  context "Transport.connect" do
+    specify "should raise on illegal transport" do
+      lambda{Transport.connect('illegal:and=bad')}.should_raise InvalidTransportException
+    end
+  end
+
+  context "Transport.parse_address" do
+    specify "should raise on address without :" do
+      lambda{Transport.parse_address('unix')}.should_raise InvalidAddressException
+    end
+    
+    specify "should raise on transport without content" do
+      lambda{Transport.parse_address('unix:')}.should_raise InvalidAddressException
+    end
+  end
+  
+  context "Transport.parse_address unix:path" do
+    setup do
+      @connection_info = Transport.parse_address('unix:path=/var/run/dbus/system_bus_socket')
+    end
+    
+    specify "should have transport unix" do
+      @connection_info['transport'].should == 'unix'
+    end
+    
+    specify "should have path" do
+      @connection_info['path'].should == '/var/run/dbus/system_bus_socket'
+    end
+  end
+
+  context "Transport.parse_address unix:abstract with guid" do
+    setup do
+      @connection_info = 
+        Transport.parse_address('unix:abstract=/tmp/dbus-lafi7lJhll,guid=a190e4459a37da0c62586ac4de5fa400')
+    end
+    
+    specify "should have transport unix" do
+      @connection_info['transport'].should == 'unix'
+    end
+    
+    specify "should have abstract path" do
+      @connection_info['abstract'].should == '/tmp/dbus-lafi7lJhll'
+    end
+
+    specify "should have guid" do
+      @connection_info['guid'].should == 'a190e4459a37da0c62586ac4de5fa400'
+    end
+
+  end
+
+  context "Transport.parse_address tcp with host=ip" do
+    setup do
+      @connection_info = Transport.parse_address('tcp:host=192.168.0.1,port=6666')
+    end
+    
+    specify "should have transport tcp" do
+      @connection_info['transport'].should == 'tcp'
+    end
+    
+    specify "should have host" do
+      @connection_info['host'].should == '192.168.0.1'
+    end
+
+    specify "should have port" do
+      @connection_info['port'].should == '6666'
+    end
+  end
+  
+  context "Transport.parse_address tcp with host=url" do
+    setup do
+      @connection_info = Transport.parse_address('tcp:host=example.com,port=8073')
+    end
+    
+    specify "should have transport tcp" do
+      @connection_info['transport'].should == 'tcp'
+    end
+    
+    specify "should have host" do
+      @connection_info['host'].should == 'example.com'
+    end
+
+    specify "should have port" do
+      @connection_info['port'].should == '8073'
+    end
+
+  end
+
+  context "Transport.unescape" do
+    specify "should leave non-escaped alone" do
+      Transport.unescape('example.com').should == 'example.com'
+    end
+    
+    specify "should properly unescape" do
+      test_string = 'example.com/?test=this&key=value#anchor'
+      escaped = test_string.split('').map{|c|sprintf("%%%X", c[0])}.join
+      Transport.unescape(escaped).should == test_string
+    end
+  end
+
+  context "Abstract UNIX socket" do
+    setup do
+      @abstract_path = '/tmp/test'
+      @socket = mock('Socket')
+      @socket.stub!(:connect)
+      Socket.should_receive(:new).any_number_of_times.and_return(@socket)
+      @transport = Transport.connect("unix:abstract=#{@abstract_path}")
+    end
+    
+    specify "should receive connect with abstract path" do
+      @socket.should_receive(:connect).with("\1\0\0#{@abstract_path}")
+      Transport.connect("unix:abstract=#{@abstract_path}")
+    end
+    
+    specify "should take send()" do
+      @transport.should_receive(:send).with("\0")
+      @transport.send("\0")
+    end
+    
+    specify "should take read()" do
+      @transport.should_receive(:read)
+      @transport.read
+    end
+    
+    specify "should take sendline()" do
+      @transport.should_receive(:sendline).with(:string)
+      @transport.sendline('AUTH EXTERNAL')
+    end
+    
+    specify "should take readline()" do
+      @transport.should_receive(:readline)
+      @transport.readline
+    end
+  end
+
+  context "Regular UNIX socket" do
+    setup do
+      @path = '/tmp/test'
+      @socket = mock('UNIXSocket')
+    end
+    
+    specify "should receive connect with path" do
+      UNIXSocket.should_receive(:open).with(@path).and_return(@socket)
+      Transport.connect("unix:path=#{@path}")
+    end
+  end
+
+  context "TCP socket" do
+    setup do
+      @host = 'example.com'
+      @port = '6666'
+      @socket = mock('TCPSocket')
+    end
+    
+    specify "should receive connect with host and port" do
+      TCPSocket.should_receive(:new).with(@host, @port).and_return(@socket)
+      Transport.connect("tcp:host=#{@host},port=#{@port}")
+    end
+  end
+
+end