CLI Changes 0.12.0

[pinkforest]

I thought it would be good to keep #226 solely as tracking changes for 0.12.0

We can discuss here for all the pros/cons outside sub-issues.

[pinkforest]

0.11.2 / 0.12.0 Changes w/ Cargo de-couple

For 0.12.0 - All Passthru options shall be dynamically handled with minimal/no-maintenance

This is to document the expected impact(s) and extract some test coverage

Cargo - Package - Same -> Passthru

-p, --package <SPEC> Package to be used as the root of the tree. - geiger 0.11.2
-p, --package <SPEC>... Package to build (see cargo help pkgid) - cargo 1.59.0-nightly

Cargo - Features - Same except comma -> Passthru

--features <FEATURES> Space-separated list of features to activate. - geiger 0.11.2
--features <FEATURES>... Space **or comma** separated list of features to activate - cargo 1.59.0-nightly

--all-features Activate all available features. -geiger 0.11.2
--all-features Activate all available features - cargo 1.59.0-nightly

--no-default-features Do not activate the defaultfeature. - geiger 0.11.2
--no-default-features Do not activate the default feature - cargo 1.59.0-nightly

Cargo - Target - 1 new Passthru -> Passthru & Intercept --target-dir

--target <TARGET> Set the target triple. - geiger 0.11.2
--target <TRIPLE>... Build for the target triple - cargo 1.59.0-nightly

--target-dir <DIRECTORY> Directory for all generated artifacts - cargo 1.59.0-nightly 🆕 for geiger Passthru

--all-targets Return dependencies for all targets. By default only the host target is matched. - geiger 0.11.2
--all-targets Build all targets - cargo 1.59.0-nightly

Cargo - Manifest -> Passthru & Intercept

--manifest-path Path to Cargo.toml. - geiger 0.11.2

Cargo - Invert -> Passthru

-i, --invert Invert the tree direction. - geiger 0.11.2

Geiger - Display Opts

--no-indent Display the dependencies as a list (ratherthan a tree). - geiger 0.11.2
--prefix-depth Display the dependencies as a list (rather than a tree), but prefixed with the depth. - geiger 0.11.2
-a, --all Don't truncate dependencies that have already been displayed. - geiger 0.11.2
--format Format string used for printing dependencies [default: {p}]. - geiger 0.11.2
--output-format Output format for the report: Ascii, GitHubMarkdown, Json, Utf8, Ratio [default: Utf8] - geiger 0.11.2
--color Coloring: auto, always, never. - geiger 0.11.2

Geiger - README.md Update

--update-readme Writes output to ./README.md. Looks for a Safety Report section, replaces if found, adds if not. Throws an error if no README.md exists. - geiger 0.11.2
--readme-path Path of README.md file to be written to. - geiger 0.11.2
--section-name The section name in the README.md to be written to. - geiger 0.11.2

Cargo/Geiger - Verbosity

-v, --verbose Use verbose output (-vv very verbose/build.rs output). - geiger 0.11.2
-q, --quiet No output printed to stdout other than the tree. - geiger 0.11.2

Cargo - .lock handling

--frozen Require Cargo.lock and cache are up to date. - geiger 0.11.2
--locked Require Cargo.lock is up to date. - geiger 0.11.2

Cargo - Offline

--offline Run without accessing the network. - geiger 0.11.2

Cargo -Z Flags

-Z "..." Unstable (nightly-only) flags to Cargo. - geiger 0.11.2

Geiger - Dependency Inclusions -- DEPRECATED (Exit with an error)

--include-tests Count unsafe usage in tests. - geiger 0.11.2
--build-dependencies Also analyze build dependencies. - geiger 0.11.2
--dev-dependencies Also analyze dev dependencies. - geiger 0.11.2
--all-dependencies Analyze all dependencies, including build and dev. - geiger 0.11.2

Geiger --forbid-only - DEPRECATED (Exit with an error)

--forbid-only Don't build or clean anything, only scan entry point .rs source files for forbid(unsafe_code) flags. This is significantly faster than the default scanning mode. TODO: Add ability to combine this with a whitelist for use in CI. - geiger 0.11.2

Geiger --forbid - :New: to replace --forbid-only via cargo geiger scan

--forbid Scan for forbid only to exit with relevant forbid status- geiger 0.12.0 (proposed)
feedback welcome how to add whitelist pattern

Cargo/Geiger - Informational - Ouputs of these naturally will change

-h, --help Prints help information. - geiger 0.11.2
-V, --version Prints version information. - geiger 0.11.2