cargo-worktree 1.0.0

Deterministic build namespace layer for Cargo
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

# cargo-worktree
[![crates.io](https://img.shields.io/crates/v/cargo-worktree.svg)](https://crates.io/crates/cargo-worktree)

`cargo-worktree` is a thin Cargo wrapper for git worktrees.

It keeps Cargo's normal behavior, but isolates `target/` by branch or commit so parallel worktrees do not block or overwrite each other's build output.

## Goals

Cargo shares one `target/` by default. That is fine for one branch, but in a worktree workflow it can cause:

- build output being overwritten
- incorrect incremental reuse
- noisy concurrent builds and tests
- parallel builds (multiple worktrees) contend on the same directory

`cargo-worktree` keeps Cargo's command line familiar, but makes the output path worktree-aware.


## Install

```bash
cargo install cargo-worktree
```

Or install from a local checkout:

```bash
cargo install --path .
```

## Use

Use it like Cargo:

```bash
cargo worktree build
cargo worktree test
cargo worktree run
cargo worktree check
cargo worktree clippy
cargo worktree bench
cargo worktree fmt

```

Anything else is forwarded too:

```bash
cargo worktree clean
cargo worktree test -- --nocapture
cargo worktree clippy -- -D warnings
cargo worktree metadata --format-version 1
```

## Target layout

- Branch checkout: `target/git/<branch>`
- Detached HEAD: `target/git/<commit>`
- Not in git: use Cargo's default `target/`

Check what the wrapper resolved with:

```bash
cargo worktree inspect
```

## License

MIT