rbus 0.1.0

data/examples/network_manager_get_properties.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/env ruby
+#--
+# 
+# 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.
+#
+#++
+#
+#
+# RBus Example:
+# Get properties from Network Manager interface
+# From the Python D-Bus tutorial
+#
+# I have no idea what most of those values are, though :)
+#
+
+
+# Add lib to load path during developmennt
+$: << '../lib/'
+
+require 'pp'
+require 'rbus'
+
+# eth1 is the wireless on my machine,
+# eth0 may be the most common one to try
+dev = 'eth1'
+
+bus = RBus.system_bus()
+
+device = bus.get_object('org.freedesktop.NetworkManager', "/org/freedesktop/NetworkManager/Devices/#{dev}")
+device.interface!('org.freedesktop.NetworkManager.Devices')
+
+# Pretty print
+pp device.getProperties()

data/examples/notification_bubble.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/env ruby
+#--
+# 
+# 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.
+#
+#++
+#
+#
+# RBus Example:
+# Display notification bubble
+#
+
+
+# Add lib to load path during developmennt
+$: << '../lib/'
+
+require 'rbus'
+
+session_bus = RBus.session_bus()
+
+notify = session_bus.get_object('org.freedesktop.Notifications','/org/freedesktop/Notifications')
+notify.interface!('org.freedesktop.Notifications')
+
+# app_name, id, icon, summary, body, actions, hints, timeout
+# icon should be able to be the name of a stock-icon, an url or a pixmap,
+# but I have only tried stock so far, in this case stock-info.
+return_id =
+  notify.Notify('R-Bus',0,'info','R-Bus Notification',
+                'A test example to see that everything works.',[],{},-1)

data/examples/rhythmbox_print_playing_uri.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+#--
+# 
+# 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.
+#
+#++
+#
+#
+# RBus Example:
+# Print the URI of the currently playing song in Rhythmbox.
+#
+
+
+# Add lib to load path during developmennt
+$: << '../lib/'
+
+require 'rbus'
+
+session_bus = RBus.session_bus()
+
+rb = session_bus.get_object('org.gnome.Rhythmbox', '/org/gnome/Rhythmbox/Player')
+rb.interface!('org.gnome.Rhythmbox.Player')
+
+puts rb.getPlayingUri()

data/examples/rhythmbox_signal_print_playing.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+#--
+# 
+# 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.
+#
+#++
+#
+#
+# RBus Example:
+# Print some info about the song each time a new is played in Rhythmbox.
+#
+
+
+# Add lib to load path during developmennt
+$: << '../lib/'
+
+require 'rbus'
+Thread.abort_on_exception=true
+
+session_bus = RBus.session_bus()
+
+rb_player = session_bus.get_object('org.gnome.Rhythmbox', '/org/gnome/Rhythmbox/Player')
+rb_player.interface!('org.gnome.Rhythmbox.Player')
+
+rb_shell = session_bus.get_object('org.gnome.Rhythmbox', '/org/gnome/Rhythmbox/Shell')
+rb_shell.interface!('org.gnome.Rhythmbox.Shell')
+
+rb_player.connect!("playingUriChanged") { |uri|
+  properties = rb_shell.getSongProperties(uri)
+  duration = Time.at(properties['duration'].to_i).strftime("%M:%S")
+  artist = properties['artist']
+  title = properties['title']
+  puts "Now playing: #{artist} - #{title} (#{duration})"
+  printf "File-size: %.2f MB\n", properties['file-size'].to_f/1024/1024
+}
+
+RBus.mainloop

data/examples/rhythmbox_start_service.rb

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+#--
+# 
+# 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.
+#
+#++
+#
+#
+# RBus Example:
+# Start Rhythmbox and "press play"
+#
+
+# Add lib to load path during developmennt
+$: << '../lib/'
+
+require 'rbus'
+
+session_bus = RBus.session_bus()
+retval = session_bus.StartServiceByName('org.gnome.Rhythmbox', 0)
+
+rb = session_bus.get_object('org.gnome.Rhythmbox', '/org/gnome/Rhythmbox/Player')
+rb.playPause(true)

data/examples/rhythmbox_toggle_playing.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/env ruby
+#--
+# 
+# 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.
+#
+#++
+#
+#
+# RBus Example:
+# Toggle play/pause in Rhythmbox.
+#
+
+
+# Add lib to load path during developmennt
+$: << '../lib/'
+
+require 'rbus'
+
+session_bus = RBus.session_bus()
+rb = session_bus.get_object('org.gnome.Rhythmbox', '/org/gnome/Rhythmbox/Player')
+rb.interface!('org.gnome.Rhythmbox.Player')
+
+# Get current status and print what we are about to do
+puts rb.getPlaying() ? 'Pausing...' : 'Playing...'
+
+# playPause takes a mandatory boolean, but just
+# toggles play/pause regardless of the value.
+# This might be a bug.
+rb.playPause(true)

data/lib/rbus.rb

@@ -0,0 +1,25 @@
+#--
+# 
+# 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__) + '/rbus/default'

data/lib/rbus/auth/auth.rb

@@ -0,0 +1,53 @@
+#--
+# 
+# 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.
+#
+#++
+#
+Dir[File.join(File.dirname(__FILE__), '*.rb')].sort.each { |lib| require lib }
+
+module RBus
+  module Auth
+    
+    MECHANISMS = {
+      'EXTERNAL' => External,
+      'DBUS_COOKIE_SHA1' => DBusCookieSHA1
+    }
+    FIRST_MECHANISM = Dummy
+    
+    # Authorize with the bus via its Transport object.
+    def self.authorize(transport)  
+      raise AuthException, 'transport is nil' if transport.nil?
+      
+      # Init Auth process
+      transport.send("\0")
+      
+      # use a statemachine as the spec suggests
+      state_machine = StateMachine.new(transport)
+      begin
+        # return server guid on success - not used today though.
+        return state_machine.authorize
+      rescue AuthException
+        transport.close
+        raise
+      end
+    end    
+  end
+end

data/lib/rbus/auth/dbus_cookie_sha1.rb

@@ -0,0 +1,66 @@
+#--
+# 
+# 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 Auth
+  
+    # Implements the AUTH DBUS_COOKIE_SHA1 mechanism.
+    class DBusCookieSHA1
+      
+      def auth
+        require 'etc'
+        
+        ['DBUS_COOKIE_SHA1', Etc.getlogin, :DATA]
+      end
+
+      def data(data)
+        require 'digest/sha1'
+                
+        # name of cookie file, id of cookie in file, servers random challenge  
+        context, id, s_challenge = data.split(' ')
+        
+        # Random client challenge        
+        c_challenge = Array.new(s_challenge.length/2).map{|obj|obj=rand(255).to_s}.join
+        
+        # Search cookie file for id
+        path = File.join(ENV['HOME'], '.dbus-keyrings', context)
+        File.foreach(path) do |line|
+          if line.index(id) == 0
+            
+            # Right line of file, read cookie
+            cookie = line.split(' ')[2].chomp
+            
+            # Concatenate and encrypt
+            to_encrypt = [s_challenge, c_challenge, cookie].join(':')
+            sha = Digest::SHA1.hexdigest(to_encrypt)
+            
+            # Return response
+            return ["#{c_challenge} #{sha}", :OK]
+          end
+        end
+        
+        raise AuthException, 'Unable to locate cookie'
+      end  
+    end
+  end
+end

data/lib/rbus/auth/dummy.rb

@@ -0,0 +1,37 @@
+#--
+# 
+# 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 Auth
+    
+    # This is a Dummy Auth mechanism used first to get supported
+    # mechanisms from server. It's possible to just chance it
+    # and start with one of the other directly.
+    # Set RBus::Auth::FIRST_MECHANISM to proper class to override
+    class Dummy      
+      def auth(data = nil)
+        [nil, nil, :REJECTED]
+      end     
+    end      
+  end
+end