mirror of
https://github.com/clap-rs/clap
synced 2025-01-05 17:28:42 +00:00
eda0ca54c1
Clap has focused on reporting development errors through assertions rather than mixing user errors with development errors. Sometimes, developers need to handle things more flexibly so included in #3732 was the reporting of value accessor failures as internal errors with a distinct type. I've been going back and forth on whether the extra error pessimises the usability in the common case vs dealing with the proliferation of different function combinations. In working on deprecating the `value_of` functions, I decided that it was going to be worth duplicating so long as we can keep the documentation focused. |
||
---|---|---|
.. | ||
derive_ref | ||
tutorial_builder | ||
tutorial_derive | ||
cargo-example-derive.md | ||
cargo-example-derive.rs | ||
cargo-example.md | ||
cargo-example.rs | ||
demo.md | ||
demo.rs | ||
escaped-positional-derive.md | ||
escaped-positional-derive.rs | ||
escaped-positional.md | ||
escaped-positional.rs | ||
git-derive.md | ||
git-derive.rs | ||
git.md | ||
git.rs | ||
multicall-busybox.md | ||
multicall-busybox.rs | ||
multicall-hostname.md | ||
multicall-hostname.rs | ||
pacman.md | ||
pacman.rs | ||
README.md | ||
repl.rs | ||
typed-derive.md | ||
typed-derive.rs |
Examples
- Basic demo: derive
- Typed arguments: derive
- Topics:
- Custom
parse()
- Custom
- Topics:
- Custom cargo command: builder, derive
- Topics:
- Subcommands
- Cargo plugins
- Topics:
- git-like interface: builder, derive
- Topics:
- Subcommands
- External subcommands
- Optional subcommands
- Default subcommands
- Topics:
- pacman-like interface: builder
- Topics:
- Flag subcommands
- Conflicting arguments
- Topics:
- Escaped positionals with
--
: builder, derive - Multi-call
- repl: builder
- Topics:
- Read-Eval-Print Loops / Custom command lines
- Topics:
Contributing
New examples:
- Building: They must be added to Cargo.toml with the appropriate
required-features
. - Testing: Ensure there is a markdown file with trycmd syntax
- Link the
.md
file from here
See also the general CONTRIBUTING.