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

//! Some tools to get you started with writing small CLIs in Rust.
//!
//! You can find some examples and more information on how to use this crate
//! in the [README](https://github.com/killercup/quicli).

#![deny(missing_docs)]

#[cfg(feature = "full-throttle")]
pub mod fs;

mod reexports {
    #[cfg(feature = "full-throttle")]
    #[doc(hidden)]
    pub use serde_derive::{Deserialize, Serialize};

    pub use clap_verbosity_flag::Verbosity;

    #[doc(hidden)]
    pub use failure_derive::Fail;
    #[doc(hidden)]
    pub use failure::{Error, ResultExt, bail, ensure, format_err, err_msg};

    #[doc(hidden)]
    pub use log::{error, warn, info, debug, trace, log_enabled};

    #[cfg(feature = "full-throttle")]
    pub use rayon::prelude::*;

    #[doc(hidden)]
    pub use log;
    #[doc(hidden)]
    pub use log::Level as LogLevel;
}

/// Prelude – import all of this
///
/// To get up-and-running _real_ fast, do `use quicli::prelude::*`. It's just
/// like `use std::io::prelude::*` but with less I/O and more C/L/I!
///
/// (If you don't like glob imports, feel free to import the items 1-by-1. You
/// will sadly miss out on a bunch of derive macros, though.)
pub mod prelude {
    pub use crate::reexports::*;

    /// A handy alias for `Result` that carries a generic error type.
    pub type CliResult = ::std::result::Result<(), ::exitfailure::ExitFailure>;

    #[cfg(feature = "full-throttle")]
    pub use crate::fs::*;
}