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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

// License: see LICENSE file at root directory of `master` branch

//! # Command line duration
//!
//! ## Project
//!
//! - Repository: <https://bitbucket.org/haibison/cld>
//! - License: Nice License 1.0.0 _(see LICENSE file at root directory of `master` branch)_
//! - _This project follows [Semantic Versioning 2.0.0]_
//!
//! ## Features
//!
//! This project helps parse [`Duration`][core::time/Duration] from command line arguments.
//!
//! ## Notes
//!
//! The crate uses `#![no_std]` by default. Documentation is built with all features, which include `std`. If you see some components from
//! [`std`][crate:std] crate, you have to use that feature.
//!
//! [Semantic Versioning 2.0.0]: https://semver.org/spec/v2.0.0.html
//! [core::time/Duration]: https://doc.rust-lang.org/core/time/struct.Duration.html
//! [crate:std]: https://doc.rust-lang.org/std/

#![warn(missing_docs)]
#![no_std]
#![forbid(unsafe_code)]

// ╔═════════════════╗
// ║   IDENTIFIERS   ║
// ╚═════════════════╝

macro_rules! code_name  { () => { "cld" }}
macro_rules! version    { () => { "0.2.1" }}

/// # Crate name
pub const NAME: &str = "cld";

/// # Crate code name
pub const CODE_NAME: &str = code_name!();

/// # ID of this crate
pub const ID: &str = concat!(
    "2cf37bc5-bfd0f66b-7cbf8382-4eb3e3cb-d2a9e255-ef4858eb-07c2ffe7-0e0b66a7-",
    "b29673a3-386a6335-9bf7dc3b-faad33d9-76db4b61-57f6a606-da001cbb-8ba95a71",
);

/// # Crate version
pub const VERSION: &str = version!();

/// # Crate release date (year/month/day)
pub const RELEASE_DATE: (u16, u8, u8) = (2019, 11, 16);

/// # Tag, which can be used for logging...
pub const TAG: &str = concat!(code_name!(), "::2cf37bc5::", version!());

// ╔════════════════════╗
// ║   IMPLEMENTATION   ║
// ╚════════════════════╝

#[macro_use]
extern crate alloc;

#[cfg(feature="std")]
extern crate std;

/// # Makes new Error, prefixing your message with: ::TAG, module_path!(), line!()
macro_rules! e { ($($arg: tt)+) => {
    Error::from(format!(
        "[{tag}][{module_path}-{line}] {format}", tag=crate::TAG, module_path=module_path!(), line=line!(), format=format!($($arg)+),
    ))
};}

pub mod version_info;

mod cld;
mod error;

pub use self::{
    cld::*,
    error::*,
};

/// # Result type used in this crate
pub type Result<T> = core::result::Result<T, Error>;

#[test]
fn test_crate_version() {
    assert_eq!(VERSION, env!("CARGO_PKG_VERSION"));
}