mirror of
https://github.com/clap-rs/clap
synced 2024-12-13 22:32:33 +00:00
4e1a565b8a
For now, we are still treating `clap` as the user facing API for both builder and derive, making this an internal change as we don't expect this to negatively impact builder build times all that much. We can re-evaluate at a later time and consider having distinct top-level crates for builder and derive. Looking at `--timings` on my machine - `clap` only took 0.04s to build and it happened in parallel to `clap_builder` codegen - this saved 1.7s for derive build times, with `clap_builder` building in parallel to `syn` and `clap_builder` and `clap_derive` finishing around the same time. This was discussed some at https://rust-lang.zulipchat.com/#narrow/stream/220302-wg-cli/topic/clap.20build.20times.20and.20.60clap_derive.60.3A.20a.20crazy.20idea
379 lines
9.5 KiB
TOML
379 lines
9.5 KiB
TOML
[workspace]
|
|
members = [
|
|
"clap_bench",
|
|
"clap_builder",
|
|
"clap_derive",
|
|
"clap_lex",
|
|
"clap_complete",
|
|
"clap_complete_fig",
|
|
"clap_mangen",
|
|
]
|
|
|
|
[workspace.package]
|
|
license = "MIT OR Apache-2.0"
|
|
edition = "2021"
|
|
rust-version = "1.64.0" # MSRV
|
|
include = [
|
|
"build.rs",
|
|
"src/**/*",
|
|
"Cargo.toml",
|
|
"LICENSE*",
|
|
"README.md",
|
|
"benches/**/*",
|
|
"examples/**/*"
|
|
]
|
|
|
|
[package]
|
|
name = "clap"
|
|
version = "4.1.13"
|
|
description = "A simple to use, efficient, and full-featured Command Line Argument Parser"
|
|
repository = "https://github.com/clap-rs/clap"
|
|
categories = ["command-line-interface"]
|
|
keywords = [
|
|
"argument",
|
|
"cli",
|
|
"arg",
|
|
"parser",
|
|
"parse"
|
|
]
|
|
license.workspace = true
|
|
edition.workspace = true
|
|
rust-version.workspace = true
|
|
include.workspace = true
|
|
|
|
[package.metadata.docs.rs]
|
|
features = ["unstable-doc"]
|
|
rustdoc-args = ["--cfg", "docsrs"]
|
|
cargo-args = ["-Zunstable-options", "-Zrustdoc-scrape-examples"]
|
|
|
|
[package.metadata.playground]
|
|
features = ["unstable-doc"]
|
|
|
|
[package.metadata.release]
|
|
shared-version = true
|
|
tag-name = "v{{version}}"
|
|
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="CITATION.cff", search="^date-released: ....-..-..", replace="date-released: {{date}}"},
|
|
{file="CITATION.cff", search="^version: .+\\..+\\..+", replace="version: {{version}}"},
|
|
]
|
|
|
|
[features]
|
|
default = [
|
|
"std",
|
|
"color",
|
|
"help",
|
|
"usage",
|
|
"error-context",
|
|
"suggestions",
|
|
]
|
|
debug = ["clap_builder/debug", "clap_derive?/debug"] # Enables debug messages
|
|
unstable-doc = ["clap_builder/unstable-doc", "derive"] # for docs.rs
|
|
|
|
# Used in default
|
|
std = ["clap_builder/std"] # support for no_std in a backwards-compatible way
|
|
color = ["clap_builder/color"]
|
|
help = ["clap_builder/help"]
|
|
usage = ["clap_builder/usage"]
|
|
error-context = ["clap_builder/error-context"]
|
|
suggestions = ["clap_builder/suggestions"]
|
|
|
|
# Optional
|
|
deprecated = ["clap_builder/deprecated", "clap_derive?/deprecated"] # Guided experience to prepare for next breaking release (at different stages of development, this may become default)
|
|
derive = ["dep:clap_derive", "dep:once_cell"]
|
|
cargo = ["clap_builder/cargo"] # Disable if you're not using Cargo, enables Cargo-env-var-dependent macros
|
|
wrap_help = ["clap_builder/wrap_help"]
|
|
env = ["clap_builder/env"] # Use environment variables during arg parsing
|
|
unicode = ["clap_builder/unicode"] # Support for unicode characters in arguments and help messages
|
|
string = ["clap_builder/string"] # Allow runtime generated strings
|
|
|
|
# In-work features
|
|
unstable-replace = ["clap_builder/unstable-replace"]
|
|
unstable-grouped = ["clap_builder/unstable-grouped"]
|
|
unstable-v5 = ["clap_builder/unstable-v5", "clap_derive?/unstable-v5", "deprecated"]
|
|
|
|
[lib]
|
|
bench = false
|
|
|
|
[dependencies]
|
|
clap_builder = { path = "./clap_builder", version = "=4.1.13", default-features = false }
|
|
clap_derive = { path = "./clap_derive", version = "=4.1.12", optional = true }
|
|
once_cell = { version = "1.12.0", optional = true }
|
|
|
|
[dev-dependencies]
|
|
trybuild = "1.0.77"
|
|
rustversion = "1.0.12"
|
|
# Cutting out `filesystem` feature
|
|
trycmd = { version = "0.14.15", default-features = false, features = ["color-auto", "diff", "examples"] }
|
|
humantime = "2.1.0"
|
|
snapbox = "0.4.10"
|
|
shlex = "1.1.0"
|
|
static_assertions = "1.1.0"
|
|
unic-emoji-char = "0.9.0"
|
|
|
|
[[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 = "find"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "git-derive"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "typed-derive"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "busybox"
|
|
path = "examples/multicall-busybox.rs"
|
|
|
|
[[example]]
|
|
name = "hostname"
|
|
path = "examples/multicall-hostname.rs"
|
|
|
|
[[example]]
|
|
name = "repl"
|
|
path = "examples/repl.rs"
|
|
required-features = ["help"]
|
|
|
|
[[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"
|
|
|
|
[[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_02_option_mult"
|
|
path = "examples/tutorial_builder/03_02_option_mult.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "03_03_positional"
|
|
path = "examples/tutorial_builder/03_03_positional.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[example]]
|
|
name = "03_03_positional_mult"
|
|
path = "examples/tutorial_builder/03_03_positional_mult.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"]
|
|
|
|
[[example]]
|
|
name = "04_02_parse"
|
|
path = "examples/tutorial_builder/04_02_parse.rs"
|
|
required-features = ["cargo"]
|
|
|
|
[[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_02_option_mult_derive"
|
|
path = "examples/tutorial_derive/03_02_option_mult.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "03_03_positional_derive"
|
|
path = "examples/tutorial_derive/03_03_positional.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "03_03_positional_mult_derive"
|
|
path = "examples/tutorial_derive/03_03_positional_mult.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "03_04_subcommands_derive"
|
|
path = "examples/tutorial_derive/03_04_subcommands.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "03_04_subcommands_alt_derive"
|
|
path = "examples/tutorial_derive/03_04_subcommands_alt.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_parse_derive"
|
|
path = "examples/tutorial_derive/04_02_parse.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 = "interop_augment_args"
|
|
path = "examples/derive_ref/augment_args.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "interop_augment_subcommands"
|
|
path = "examples/derive_ref/augment_subcommands.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "interop_hand_subcommand"
|
|
path = "examples/derive_ref/hand_subcommand.rs"
|
|
required-features = ["derive"]
|
|
|
|
[[example]]
|
|
name = "interop_flatten_hand_args"
|
|
path = "examples/derive_ref/flatten_hand_args.rs"
|
|
required-features = ["derive"]
|
|
|
|
[profile.test]
|
|
opt-level = 1
|
|
|
|
[profile.bench]
|
|
lto = true
|
|
codegen-units = 1
|