mirror of
https://github.com/clap-rs/clap
synced 2024-12-04 18:19:13 +00:00
7515bfeb51
This adds a new `Cargo.toml` feature named `deprecated` that opts controls whether deprecation warnings show up. This is starting off as non-default though that may change (see below). Benefits - Allows a staged rollout so a smaller subset of users see new deprecations and can report their experience with them before everyone sees them. For example, this reduces the number of people who have to deal with #3822. - This allows people to defer responding to each new batch of deprecations and instead do it at once. This means we should reconsider #3616. The one risk is people who don't follow blog posts and guides having a harder time upgrading to the next breaking release without the warnings on by default. For these users, we reserve the right to make the `deprecated` feature `default`. This is most likely to happen in a minor release that is released in conjunction with the next major release (e.g. when releasing 4.0.0, we release a 3.3.0 that enables deprecations by default). By using a feature, users can still disable this if they want. Thanks @joshtriplett for the idea
40 lines
1.3 KiB
Makefile
40 lines
1.3 KiB
Makefile
# CI Steps
|
|
#
|
|
# Considerations
|
|
# - Easy to debug: show the command being run
|
|
# - Leverage CI features: Only run individual steps so we can use features like reporting elapsed time per step
|
|
|
|
ARGS?=--workspace
|
|
TOOLCHAIN_TARGET ?=
|
|
ifneq (${TOOLCHAIN_TARGET},)
|
|
ARGS+=--target ${TOOLCHAIN_TARGET}
|
|
endif
|
|
|
|
MSRV?=1.56.0
|
|
|
|
_FEATURES = minimal default wasm full debug release
|
|
_FEATURES_minimal = --no-default-features --features "std"
|
|
_FEATURES_default =
|
|
_FEATURES_wasm = --features "deprecated derive cargo env unicode yaml regex unstable-replace unstable-grouped"
|
|
_FEATURES_full = --features "deprecated derive cargo env unicode yaml regex unstable-replace unstable-grouped wrap_help"
|
|
_FEATURES_next = ${_FEATURES_full} --features unstable-v4
|
|
_FEATURES_debug = ${_FEATURES_full} --features debug
|
|
_FEATURES_release = ${_FEATURES_full} --release
|
|
|
|
check-%:
|
|
cargo check ${_FEATURES_${@:check-%=%}} --all-targets ${ARGS}
|
|
|
|
build-%:
|
|
cargo test ${_FEATURES_${@:build-%=%}} --all-targets --no-run ${ARGS}
|
|
|
|
test-%:
|
|
cargo test ${_FEATURES_${@:test-%=%}} ${ARGS}
|
|
|
|
clippy-%:
|
|
cargo clippy ${_FEATURES_${@:clippy-%=%}} ${ARGS} --all-targets -- -D warnings -A deprecated
|
|
|
|
test-ui-%:
|
|
cargo +${MSRV} test --test derive_ui --features derive ${_FEATURES_${@:test-ui-%=%}}
|
|
|
|
doc:
|
|
cargo doc --workspace --all-features --no-deps --document-private-items
|