processkit 0.9.1

Child-process management: kill-on-drop process trees and async run-and-capture
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

//! Wrap an external CLI behind a typed API with the `cli_client!` macro. The
//! generated type carries a [`ProcessRunner`], so the *same* wrapper is testable
//! with a `ScriptedRunner` (no subprocess) — see `docs/testing.md`.
//!
//! Run with: `cargo run --example cli_client` (inside a git repository)

use processkit::{ProcessRunner, Result, cli_client};

cli_client!(
    /// Typed wrapper around the `git` CLI.
    pub struct Git => "git"
);

impl<R: ProcessRunner> Git<R> {
    /// The current branch name (`git branch --show-current`).
    pub async fn current_branch(&self) -> Result<String> {
        self.core
            .run(self.core.command(["branch", "--show-current"]))
            .await
    }

    /// Whether the working tree is clean (`git diff --quiet` → exit 0).
    pub async fn is_clean(&self) -> Result<bool> {
        self.core
            .probe(self.core.command(["diff", "--quiet"]))
            .await
    }
}

#[tokio::main]
async fn main() -> Result<()> {
    let git = Git::new(); // real runner; tests would use `Git::with_runner(scripted)`
    println!("on branch: {}", git.current_branch().await?);
    println!("working tree clean: {}", git.is_clean().await?);
    Ok(())
}