1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63
//! **clap-cargo**: Re-usable CLI flags for `cargo` plugins
//!
//! ## Install
//!
//! Add to your `Cargo.toml`:
//!
//! ```toml
//! [dependencies]
//! clap-cargo = "0.1"
//! ```
//!
//! ## Examples
//!
//! ```rust,no_run
//! # #[cfg(feature = "clap")] {
//! # #[cfg(feature = "cargo_metadata")] {
//! use clap::Parser;
//!
//! // ...
//! #[derive(Debug, Parser)]
//! struct Cli {
//! #[command(flatten)]
//! manifest: clap_cargo::Manifest,
//! #[command(flatten)]
//! workspace: clap_cargo::Workspace,
//! #[command(flatten)]
//! features: clap_cargo::Features,
//! }
//!
//! let cli = // ...
//! # Cli::parse_from(["app"]);
//! let mut metadata = cli.manifest.metadata();
//! cli.features.forward_metadata(&mut metadata);
//! let metadata = metadata.exec().unwrap();
//! let (selected, excluded) = cli.workspace.partition_packages(&metadata);
//! # }
//! # }
//! ```
//!
//! ## Relevant crates
//!
//! Other crates that might be useful for cargo plugins:
//! * [escargot][escargot] for wrapping `cargo-build`, `carg-run`, `cargo-test`, etc.
//! * [cargo_metadata][cargo_metadata] for getting crate information.
//! * [clap-verbosity][clap-verbosity] for adding logging to your CLI.
//!
//! [escargot]: https://crates.io/crates/escargot
//! [cargo_metadata]: https://crates.io/crates/cargo_metadata
//! [clap-verbosity]: https://crates.io/crates/clap-verbosity-flag
#![cfg_attr(docsrs, feature(doc_auto_cfg))]
#![warn(clippy::print_stderr)]
#![warn(clippy::print_stdout)]
mod features;
mod manifest;
mod workspace;
pub mod style;
pub use features::*;
pub use manifest::*;
pub use workspace::*;