mirror of
https://github.com/clap-rs/clap
synced 2024-12-14 14:52:33 +00:00
88a335ff97
`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`.
349 lines
8.7 KiB
TOML
349 lines
8.7 KiB
TOML
[workspace]
|
|
members = [
|
|
"clap_derive",
|
|
"clap_complete",
|
|
"clap_complete_fig",
|
|
"clap_generate",
|
|
"clap_generate_fig",
|
|
]
|
|
|
|
[package]
|
|
name = "clap"
|
|
version = "3.0.0-rc.11"
|
|
description = "A simple to use, efficient, and full-featured Command Line Argument Parser"
|
|
repository = "https://github.com/clap-rs/clap"
|
|
documentation = "https://docs.rs/clap/"
|
|
categories = ["command-line-interface"]
|
|
keywords = [
|
|
"argument",
|
|
"cli",
|
|
"arg",
|
|
"parser",
|
|
"parse"
|
|
]
|
|
edition = "2018"
|
|
license = "MIT OR Apache-2.0"
|
|
readme = "README.md"
|
|
include = [
|
|
"build.rs",
|
|
"src/**/*",
|
|
"Cargo.toml",
|
|
"LICENSE*",
|
|
"README.md",
|
|
"benches/**/*",
|
|
"examples/**/*"
|
|
]
|
|
|
|
[package.metadata.docs.rs]
|
|
features = ["unstable-doc"]
|
|
rustdoc-args = ["--cfg", "docsrs"]
|
|
cargo-args = ["-Zunstable-options", "-Zrustdoc-scrape-examples=examples"]
|
|
|
|
[package.metadata.playground]
|
|
features = ["unstable-doc"]
|
|
|
|
[package.metadata.release]
|
|
shared-version = true
|
|
pre-release-replacements = [
|
|
{file="CHANGELOG.md", search="Unreleased", replace="{{version}}", min=1},
|
|
{file="CHANGELOG.md", search="\\.\\.\\.HEAD", replace="...{{tag_name}}", exactly=1},
|
|
{file="CHANGELOG.md", search="ReleaseDate", replace="{{date}}", min=1},
|
|
{file="CHANGELOG.md", search="<!-- next-header -->", replace="<!-- next-header -->\n## [Unreleased] - ReleaseDate\n", exactly=1},
|
|
{file="CHANGELOG.md", search="<!-- next-url -->", replace="<!-- next-url -->\n[Unreleased]: https://github.com/clap-rs/clap/compare/{{tag_name}}...HEAD", exactly=1},
|
|
{file="README.md", search="github.com/clap-rs/clap/blob/[^/]+/", replace="github.com/clap-rs/clap/blob/{{tag_name}}/", exactly=9, prerelease = true},
|
|
{file="README.md", search="version = \"[a-z0-9\\.-]+\"", replace="version = \"{{version}}\"", exactly=1, prerelease = true},
|
|
{file="src/derive.rs", search="github.com/clap-rs/clap/blob/[^/]+/", replace="github.com/clap-rs/clap/blob/{{tag_name}}/", exactly=4, prerelease = true},
|
|
]
|
|
|
|
[features]
|
|
default = [
|
|
"std",
|
|
"color",
|
|
"suggestions",
|
|
]
|
|
debug = ["clap_derive/debug", "backtrace"] # Enables debug messages
|
|
unstable-doc = ["derive", "cargo", "wrap_help", "yaml", "env", "unicode", "regex", "unstable-replace", "unstable-multicall", "unstable-grouped"] # for docs.rs
|
|
|
|
# Used in default
|
|
std = ["indexmap/std"] # support for no_std in a backwards-compatible way
|
|
color = ["atty", "termcolor"]
|
|
suggestions = ["strsim"]
|
|
|
|
# Optional
|
|
derive = ["clap_derive", "lazy_static"]
|
|
cargo = ["lazy_static"] # Disable if you're not using Cargo, enables Cargo-env-var-dependent macros
|
|
wrap_help = ["terminal_size", "textwrap/terminal_size"]
|
|
yaml = ["yaml-rust"]
|
|
env = [] # Use environment variables during arg parsing
|
|
unicode = ["textwrap/unicode-width", "unicase"] # Support for unicode characters in arguments and help messages
|
|
|
|
# In-work features
|
|
unstable-replace = []
|
|
unstable-multicall = []
|
|
unstable-grouped = []
|
|
|
|
[lib]
|
|
bench = false
|
|
|
|
[[bench]]
|
|
harness = false
|
|
name = "01_default"
|
|
path = "benches/01_default.rs"
|
|
|
|
[[bench]]
|
|
harness = false
|
|
name = "02_simple"
|
|
path = "benches/02_simple.rs"
|
|
|
|
[[bench]]
|
|
harness = false
|
|
name = "03_complex"
|
|
path = "benches/03_complex.rs"
|
|
|
|
[[bench]]
|
|
harness = false
|
|
name = "04_new_help"
|
|
path = "benches/04_new_help.rs"
|
|
|
|
[[bench]]
|
|
harness = false
|
|
name = "05_ripgrep"
|
|
path = "benches/05_ripgrep.rs"
|
|
|
|
[[bench]]
|
|
harness = false
|
|
name = "06_rustup"
|
|
path = "benches/06_rustup.rs"
|
|
|
|
[dependencies]
|
|
clap_derive = { path = "./clap_derive", version = "=3.0.0-rc.11", optional = true }
|
|
bitflags = "1.2"
|
|
textwrap = { version = "0.14.0", default-features = false, features = [] }
|
|
unicase = { version = "2.6", optional = true }
|
|
indexmap = "1.0"
|
|
os_str_bytes = "6.0"
|
|
strsim = { version = "0.10", optional = true }
|
|
yaml-rust = { version = "0.4.1", optional = true }
|
|
atty = { version = "0.2", optional = true }
|
|
termcolor = { version = "1.1.1", optional = true }
|
|
terminal_size = { version = "0.1.12", optional = true }
|
|
lazy_static = { version = "1", optional = true }
|
|
regex = { version = "1.0", optional = true }
|
|
backtrace = { version = "0.3", optional = true }
|
|
|
|
[dev-dependencies]
|
|
regex = "1.0"
|
|
lazy_static = "1"
|
|
criterion = "0.3.2"
|
|
trybuild = "1.0.18"
|
|
rustversion = "1"
|
|
# Cutting out `filesystem` feature
|
|
trycmd = { version = "0.8.3", default-features = false, features = ["color-auto", "diff", "examples"] }
|
|
|
|
[[example]]
|
|
name = "demo"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "cargo-example"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "cargo-example-derive"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "escaped-positional"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "escaped-positional-derive"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "git-derive"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "keyvalue-derive"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "busybox"
|
|
path = "examples/multicall-busybox.rs"
|
|
required-features = ["unstable-multicall"]
|
|
|
|
[[example]]
|
|
name = "hostname"
|
|
path = "examples/multicall-hostname.rs"
|
|
required-features = ["unstable-multicall"]
|
|
|
|
[[example]]
|
|
name = "01_quick"
|
|
path = "examples/tutorial_builder/01_quick.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "02_apps"
|
|
path = "examples/tutorial_builder/02_apps.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "02_crate"
|
|
path = "examples/tutorial_builder/02_crate.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "02_app_settings"
|
|
path = "examples/tutorial_builder/02_app_settings.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "03_01_flag_bool"
|
|
path = "examples/tutorial_builder/03_01_flag_bool.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "03_01_flag_count"
|
|
path = "examples/tutorial_builder/03_01_flag_count.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "03_02_option"
|
|
path = "examples/tutorial_builder/03_02_option.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "03_03_positional"
|
|
path = "examples/tutorial_builder/03_03_positional.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "03_04_subcommands"
|
|
path = "examples/tutorial_builder/03_04_subcommands.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "03_05_default_values"
|
|
path = "examples/tutorial_builder/03_05_default_values.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "04_01_possible"
|
|
path = "examples/tutorial_builder/04_01_possible.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "04_01_enum"
|
|
path = "examples/tutorial_builder/04_01_enum.rs"
|
|
required-features = ["cargo", "derive"]
|
|
|
|
[[example]]
|
|
name = "04_02_validate"
|
|
path = "examples/tutorial_builder/04_02_validate.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "04_03_relations"
|
|
path = "examples/tutorial_builder/04_03_relations.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "04_04_custom"
|
|
path = "examples/tutorial_builder/04_04_custom.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "05_01_assert"
|
|
path = "examples/tutorial_builder/05_01_assert.rs"
|
|
required-features = ["cargo"]
|
|
test = true
|
|
|
|
[[example]]
|
|
name = "01_quick_derive"
|
|
path = "examples/tutorial_derive/01_quick.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "02_apps_derive"
|
|
path = "examples/tutorial_derive/02_apps.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "02_crate_derive"
|
|
path = "examples/tutorial_derive/02_crate.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "02_app_settings_derive"
|
|
path = "examples/tutorial_derive/02_app_settings.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "03_01_flag_bool_derive"
|
|
path = "examples/tutorial_derive/03_01_flag_bool.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "03_01_flag_count_derive"
|
|
path = "examples/tutorial_derive/03_01_flag_count.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "03_02_option_derive"
|
|
path = "examples/tutorial_derive/03_02_option.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "03_03_positional_derive"
|
|
path = "examples/tutorial_derive/03_03_positional.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "03_04_subcommands_derive"
|
|
path = "examples/tutorial_derive/03_04_subcommands.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "03_05_default_values_derive"
|
|
path = "examples/tutorial_derive/03_05_default_values.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "04_01_enum_derive"
|
|
path = "examples/tutorial_derive/04_01_enum.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "04_02_validate_derive"
|
|
path = "examples/tutorial_derive/04_02_validate.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "04_03_relations_derive"
|
|
path = "examples/tutorial_derive/04_03_relations.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "04_04_custom_derive"
|
|
path = "examples/tutorial_derive/04_04_custom.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "05_01_assert_derive"
|
|
path = "examples/tutorial_derive/05_01_assert.rs"
|
|
required-features = ["derive"]
|
|
test = true
|
|
|
|
[[example]]
|
|
name = "custom-bool"
|
|
path = "examples/derive_ref/custom-bool.rs"
|
|
required-features = ["derive"]
|
|
|
|
[profile.test]
|
|
opt-level = 1
|
|
|
|
[profile.bench]
|
|
lto = true
|
|
codegen-units = 1
|
|
|