cargo-tribute 0.2.0

Generate a REUSE-style LICENSES/ folder and third-party attribution from a Cargo dependency tree.
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

# Contributing

Thanks for your interest in cargo-tribute.

## Development

```
cargo build
cargo test                     # unit tests for SPDX resolution
cargo clippy --all-targets     # must be clean
cargo fmt
```

Run the tool against a real tree while developing:

```
cargo run -- --manifest-path /path/to/some/Cargo.toml
```

## Adding a license

Canonical texts live in `assets/licenses/<SPDX-id>.txt` (use the SPDX-official text). To support a new license:

1. Add `assets/licenses/<id>.txt`.
2. Add the matching `include_str!` arm in `canonical_text` (`src/main.rs`).
3. Add the id to `DEFAULT_ACCEPTED` if it should be allowed out of the box.

## License resolution

`choose`/`combine` (`src/main.rs`) evaluate the SPDX expression in postfix over an accepted-license set. When you touch them, add a case to the `tests` module.

## Pull requests

- Keep `cargo fmt` and `cargo clippy --all-targets` clean.
- One focused change per pull request.

## License

By contributing, you agree that your contributions are dual licensed under [MIT](LICENSE-MIT) and [Apache-2.0](LICENSE-APACHE), matching the project.