cling 0.1.3

A lightweight framework that simplifies building complex command-line applications with [clap.rs](https://clap.rs)
Documentation 
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

use crate::params::{CollectedArgs, HandlerParam};

/// Extractor for state in handlers
///
/// When a cling program gets executed with a state of type `S`. The state can
/// be accessed via this extractor in any handler.
///
/// Type `S` must implement [Clone] as it gets cloned every time this extractor
/// runs.
///
/// Example:
/// ```rust
/// use cling::prelude::*;
///
/// #[derive(Collect, ValueEnum, Debug, Clone)]
/// pub enum Colors {
///     Red,
///     Green,
///     Blue,
/// }
///
/// #[derive(Clone, Debug)]
/// struct Database {
///     _data: String,
/// }
///
/// async fn init(
///     State(database): State<Database>,
///     colors: &Option<Vec<Colors>>,
/// ) {
///     println!( ">> Hello world! color: {:?}, database: {:?}", colors, database);
/// }
/// ```
#[derive(Debug, Clone, PartialEq, Eq, Hash, Ord, PartialOrd)]
pub struct State<S: Clone + Send + Sync + 'static>(pub S);

impl<'a, S> HandlerParam<'a> for State<S>
where
    S: Send + Sync + Clone + 'static,
{
    fn extract_param(args: &'a CollectedArgs) -> Option<Self> {
        let Some(state) = args.get::<State<S>>() else {
            return None;
        };
        Some(State(state.0.clone()))
    }
}

#[derive(Clone, Debug)]
/// An extractor for fields annotated with `#[cling(collect)]`
pub struct Collected<T>(pub T);

impl<'a, T> HandlerParam<'a> for Collected<T>
where
    T: Send + Sync + Clone + 'static,
{
    fn extract_param(args: &'a CollectedArgs) -> Option<Self> {
        args.get::<Self>().cloned()
    }
}