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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
use mingling_core::{ChainProcess, Groupped, ProgramCollect};
use crate::{picker::Pickable, picker::Picker, picker::PickerArg, picker::PickerPattern1};
/// Trait for converting Mingling entry types (types that implement `Groupped<R>` and `Into<Vec<String>>`)
/// into [`Picker`] instances for a given route type `R`.
///
/// This trait provides a bridge between entry definitions created with the `mingling` framework
/// and the picker argument system used for CLI argument parsing and routing.
///
/// # Type Parameters
///
/// * `'a` — The lifetime of the picker and its references to argument definitions.
/// * `This` — The program type used for dispatching runtime routes; must implement [`ProgramCollect`].
/// * `Route` — The route type used for dispatching; must implement [`Groupped<This>`].
pub trait EntryPicker<'a, This> {
/// Converts `self` into a [`Picker`] for the given route type `Route`.
fn to_picker(self) -> Picker<'a, ChainProcess<This>>;
/// Starts building a picker pattern with the first argument.
///
/// Returns a [`PickerPattern1`] that can be further chained with additional
/// arguments, defaults, routes, and post-processing.
///
/// # Type Parameters
///
/// * `Next` — The nominal type of the first argument; must implement [`Pickable`].
///
/// # Parameters
///
/// * `arg` — The argument definition, typically obtained from [`crate::macros::arg`].
fn pick<Next>(
self,
arg: impl Into<&'a PickerArg<'a, Next>>,
) -> PickerPattern1<'a, Next, ChainProcess<This>>
where
Self: Sized,
Next: Pickable<'a> + Default + Sized,
{
let picker = Self::to_picker(self);
Picker::build_pattern1(picker.into_args(), arg.into(), None)
}
/// Starts building a picker pattern with the first argument, using a default value provider.
///
/// This is a shorthand for calling `.pick(arg).or(func)`.
///
/// # Type Parameters
///
/// * `Next` — The nominal type of the first argument; must implement [`Pickable`].
///
/// # Parameters
///
/// * `arg` — The argument definition, typically obtained from [`crate::macros::arg`].
/// * `func` — A closure that provides a default value if the arg is not provided by the user.
fn pick_or<Next, F>(
self,
arg: impl Into<&'a PickerArg<'a, Next>>,
func: F,
) -> PickerPattern1<'a, Next, ChainProcess<This>>
where
Self: Sized,
Next: Pickable<'a> + Default + Sized,
F: FnMut() -> Next + 'static,
{
self.pick(arg).or(func)
}
/// Starts building a picker pattern with the first argument, using a default value.
///
/// This is a shorthand for calling `.pick(arg).or_default()`.
///
/// # Type Parameters
///
/// * `Next` — The nominal type of the first argument; must implement [`Pickable`] and [`Default`].
///
/// # Parameters
///
/// * `arg` — The argument definition, typically obtained from [`crate::macros::arg`].
fn pick_or_default<Next>(
self,
arg: impl Into<&'a PickerArg<'a, Next>>,
) -> PickerPattern1<'a, Next, ChainProcess<This>>
where
Self: Sized,
Next: Pickable<'a> + Default + Sized,
{
self.pick(arg).or_default()
}
/// Starts building a picker pattern with the first argument, using a route if the arg is not provided.
///
/// This is a shorthand for calling `.pick(arg).or_route(func)`.
///
/// # Type Parameters
///
/// * `Next` — The nominal type of the first argument; must implement [`Pickable`].
///
/// # Parameters
///
/// * `arg` — The argument definition, typically obtained from [`crate::macros::arg`].
/// * `func` — A closure that produces a route value if the arg is not provided by the user.
fn pick_or_route<Next, F>(
self,
arg: impl Into<&'a PickerArg<'a, Next>>,
func: F,
) -> PickerPattern1<'a, Next, ChainProcess<This>>
where
Self: Sized,
Next: Pickable<'a> + Default + Sized,
F: FnMut() -> ChainProcess<This> + 'static,
{
self.pick(arg).or_route(func)
}
}
impl<'a, This, Bind> EntryPicker<'a, This> for Bind
where
This: ProgramCollect<Enum = This>,
Bind: Groupped<This> + Into<Vec<String>>,
{
fn to_picker(self) -> Picker<'a, ChainProcess<This>> {
let args = self.into();
Picker::from(args)
}
}
|
