added api examples for rust

Fixes: #566

Adds the missing api examples for rust on how to
use BlueChi's D-Bus API.

Signed-off-by: Michael Engel <mengel@redhat.com>

Makefile

@@ -5,7 +5,7 @@ BUILDDIR=builddir
 
 CODESPELL_PARAMS=\
 	-S Makefile,imgtype,copy,AUTHORS,bin,.git,CHANGELOG.md,changelog.txt,.cirrus.yml,"*.xz,*.gz,*.tar,*.tgz,*ico,*.png,*.1,*.5,*.orig,*.rej,*.xml,*xsl",build.ninja,intro-targets.json,./tests/tests/tier0/proxy-service-fails-on-typo-in-file/systemd/simple.service,tags,./builddir,./subprojects,\
-	-L keypair,flate,uint,iff,od,ERRO
+	-L keypair,flate,uint,iff,od,ERRO,crate
 
 build:
 	meson setup $(BUILDDIR)

doc/api-examples/rust/.gitignore

@@ -0,0 +1 @@
+target/

doc/api-examples/rust/Cargo.toml

@@ -0,0 +1,46 @@
+[package]
+name = "bluechi"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+clap = { version = "4.4.6", features = ["derive"] }
+dbus = "0.9.7"
+
+[[bin]]
+name = "enable-unit"
+path = "enable-unit.rs"
+
+[[bin]]
+name = "get-cpuweight"
+path = "get-cpuweight.rs"
+
+[[bin]]
+name = "list-node-units"
+path = "list-node-units.rs"
+
+[[bin]]
+name = "list-nodes"
+path = "list-nodes.rs"
+
+[[bin]]
+name = "monitor-agent-connection"
+path = "monitor-agent-connection.rs"
+
+[[bin]]
+name = "monitor-node-connections"
+path = "monitor-node-connections.rs"
+
+[[bin]]
+name = "monitor-unit"
+path = "monitor-unit.rs"
+
+[[bin]]
+name = "set-cpuweight"
+path = "set-cpuweight.rs"
+
+[[bin]]
+name = "start-unit"
+path = "start-unit.rs"

doc/api-examples/rust/enable-unit.rs

@@ -0,0 +1,57 @@
+// SPDX-License-Identifier: MIT-0
+
+use clap::Parser;
+use dbus::blocking::Connection;
+use dbus::Path;
+use std::time::Duration;
+
+#[derive(Parser)]
+struct Cli {
+    /// The node name to list the units for
+    #[clap(short, long)]
+    node_name: String,
+
+    /// The names of the units to enable. Names are separated by ','.
+    #[clap(short, long, value_delimiter = ',')]
+    unit_names: Vec<String>,
+}
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let args = Cli::parse();
+
+    let conn = Connection::new_system()?;
+
+    let bluechi = conn.with_proxy(
+        "org.eclipse.bluechi",
+        "/org/eclipse/bluechi",
+        Duration::from_millis(5000),
+    );
+
+    let (node,): (Path,) =
+        bluechi.method_call("org.eclipse.bluechi.Manager", "GetNode", (args.node_name,))?;
+
+    let node_proxy = conn.with_proxy("org.eclipse.bluechi", node, Duration::from_millis(5000));
+
+    let (carries_install_info, changes): (bool, Vec<(String, String, String)>) = node_proxy
+        .method_call(
+            "org.eclipse.bluechi.Node",
+            "EnableUnitFiles",
+            (args.unit_names, false, false),
+        )?;
+
+    if carries_install_info {
+        println!("The unit files included enablement information");
+    } else {
+        println!("The unit files did not include any enablement information");
+    }
+
+    for (op_type, file_name, file_dest) in changes {
+        if op_type == "symlink" {
+            println!("Created symlink {} -> {}", file_name, file_dest);
+        } else if op_type == "unlink" {
+            println!("Removed '{}'", file_name);
+        }
+    }
+
+    Ok(())
+}