| 1 | // Copyright ⓒ 2015-2016 Kevin B. Knapp and [`clap-rs` contributors](https://github.com/clap-rs/clap/graphs/contributors). |
| 2 | // Licensed under the MIT license |
|---|
| 3 | // (see LICENSE or <http://opensource.org/licenses/MIT>) All files in the project carrying such |
|---|
| 4 | // notice may not be copied, modified, or distributed except according to those terms. |
|---|
| 5 | |
|---|
| 6 | #![cfg_attr (docsrs, feature(doc_auto_cfg))] |
|---|
| 7 | #![doc = include_str!("../README.md" )] |
|---|
| 8 | #![doc (html_logo_url = "https://raw.githubusercontent.com/clap-rs/clap/master/assets/clap.png" )] |
|---|
| 9 | #![warn ( |
|---|
| 10 | missing_docs, |
|---|
| 11 | missing_debug_implementations, |
|---|
| 12 | missing_copy_implementations, |
|---|
| 13 | trivial_casts, |
|---|
| 14 | unused_allocation, |
|---|
| 15 | trivial_numeric_casts, |
|---|
| 16 | clippy::single_char_pattern |
|---|
| 17 | )] |
|---|
| 18 | #![forbid (unsafe_code)] |
|---|
| 19 | // Wanting consistency in our calls |
|---|
| 20 | #![allow (clippy::write_with_newline)] |
|---|
| 21 | // Gets in the way of logging |
|---|
| 22 | #![allow (clippy::let_and_return)] |
|---|
| 23 | // HACK https://github.com/rust-lang/rust-clippy/issues/7290 |
|---|
| 24 | #![allow (clippy::single_component_path_imports)] |
|---|
| 25 | #![allow (clippy::branches_sharing_code)] |
|---|
| 26 | // Doesn't allow for debug statements, etc to be unique |
|---|
| 27 | #![allow (clippy::if_same_then_else)] |
|---|
| 28 | // Breaks up parallelism that clarifies intent |
|---|
| 29 | #![allow (clippy::collapsible_else_if)] |
|---|
| 30 | |
|---|
| 31 | #[cfg (not(feature = "std" ))] |
|---|
| 32 | compile_error!("`std` feature is currently required to build `clap`" ); |
|---|
| 33 | |
|---|
| 34 | pub use crate::builder::ArgAction; |
|---|
| 35 | pub use crate::builder::Command; |
|---|
| 36 | pub use crate::builder::ValueHint; |
|---|
| 37 | pub use crate::builder::{Arg, ArgGroup}; |
|---|
| 38 | pub use crate::parser::ArgMatches; |
|---|
| 39 | pub use crate::util::color::ColorChoice; |
|---|
| 40 | pub use crate::util::Id; |
|---|
| 41 | |
|---|
| 42 | /// Command Line Argument Parser Error |
|---|
| 43 | /// |
|---|
| 44 | /// See [`Command::error`] to create an error. |
|---|
| 45 | /// |
|---|
| 46 | /// [`Command::error`]: crate::Command::error |
|---|
| 47 | pub type Error = crate::error::Error<crate::error::DefaultFormatter>; |
|---|
| 48 | |
|---|
| 49 | pub use crate::derive::{Args, CommandFactory, FromArgMatches, Parser, Subcommand, ValueEnum}; |
|---|
| 50 | |
|---|
| 51 | #[macro_use ] |
|---|
| 52 | #[allow (missing_docs)] |
|---|
| 53 | mod macros; |
|---|
| 54 | |
|---|
| 55 | mod derive; |
|---|
| 56 | |
|---|
| 57 | pub mod builder; |
|---|
| 58 | pub mod error; |
|---|
| 59 | pub mod parser; |
|---|
| 60 | |
|---|
| 61 | mod mkeymap; |
|---|
| 62 | mod output; |
|---|
| 63 | mod util; |
|---|
| 64 | |
|---|
| 65 | const INTERNAL_ERROR_MSG: &str = "Fatal internal error. Please consider filing a bug \ |
|---|
| 66 | report at https://github.com/clap-rs/clap/issues" ; |
|---|
| 67 | |
|---|
