clap/clap_complete
Ed Page 88a335ff97 fix(complete): Give crates more specific names
`clap_generate` originally intended to be "generate anything".  With
`fig`, we already broke one part out.  With #3174's man support, we are
also looking at keeping it separate:
- More freedom to iterate on the API
- Uniqueness (and potential weight) of its dependencies
- man generation is normally more for distribution while completions are
  a mix of being distributed with the app or the app generating the
  completions (which will be exacerbated if we move most completion
  parsing logic to be in Rust)

So `clap_generate` is having a lot more limited of a role than the
original name conveys.   I worry the generic name will be a hindrance to
people discovering and using it (yes, documentation can help but there
are limits).

I hesitated because we are on the verge of releasing 3.0. However, doing
it even later will be even more disruptive because more people will be
using it (crates.io lists ~70 people using `clap_generate`).

To ease things, we are still releasing `clap_generate` as a wrapper
around `clap_complete`.
2021-12-31 12:03:29 -06:00
..
examples fix(complete): Give crates more specific names 2021-12-31 12:03:29 -06:00
src fix(complete): Give crates more specific names 2021-12-31 12:03:29 -06:00
tests fix(complete): Give crates more specific names 2021-12-31 12:03:29 -06:00
Cargo.toml fix(complete): Give crates more specific names 2021-12-31 12:03:29 -06:00
CONTRIBUTING.md fix(complete): Give crates more specific names 2021-12-31 12:03:29 -06:00
LICENSE-APACHE fix(complete): Give crates more specific names 2021-12-31 12:03:29 -06:00
LICENSE-MIT fix(complete): Give crates more specific names 2021-12-31 12:03:29 -06:00
README.md fix(complete): Give crates more specific names 2021-12-31 12:03:29 -06:00

clap_complete

Shell completion generation for clap

Crates.io Crates.io License License

Dual-licensed under Apache 2.0 or MIT.

  1. About
  2. API Reference
  3. Questions & Discussions
  4. CONTRIBUTING
  5. Sponsors

About