P4CLI-20251

A simple Rust library for full-featured P4 (Perforce) CLI with zero pre-install. All errors are propagated via Result without any unwrap.

Features

• Zero pre-install — the p4 binary is embedded as a zstd-compressed asset and extracted at runtime.
• Secure — each instance uses a random-isolated temp directory; binary is written atomically (write + rename); Unix permissions are 0o700.
• Concurrent-safe — per-instance temp directories eliminate cross-process file clashes; a content-addressed disk cache avoids repeated decompression.
• Clean exit — child process is always reaped (wait()), no zombie left behind.
• Binary-safe output — raw Vec<u8> preserves any binary content; UTF-8 helpers provided for text.
• Timeout & control — P4Command builder provides timeout, cwd, env, and stdin control.
• Platform-conditional dependencies — only the current platform's binary crate is downloaded (~4–5 MB instead of ~23 MB).

Usage

[dependencies]

p4cli-20251 = "0.5.0"

Quick start

use p4cli_20251::P4Cli;

fn main() -> std::io::Result<()> {
    let p4 = P4Cli::new()?;
    let output = p4.run(&["--help"])?;
    println!("exit: {}", output.exit_code());
    println!("{}", output.stdout_str()?);
    Ok(())
}

Builder API (timeout, cwd, env, stdin)

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

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

    let output = p4
        .command()
        .arg("sync")
        .args(&["-f", "//depot/..."])
        .cwd("/workspace")
        .env("P4PORT", "ssl:perforce:1666")
        .timeout(Duration::from_secs(60))
        .run()?;

    println!("synced, exit code: {}", output.exit_code());
    Ok(())
}

P4Output inspection

let out = p4.run(&["info"])?;

// Raw bytes (binary-safe)
let stdout: &[u8] = out.stdout();
let stderr: &[u8] = out.stderr();

// UTF-8 text helpers
if let Ok(text) = out.stdout_str() {
    for line in text.lines() {
        println!("{line}");
    }
}

// Exit-code check
if out.success() {
    println!("command succeeded");
} else {
    eprintln!("failed with exit code {}", out.exit_code());
}

Supported Platforms

Only the platform-specific binary crate is downloaded as a dependency — no unnecessary bloat.