ruby-dbus-wrapper 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6c947f02da945a58458614dc90764956fabf5c08
+  data.tar.gz: 3e8c3cf136b6379b3ee37a4dc01cc6040fb0bd18
+SHA512:
+  metadata.gz: 209d043917643a7c395d7428b3d2715e62f9ff930ed5ca2863d3f24a10dfca274a5fd96c0078e881e645b4b5f1b67fe9351023dae367d82a7dff5a4cff75a275
+  data.tar.gz: 4a51c53040edb2ee3ee840bd41dd742c723fcbee6121bd9c8a8a085b74cd9222fc71a450dcfdb574a0037ec45b003a2e86c7401b136f34514407acbf8ca8c870

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 mspanc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,76 @@
+ruby-dbus-wrapper
+=================
+
+Wrapper for Ruby D-Bus client providing some useful high-level methods.
+
+# Installation
+
+## Step 1: Add Ruby D-Bus gem to your Gemfile
+
+You have to manually add your Ruby D-Bus bindings to the Gemfile because there are two gems that can
+be used and it's up to you which one you choose: original `ruby-dbus` or EventMachine-powered `em-ruby-dbus`.
+
+If you are unsure or want to use the original `ruby-dbus`, add the following line to your `Gemfile`:
+
+    gem 'ruby-dbus'
+
+If you want to use EventMachine version, add the following line to your `Gemfile`:
+
+    gem 'em-ruby-dbus'
+
+## Step 2: Add this gem to your Gemfile
+
+Just add the following line to your `Gemfile`:
+
+    gem 'ruby-dbus-wrapper'
+
+# Usage
+
+Right now this gem provides two methods, that allows to invoke method calls or watch signals without creating
+proxy objects.
+
+## Method calls
+
+    conn = DBus::SessionBus.instance
+    bus = DBus::Wrapper::Bus.new(conn)
+
+    # Without parameters
+    bus.method_call("org.freedesktop.DBus", "/", "org.freedesktop.DBus", "ListNames") do |message| 
+      # do something
+    end
+
+    # With parameters
+    bus.method_call("another.destination", "/", "some.Interface", "SomeMember", [["s", "First param"], ["a{ss}", { "Second" => "Param"}]]) do |message| 
+      # do something
+    end
+
+    main = DBus::Main.new
+    main << conn
+    main.run
+
+The arguments are: destination, path, interface, member, params = nil, &callback
+
+
+## Signal monitoring
+
+    conn = DBus::SessionBus.instance
+    bus = DBus::Wrapper::Bus.new(conn)
+
+    # Without parameters
+    bus.monitor_signal("org.freedesktop.DBus", nil, "org.freedesktop.DBus", "NameOwnerChanged") do |message|
+      # do something
+    end
+
+    main = DBus::Main.new
+    main << conn
+    main.run
+
+The arguments are: sender, path, interface, member, &callback
+
+# License
+
+MIT
+
+# Author
+
+(c) 2014 Marcin Lewandowski

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/lib/ruby-dbus-wrapper/bus.rb

@@ -0,0 +1,48 @@
+module DBus
+  module Wrapper
+    class Bus
+      attr_reader :connection
+
+      def initialize(connection)
+        @connection = connection
+      end
+
+
+      def monitor_signal(sender, path, interface, member, &callback)
+        raise ArgumentError, "You must specify interface" if interface.nil?
+        raise ArgumentError, "You must specify member"    if member.nil?
+        raise ArgumentError, "You must specify callback"  unless block_given?
+
+        match_string = "type='signal',interface='#{interface}',member='#{member}'"
+        match_string << ",path='#{path}'" unless path.nil?
+        match_string << ",sender='#{sender}'" unless sender.nil?
+
+        @connection.add_match match_string, &callback
+      end
+
+
+      def method_call(destination, path, interface, member, params = nil, &callback)
+        raise ArgumentError, "You must specify destination" if destination.nil?
+        raise ArgumentError, "You must specify path"        if path.nil?
+        raise ArgumentError, "You must specify interface"   if interface.nil?
+        raise ArgumentError, "You must specify member"      if member.nil?
+        raise ArgumentError, "You must specify callback"    unless block_given?
+
+        message = ::DBus::Message.new(::DBus::Message::METHOD_CALL)
+        message.path        = path
+        message.destination = destination
+        message.interface   = interface
+        message.member      = member
+
+        if params.is_a? Array
+          params.each do |param|
+            message.add_param param[0], param[1]
+          end
+        end
+
+        @connection.send_sync_or_async message, &callback
+      end
+    end
+  end
+end
+

data/lib/ruby-dbus-wrapper.rb

@@ -0,0 +1 @@
+require_relative "ruby-dbus-wrapper/bus"

data/ruby-dbus-wrapper.gemspec

@@ -0,0 +1,16 @@
+require "rubygems"
+require "rake"
+
+GEMSPEC = Gem::Specification.new do |s|
+  s.name = "ruby-dbus-wrapper"
+  s.summary = "High-level wrapper for Ruby D-Bus client"
+  s.description = "Wrapper for Ruby D-Bus client providing some useful high-level methods"
+  s.version = File.read("VERSION").strip
+  s.license = "MIT"
+  s.author = "Marcin Lewandowski"
+  s.email = "marcin@saepia.net"
+  s.homepage = "https://github.com/mspanc/ruby-dbus-wrapper"
+  s.files = FileList["{lib}/**/*", "LICENSE", "README.md", "ruby-dbus-wrapper.gemspec", "VERSION"].to_a.sort
+  s.require_path = "lib"
+  s.required_ruby_version = ">= 1.9.3"
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: ruby-dbus-wrapper
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Marcin Lewandowski
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-05 00:00:00.000000000 Z
+dependencies: []
+description: Wrapper for Ruby D-Bus client providing some useful high-level methods
+email: marcin@saepia.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- VERSION
+- lib/ruby-dbus-wrapper.rb
+- lib/ruby-dbus-wrapper/bus.rb
+- ruby-dbus-wrapper.gemspec
+homepage: https://github.com/mspanc/ruby-dbus-wrapper
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: High-level wrapper for Ruby D-Bus client
+test_files: []