colophon plan¶
Description¶
Show the release the current commits would produce
Compute the next version and the commits that decide it, and print them. Writes nothing: no branch, no merge request, no tag. Safe to run anywhere, and the instrument for comparing colophon against the tool it replaces before a project switches.
Usage¶
Flags¶
| Flag | Description | Default |
|---|---|---|
-C, --repo |
Path to the git repository to read | . |
plan writes nothing and needs no credentials, so it is safe to run against any
checkout.
Global flags¶
| Flag | Description | Default |
|---|---|---|
--ci |
Indicates the tool is running in a CI environment | false |
--config |
Config files to use (repeatable) | /etc/colophon/config.yaml, ~/.colophon/config.yaml |
--debug |
Force debug log output | false |
--output |
Output format: text or json |
text |
Run colophon <command> --help for the authoritative, always-current flag set.