P4CLI-20251

A simple Rust library for full-featured P4 (Perforce) CLI with zero pre-install, already battle-tested and mature in production environments, where all errors are propagated via Result without any unwrap.

[dependencies]

p4cli-20251 = "0.5.3"

Synchronous API

Block until the process exits, then inspect the collected output.

use p4cli_20251::P4Cli;

fn main() -> std::io::Result<()> {
    let p4: P4Cli = P4Cli::new()?;
    let output: p4cli_20251::P4Output = p4.run(&["--help"])?;

    println!("exit: {}", output.exit_code());
    println!("{}", output.stdout_str()?);
    Ok(())
}

With timeout, working directory and environment variables via builder:

use p4cli_20251::P4Cli;
use std::time::Duration;

fn main() -> std::io::Result<()> {
    let p4: P4Cli = P4Cli::new()?;
    let output: p4cli_20251::P4Output = p4
        .command()
        .arg("info")
        .env("P4PORT", "ssl:perforce:1666")
        .timeout(Duration::from_secs(10))
        .run()?;

    if output.success() {
        println!("{}", output.stdout_str()?);
    }
    Ok(())
}

Streaming API

Iterate over raw byte chunks as they arrive. The stream ends with P4StreamEvent::Exit.

use p4cli_20251::{P4Cli, P4StreamEvent};

fn main() -> std::io::Result<()> {
    let p4: P4Cli = P4Cli::new()?;

    for event in p4.stream(&["info"])? {
        match event? {
            P4StreamEvent::Stdout(chunk) => {
                // Decode as UTF-8 (or other encoding)
                if let Ok(text) = std::str::from_utf8(&chunk) {
                    print!("{text}");
                }
            }
            P4StreamEvent::Stderr(chunk) => {
                if let Ok(text) = std::str::from_utf8(&chunk) {
                    eprint!("{text}");
                }
            }
            P4StreamEvent::Exit(code) => println!("exit {code}"),
        }
    }
    Ok(())
}

Drop the stream mid-way to cancel the process.

License

This project is licensed under the MIT License — see the LICENSE file for details.

Embedded Perforce Binary

This crate bundles the Perforce (Helix Core) command-line client (p4) binary for each supported platform. The p4 binary is proprietary software owned by Perforce Software, Inc. Use of the bundled binary is subject to Perforce's Master Terms & Conditions and P4 Supplemental Terms.