ruby-dbus 0.22.1 → 0.23.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9faf3489c1ee5baf70dbb2204b777c577d6237554f072fa44bfdbee49c34e06d
-  data.tar.gz: '08c81cc0acde47f38e19b107222692253fe1b512c7f1bb5698e074c63601b85b'
+  metadata.gz: c671b06e04452129a899cd4b7877cf43f9c05b8e7bc6597e75bc460e250c97e7
+  data.tar.gz: 18f660c6e5804fd133cf8351d801f8e0d4e332f1473cc390bedf77341d71845d
 SHA512:
-  metadata.gz: bf539a91b1420631d7614b83636502f4c41e4ff7f137fb2c54eff88bc6b2810bb53efa14cadd8a5bb28b71864abbb0cd35451202c60f83a78b3e58816aa6fb67
-  data.tar.gz: aa1e225fe3177c63761d8e487b70a688b45330e4f115aa52753fc08f4f194949a206da8e1d102c3f55f49d169a2688bed67d5497639e3da9652f887f3bad5768
+  metadata.gz: 5cff2ab01f4db3d069a73b28f46cf861dcc81302ed239a7fc4332f46a7583b2394d679d5d73ab13f080b674e46f8961c89fa3fccc58ce9043d0bd33c4c2d02c4
+  data.tar.gz: 495c060e5161c2c5267b723598d3185b14d4c6517e41504f5b49971d3c355acec1ee3ab6285b7796bb7aa8cb61dfb5bd24535a2613a9f22cfb80f65ec8a1cf49

data/NEWS.md

@@ -2,6 +2,44 @@
 
 ## Unreleased
 
+## Ruby D-Bus 0.23.0.beta2 - 2023-06-23
+
+License:
+ * clarified to be LGPL-2.1-or-later
+
+API:
+ * DBus::Object#object_server replaces @service (which still works) and the short-lived
+   @connection
+ * ObjectServer#export will raise if the path is already taken by an object
+ * ObjectServer#unexport now also accepts an object path
+ * Connection#object_server can export objects even without requesting any
+   service name ([#49][], in beta1 already).
+ * Add PeerConnection for connections without a bus, useful for PulseAudio.
+   Fix listening for signals there ([#44][]).
+ * Moved from Connection to BusConnection: #unique_name, #proxy, #service.
+   Call send_hello in BusConnection#initialize already.
+
+Bug fixes:
+ * Fixed a refactoring crasher bug in ProxyService#introspect (oops).
+ * Fix crash on #unexport of /child_of_root or even /
+
+[#44]: https://github.com/mvidner/ruby-dbus/issues/44
+[#49]: https://github.com/mvidner/ruby-dbus/issues/49
+
+## Ruby D-Bus 0.23.0.beta1 - 2023-06-05
+
+Bug fixes:
+ * A service can now have more than one name ([#69][]).
+   Connection#request_service is deprecated in favor of Connection#object_server
+   and BusConnection#request_name
+
+[#69]: https://github.com/mvidner/ruby-dbus/issues/69
+
+API:
+ * Remove Service, splitting it into ProxyService and ObjectServer
+ * Split off BusConnection from Connection
+ * DBus::Object @service replaced by @connection
+
 ## Ruby D-Bus 0.22.1 - 2023-05-17
 
 Bug fixes:

data/VERSION

@@ -1 +1 @@
-0.22.1
+0.23.0.beta2

data/doc/Reference.md

@@ -23,8 +23,8 @@ is simply "dbus"
 #### Calling Methods
 
 1. {DBus.session_bus Connect to the session bus};
-2. {DBus::Connection#[] get the screensaver service}
-3. {DBus::Service#[] and its screensaver object}.
+2. {DBus::BusConnection#[] get the screensaver service}
+3. {DBus::ProxyService#[] and its screensaver object}.
 4. Call one of its methods in a loop, solving [xkcd#196](http://xkcd.com/196).
 
  
@@ -58,7 +58,7 @@ a method proxy always returned an array of values. This was to
 accomodate the rare cases of a DBus method specifying more than one
 *out* parameter. For compatibility, the behavior is preserved if you
 construct a {DBus::ProxyObject} with {DBus::ApiOptions::A0},
-which is what {DBus::Service#object} does.
+which is what {DBus::ProxyService#object} does.
 
 For nearly all methods you used `Method[0]` or
 `Method.first`
@@ -340,8 +340,8 @@ for overriding this.
     obj = Note.new("/net/vidner/Example/Properties")
 
     bus = DBus::SessionBus.instance
-    service = bus.request_service("net.vidner.Example")
-    service.export(obj)
+    bus.object_server.export(obj)
+    bus.request_name("net.vidner.Example")
 
     main = DBus::Main.new
     main << bus

data/examples/no-bus/pulseaudio.rb

@@ -0,0 +1,50 @@
+#! /usr/bin/env ruby
+# frozen_string_literal: true
+
+# find the library without external help
+$LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
+
+require "dbus"
+
+def peer_address
+  bus = DBus::SessionBus.instance
+  svc = bus["org.PulseAudio1"]
+  obj = svc["/org/pulseaudio/server_lookup1"]
+  ifc = obj["org.PulseAudio.ServerLookup1"]
+  adr = ifc["Address"]
+  puts "PA address: #{adr}"
+  adr
+end
+
+address = peer_address
+begin
+  conn = DBus::PeerConnection.new(address)
+rescue Errno::ENOENT
+  puts "Address exists but could not connect; telling PA to load the protocol"
+  system "pactl load-module module-dbus-protocol"
+  conn = DBus::PeerConnection.new(address)
+end
+no_svc = conn.peer_service
+obj = no_svc["/org/pulseaudio/core1"]
+ifc = obj["org.PulseAudio.Core1"]
+puts "PA version: #{ifc["Version"]}"
+
+puts "Waiting for volume changes, try adjusting it. Ctrl-C to exit."
+
+vol_ifc = "org.PulseAudio.Core1.Device"
+vol_member = "VolumeUpdated"
+# PA needs explicit enabling of signals
+ifc.ListenForSignal("#{vol_ifc}.#{vol_member}", [])
+
+match_rule = DBus::MatchRule.new
+match_rule.interface = vol_ifc
+match_rule.member = vol_member
+conn.add_match(match_rule) do |msg|
+  # a single argument that is an array
+  volumes = msg.params[0]
+  puts "VolumeUpdated: #{volumes.join(", ")}"
+end
+
+loop = DBus::Main.new
+loop << conn
+loop.run

data/examples/service/complex-property.rb

@@ -16,6 +16,6 @@ class Test < DBus::Object
 end
 
 bus = DBus::SessionBus.instance
-svc = bus.request_service("net.vidner.Scratch")
-svc.export(Test.new("/net/vidner/Scratch"))
+bus.object_server.export(Test.new("/net/vidner/Scratch"))
+bus.request_name("net.vidner.Scratch")
 DBus::Main.new.tap { |m| m << bus }.run

data/examples/service/service_newapi.rb

@@ -31,9 +31,9 @@ class Test < DBus::Object
 end
 
 bus = DBus::SessionBus.instance
-service = bus.request_service("org.ruby.service")
 myobj = Test.new("/org/ruby/MyInstance")
-service.export(myobj)
+bus.object_server.export(myobj)
+bus.request_name("org.ruby.service")
 
 Thread.new do
   i = 0