clap-patterns

Clap v4 offers two approaches: derive macros for declarative, type-safe struct-based CLIs with compile-time validation, and builder API for runtime flexibility. Choose derive for simpler CLIs with fixed arguments; use builder when you need dynamic argument construction or complex conditional logic.

Clap's argument groups enforce mutual exclusivity by grouping conflicting options and marking them as required or exclusive. Define a group, add options to it, and set the group constraint; Clap validates at runtime and provides clear error messages.

Yes, Clap v4 supports environment variable fallbacks through the `env` attribute in derive or `env` method in builder API. Arguments check the environment if not provided on the command line, enabling flexible configuration without code changes.

Use `Vec<T>` types in derive or `num_args()` in builder to capture repeated flags or multiple values. Clap collects repeated invocations or space-separated values into a collection, supporting use cases like multiple input files or verbosity levels.

Clap's `flatten` attribute lets you reuse option structs across subcommands by including a shared struct directly. Define global options once, flatten them into subcommand structs, and avoid duplication while maintaining type safety.

Clap v4's custom value parsers let you define validation and conversion logic for arguments. Implement a parser function or type that accepts a string and returns a typed result; Clap calls it automatically, providing type safety and clear error messages.