dcr 0.7.3

DCR is a utility for managing C/C++ projects in a Cargo-like style.
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

---
sidebar_label: Workspaces
---

# Workspaces

Workspaces allow managing multiple packages in a single repository.

## Configuration

```toml
[workspace.lib-core]
path = "lib-core"

[workspace.lib-utils]
path = "lib-utils"
deps = ["lib-core"]

[workspace.app]
path = "app"
deps = ["lib-core", "lib-utils"]
main = true
```

### Member fields

| Field | Description |
|-------|-------------|
| `path` | Path to the package (relative to workspace root) |
| `deps` | Dependencies on other members |
| `main` | Mark as the main package |

## Topological sort

DCR automatically sorts packages by dependencies: package A is built before B if B depends on A.

Cyclic dependencies are detected and cause an error.

## Build

```bash
dcr build                    # build all packages in dependency order
dcr build --workspace app    # build only app (dependencies built automatically)
```

When building a workspace, member outputs (libraries) are automatically added to include/lib paths of dependent packages.

## Clean

```bash
dcr clean                    # clean only root target/
dcr clean --all              # clean target/ of all packages
```

## Inheritance

If a member has `inherit = true` in its `[build]` section, fields from the root `[build]` are merged into the member:

```toml
# root dcr.toml
[build]
inherit = true
language = "c"
standard = "c17"

# member inherits language and standard
```