clap/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.1

_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
chore(ci): Reduce scope 2021-11-17 19:55:28 +00:00			`# 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`

chore(ci): Run build/test all crates 2021-11-23 22:10:32 +00:00			`ARGS?=--workspace`
chore(ci): Reduce scope 2021-11-17 19:55:28 +00:00			`TOOLCHAIN_TARGET ?=`
			`ifneq (${TOOLCHAIN_TARGET},)`
			`ARGS+=--target ${TOOLCHAIN_TARGET}`
			`endif`

chore: Bump MSRV from 1.56.0 to 1.56.1 Being a patch release, I'm fine doing this outside of a minor release. This avoids us having to deal with indexmap having a higher MSRV. 2022-06-17 14:01:43 +00:00			`MSRV?=1.56.1`
refactor(ci): Move ui tests to Makefile 2022-02-23 15:03:18 +00:00
chore(ci): Lint small feature sets 2021-12-08 03:18:35 +00:00			`_FEATURES = minimal default wasm full debug release`
test: Verify examples based on feature flags 2021-11-23 21:59:56 +00:00			`_FEATURES_minimal = --no-default-features --features "std"`
chore(ci): Reduce scope 2021-11-17 19:55:28 +00:00			`_FEATURES_default =`
fix: Allow people to opt-in to deprecations 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 2022-06-14 14:54:41 +00:00			`_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"`
feat(help): Show PossibleValue help in `--help` (#3503) `-h` (short help) still shows the same. This gates it behind an `unstable-v4` feature flag to avoid disrupting users who set the help without knowing where all it shows up (particularly derive users where `ArgEnum` is automatically extracting the help). Fixes #3312 2022-03-02 15:15:28 +00:00			`_FEATURES_next = ${_FEATURES_full} --features unstable-v4`
chore(ci): Reduce scope 2021-11-17 19:55:28 +00:00			`_FEATURES_debug = ${_FEATURES_full} --features debug`
			`_FEATURES_release = ${_FEATURES_full} --release`

			`check-%:`
refactor(ci): Offer more flexibility 2021-11-18 17:52:09 +00:00			`cargo check ${_FEATURES_${@:check-%=%}} --all-targets ${ARGS}`
chore(ci): Reduce scope 2021-11-17 19:55:28 +00:00
			`build-%:`
chore(ci): Test benchmarks 2021-11-23 22:09:31 +00:00			`cargo test ${_FEATURES_${@:build-%=%}} --all-targets --no-run ${ARGS}`
chore(ci): Reduce scope 2021-11-17 19:55:28 +00:00
			`test-%:`
chore: Make makefile easier to use 2021-12-07 14:24:13 +00:00			`cargo test ${_FEATURES_${@:test-%=%}} ${ARGS}`
chore(ci): Lint small feature sets 2021-12-08 03:18:35 +00:00
			`clippy-%:`
chore: Upgrade boilerplate 2022-02-15 18:36:19 +00:00			`cargo clippy ${_FEATURES_${@:clippy-%=%}} ${ARGS} --all-targets -- -D warnings -A deprecated`
refactor(ci): Move ui tests to Makefile 2022-02-23 15:03:18 +00:00
feat(derive): Start `unstable-v4` feature flag This is split out of #3661 as several changes I'm working on need it. 2022-04-26 14:01:44 +00:00			`test-ui-%:`
			`cargo +${MSRV} test --test derive_ui --features derive ${_FEATURES_${@:test-ui-%=%}}`
chore: Make it easy to reproduce CI docs run 2022-06-03 16:01:53 +00:00
			`doc:`
			`cargo doc --workspace --all-features --no-deps --document-private-items`