v1.0.151

Compare Source

• Update serde::{ser,de}::StdError to re-export core::error::Error when serde is built with feature="std" off and feature="unstable" on (#​2344)

v1.21.2

Compare Source

1.21.2 (September 27, 2022)

This release removes the dependency on the once_cell crate to restore the MSRV of 1.21.x, which is the latest minor version at the time of release. (#​5048)

v3.2.17

[3.2.17] - 2022-08-12

Fixes

• (derive) Expose #[clap(id = ...)] attribute to match Arg's latest API

v1.20.1

Compare Source

v3.2.1

Compare Source

v3.2.0

Compare Source

Features

• Parsed, typed arguments via Arg::value_parser / ArgMatches::{get_one,get_many} (#​2683, #​3732)
  • Several built-in TypedValueParsers available with an API open for expansion
  • value_parser!(T) macro for selecting a parser for a given type (#​3732) and open to expansion via the ValueParserFactory trait (#​3755)
  • [&str] is implicitly a value parser for possible values
  • All ArgMatches getters do not assume required arguments (#​2505)
  • Add ArgMatches::remove_* variants to transfer ownership
  • Add ArgMatches::try_* variants to avoid panics for developer errors (#​3621)
  • Add a get_raw to access the underlying OsStrs
  • PathBuf value parsers imply ValueHint::AnyPath for completions (#​3732)
• Explicit control over parsing via Arg::action (#​3774)
  • ArgAction::StoreValue: existing takes_value(true) behavior
  • ArgAction::IncOccurrences: existing takes_value(false) behavior
  • ArgAction::Help: existing --help behavior
  • ArgAction::Version: existing --version behavior
  • ArgAction::Set: Overwrite existing values (like Arg::multiple_occurrences mixed with Command::args_override_self) (#​3777)
  • ArgAction::Append: like Arg::multiple_occurrences (#​3777)
  • ArgAction::SetTrue: Treat --flag as --flag=true (#​3775)
    • Implies Arg::default_value("false") (#​3786)
    • Parses Arg::env via Arg::value_parser
  • ArgAction::SetFalse: Treat --flag as --flag=false (#​3775)
    • Implies Arg::default_value("true") (#​3786)
    • Parses Arg::env via Arg::value_parser
  • ArgAction::Count: Treat --flag --flag --flag as --flag=1 --flag=2 --flag=3 (#​3775)
    • Implies Arg::default_value("0") (#​3786)
    • Parses Arg::env via Arg::value_parser
• (derive) Opt-in to new Arg::value_parser / Arg::action with either #[clap(value_parser)] (#​3589, #​3742) / #[clap(action)] attributes (#​3794)
  • Default ValueParser is determined by value_parser! (#​3199, #​3496)
  • Default ArgAction is determine by a hard-coded lookup on the type (#​3794)
• Command::multicall is now stable for busybox-like programs and REPLs (#​2861, #​3684)
• ArgMatches::{try_,}contains_id for checking if there are values for an argument that mirrors the new get_{one,many} API

Fixes

parser

• Set ArgMatches::value_source and ArgMatches::occurrences_of for external subcommands (#​3732)
• Use value delimiter for Arg::default_missing_values (#​3761, #​3765)
• SplitArg::default_value / Arg::env on value delimiters independent of whether -- was used (#​3765)
• Allow applying defaults to flags (#​3294, 3775)
• Defaults no longer satisfy required and its variants (#​3793)

Compatibility

MSRV is now 1.56.0 (#​3732)

Behavior

• Defaults no longer satisfy required and its variants (#​3793)

Moving (old location deprecated)

• clap::{PossibleValue, ValueHint} to clap::builder::{PossibleValue, ValueHint}
• clap::{Indices, OsValues, ValueSource, Values} to clap::parser::{Indices, OsValues, ValueSource, Values}
• clap::ArgEnum to clap::ValueEnum (#​3799)

Replaced

• Arg::allow_invalid_utf8 with Arg::value_parser(value_parser!(PathBuf)) (#​3753)
• Arg::validator / Arg::validator_os with Arg::value_parser (#​3753)
• Arg::validator_regex with users providing their own builder::TypedValueParser (#​3756)
• Arg::forbid_empty_values with builder::NonEmptyStringValueParser / builder::PathBufValueParser (#​3753)
• Arg::possible_values with Arg::value_parser([...]), builder::PossibleValuesParser, or builder::EnumValueParser (#​3753)
• Arg::max_occurrences with arg.action(ArgAction::Count).value_parser(value_parser!(u8).range(..N)) for flags (#​3797)
• Arg::multiple_occurrences with ArgAction::Append or ArgAction::Count though positionals will need Arg::multiple_values (#​3772, #​3797)
• Command::args_override_self with ArgAction::Set (#​2627, #​3797)
• AppSettings::NoAutoVersion with ArgAction or Command::disable_version_flag (#​3800)
• AppSettings::NoHelpVersion with ArgAction or Command::disable_help_flag / Command::disable_help_subcommand (#​3800)
• ArgMatches::{value_of, value_of_os, value_of_os_lossy, value_of_t} with ArgMatches::{get_one,remove_one} (#​3753)
• ArgMatches::{values_of, values_of_os, values_of_os_lossy, values_of_t} with ArgMatches::{get_many,remove_many} (#​3753)
• ArgMatches::is_valid_arg with ArgMatches::{try_get_one,try_get_many} (#​3753)
• ArgMatches::occurrences_of with ArgMatches::value_source or ArgAction::Count (#​3797)
• ArgMatches::is_present with ArgMatches::contains_id or ArgAction::SetTrue (#​3797)
• ArgAction::StoreValue with ArgAction::Set or ArgAction::Append (#​3797)
• ArgAction::IncOccurrences with ArgAction::SetTrue or ArgAction::Count (#​3797)
• (derive) #[clap(parse(from_flag))] replaced with #[clap(action = ArgAction::SetTrue)] (#​3794)
• (derive) #[clap(parse(from_occurrences))] replaced with #[clap(action = ArgAction::Count)] though the field's type must be u8 (#​3794)
• (derive) #[clap(parse(...))] replaced with #[clap(value_parser)] (#​3589, #​3794)

v1.18.2

Compare Source

1.18.2 (May 5, 2022)

Add missing features for the winapi dependency. (#​4663)

v3.1.18

Compare Source

Fixes

• Fix deprecated arg_enum! for users migrating to clap3 (#​3717)
• Verify all required_unless_present_all arguments exist
• Verify group members exist before processing group members (#​3711)
• (help) Use ... when not enough value_names are supplied

gated behind unstable-v4

• Verify required is not used with conditional required settings (#​3660)
• Disallow more value_names than number_of_values (#​2695)
• (parser) Assert on unknown args when using external subcommands (#​3703)
• (parser) Always fill in "" argument for external subcommands (#​3263)
• (derive) Detect escaped external subcommands that look like built-in subcommands (#​3703)
• (derive) Leave Arg::id as verbatim casing (#​3282)

Sourced from tokio's releases.

Tokio v1.15.0

Fixed

• io: add cooperative yielding support to io::empty() (#4300)
• time: make timeout robust against budget-depleting tasks (#4314)

Changed

• update minimum supported Rust version to 1.46.

Added

• time: add Interval::reset() (#4248)
• io: add explicit lifetimes to AsyncFdReadyGuard (#4267)
• process: add Command::as_std() (#4295)

Added (unstable)

• tracing: instrument tokio::sync types (#4302)

#4302: tokio-rs/tokio#4302 #4300: tokio-rs/tokio#4300 #4295: tokio-rs/tokio#4295 #4267: tokio-rs/tokio#4267 #4248: tokio-rs/tokio#4248 #4314: tokio-rs/tokio#4314

• f646735 chore: prepare Tokio v1.15.0 release (#4320)
• 54e6693 time: make timeout robust against budget-depleting tasks (#4314)
• 4e3268d tracing: instrument more resources (#4302)
• 4b6bb1d chore(util): start v0.7 release cycle (#4313)
• eb1af7f io: make tokio::io::empty cooperative (#4300)
• 0bc9160 chore: update labeler.yml to drop filepath prefixes (#4308)
• 4c571b5 runtime: fix typo in the task modules (#4306)
• 60ba634 time: fix typo in tokio-time document (#4304)
• f73ed1f runtime: fix typo (#4303)
• ee4b2ed process: add as_std() method to Command (#4295)
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

• 2a3c803 chore: prepare Tokio v1.13.1 (#4235)
• 7d8de50 oneshot: document UnsafeCell invariants (#4229)
• ab0e60d sync: fix racy UnsafeCell access on a closed oneshot (#4226)
• See full diff in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)