aqc-git-helpers 0.2.0

Read-only git worktree state (porcelain v1) for lock/verify flows.
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
37
38
39
40
41
42
43
44
45

//! Read-only Git worktree state for Specular lock/verify.
//!
//! Runs `git status --porcelain=v1 -z` as a subprocess and parses the
//! NUL-separated records. No commits, merges, or object-database access.
//! Disk existence is `aqc-filetree`; Git change detection is this crate.
//! Contract: `plan.md` in this directory.

#![expect(
    clippy::type_complexity,
    reason = "Result<Vec<...>, Error> return shapes exceed the strict workspace threshold; the shapes are the crate's declared contract, stated openly rather than aliased away."
)]

// Dev-dependency linked into the lib's test build but exercised only by the
// integration tests in `tests/`.
#[cfg(test)]
use tempfile as _;

mod error;
mod git;
mod porcelain;
mod queries;
mod status;

#[cfg(feature = "api")]
pub use error::GitError;
#[cfg(feature = "api")]
pub use git::worktree_changes;
#[cfg(feature = "api")]
pub use porcelain::parse_porcelain_v1z;
#[cfg(feature = "api")]
pub use queries::changes_affecting_paths;
#[cfg(feature = "api")]
pub use queries::dirty_paths;
#[cfg(feature = "api")]
pub use queries::is_worktree_clean;
#[cfg(feature = "api")]
pub use status::ChangeStatus;
#[cfg(feature = "api")]
pub use status::ColumnChange;
#[cfg(feature = "api")]
pub use status::PORCELAIN_VERSION;
#[cfg(feature = "api")]
pub use status::PorcelainOptions;
#[cfg(feature = "api")]
pub use status::WorktreeChange;