✨ zb: Add a function to create a builder for IBus

zbus/Cargo.toml

@@ -26,6 +26,8 @@ camino = ["zvariant/camino"]
 bus-impl = ["p2p"]
 # Enables API that is only needed for peer-to-peer (p2p) connections.
 p2p = ["dep:rand"]
+# Enables API that is only needed for IBus Daemon.
+ibus = []
 async-io = [
   "dep:async-io",
   "async-executor",

zbus/src/connection/builder.rs

@@ -6,6 +6,8 @@ use static_assertions::assert_impl_all;
 use std::net::TcpStream;
 #[cfg(all(unix, not(feature = "tokio")))]
 use std::os::unix::net::UnixStream;
+#[cfg(feature = "ibus")]
+use std::process::Stdio;
 use std::{
     collections::{HashMap, HashSet},
     vec,
@@ -23,6 +25,9 @@ use vsock::VsockStream;
 
 use zvariant::ObjectPath;
 
+#[cfg(feature = "ibus")]
+use crate::process::Command;
+
 use crate::{
     address::{self, Address},
     names::{InterfaceName, WellKnownName},
@@ -85,6 +90,36 @@ impl<'a> Builder<'a> {
         Ok(Self::new(Target::Address(Address::system()?)))
     }
 
+    /// Create a builder for the [IBus] daemon.
+    ///
+    /// [IBus]: https://en.wikipedia.org/wiki/Intelligent_Input_Bus
+    #[cfg(feature = "ibus")]
+    pub async fn ibus() -> Result<Self> {
+        let child_process = Command::new("ibus")
+            .args(["address"])
+            .stdout(Stdio::piped())
+            .spawn()
+            .expect("Fail to call `ibus address`");
+
+        #[cfg(not(feature = "tokio"))]
+        let output = child_process
+            .output()
+            .await
+            .expect("Fail to run `ibus address`");
+
+        #[cfg(feature = "tokio")]
+        let output = child_process
+            .wait_with_output()
+            .await
+            .expect("Fail to run `ibus address`");
+
+        let ibus_address = std::str::from_utf8(&output.stdout)
+            .expect("Invalid utf8 when getting stdout")
+            .trim();
+
+        Builder::address(ibus_address)
+    }
+
     /// Create a builder for a connection that will use the given [D-Bus bus address].
     ///
     /// # Example