pybuilder / pybuilder / 23886302068

83%

Build Type

push

github

Committed by web-flow

Commit Message

Add --project-info (-i) CLI option for JSON project configuration dump [release] (#946)

## Summary

- Adds `pyb -i` / `pyb --project-info` that outputs the full project
configuration as pretty-printed JSON to stdout without running a build
- Runs plugin initializers to populate all properties but does not
execute any tasks or create build/test venvs
- Log messages go to stderr (via new `StdErrLogger` /
`ColoredStdErrLogger` classes) so stdout is always clean, parseable JSON
- Mutually exclusive with `-t`, `-T`, `--start-project`,
`--update-project`

### JSON output includes:
- Project metadata (name, version, authors, license, URLs, etc.)
- All build properties (built-in + plugin-defined, after initializers
run)
- Loaded plugins
- Runtime, build, plugin, and extras dependencies
- Available tasks with descriptions and dependency graphs
- Manifest files, package data, files to install

### Usage:
```bash
pyb -i 2>/dev/null | jq .project.name
pyb -i -E ci -P verbose=true 2>/dev/null | jq .properties
```

## Test plan

- [x] 678 unit tests pass (including new tests for option parsing,
stderr logging, serialization, JSON output)
- [x] 3 cram tests pass (help output updated, new project-info cram
test, existing no-build test)
- [x] `pyb -i | python -m json.tool` produces valid JSON
- [x] `pyb -i -X 2>log.txt` sends debug logs to stderr, JSON to stdout
- [x] `pyb -i -t` rejected as mutually exclusive

Coverage Stats

1426 of 1888 branches covered (75.53%)

Branch coverage included in aggregate %.

54 of 72 new or added lines in 1 file covered. (75.0%)

1 existing line in 1 file now uncovered.

5606 of 6596 relevant lines covered (84.99%)

33.05 hits per line