Skip to main content

alux_cli/
position.rs

1//! The type of one operation argument, by its position.
2//!
3//! A declaration states one source per operation argument, in order; reading each argument's type
4//! by position lets a lowering check every source against its own argument, where it is written.
5
6use crate::{CliSourceFor, Optional, ProductSource, SumSource, Whole};
7use alux_ext::{ContextArg, StatedArg};
8use alux_shape::{Product, Sum};
9
10/// Says whether the argument at `position` among `names` is named `name`, at compile time.
11#[must_use]
12pub const fn cli_arg_named(names: &[&str], position: usize, name: &str) -> bool {
13    if position >= names.len() {
14        return false;
15    }
16    let (own, name) = (names[position].as_bytes(), name.as_bytes());
17    if own.len() != name.len() {
18        return false;
19    }
20    let mut at = 0;
21    while at < own.len() {
22        if own[at] != name[at] {
23            return false;
24        }
25        at += 1;
26    }
27    true
28}
29
30/// Holds the message a misnamed argument is reported with, written at compile time.
31#[derive(Clone, Copy, Debug)]
32pub struct CliArgMessage {
33    bytes: [u8; 256],
34    len: usize,
35}
36
37impl CliArgMessage {
38    /// Whether there is nothing to report.
39    #[must_use]
40    pub const fn is_empty(&self) -> bool {
41        self.len == 0
42    }
43
44    /// Reads the message.
45    #[must_use]
46    pub const fn as_str(&self) -> &str {
47        match core::str::from_utf8(self.bytes.split_at(self.len).0) {
48            Ok(message) => message,
49            Err(_) => "an argument is not the one `.arg(..)` names",
50        }
51    }
52
53    const fn push(mut self, text: &str) -> Self {
54        let text = text.as_bytes();
55        let mut at = 0;
56        while at < text.len() && self.len < self.bytes.len() {
57            self.bytes[self.len] = text[at];
58            self.len += 1;
59            at += 1;
60        }
61        self
62    }
63
64    const fn push_number(self, number: usize) -> Self {
65        let mut digits = [0u8; 20];
66        let (mut count, mut rest) = (0, number);
67        loop {
68            digits[19 - count] = b"0123456789"[rest % 10];
69            count += 1;
70            rest /= 10;
71            if rest == 0 {
72                break;
73            }
74        }
75        match core::str::from_utf8(digits.split_at(20 - count).1) {
76            Ok(digits) => self.push(digits),
77            Err(_) => self,
78        }
79    }
80}
81
82/// Answers why the argument at `position` of `method` is not named `name`, or an empty message when
83/// it is, at compile time: "argument 0 of `start_node` is `name`, not `fff`".
84#[must_use]
85pub const fn cli_arg_mismatch(method: &str, names: &[&str], position: usize, name: &str) -> CliArgMessage {
86    let message = CliArgMessage { bytes: [0; 256], len: 0 };
87    if cli_arg_named(names, position, name) {
88        return message;
89    }
90    if position >= names.len() {
91        return message
92            .push("`")
93            .push(method)
94            .push("` takes ")
95            .push_number(names.len())
96            .push(" arguments, so `")
97            .push(name)
98            .push("` has no source to bind");
99    }
100    message
101        .push("argument ")
102        .push_number(position)
103        .push(" of `")
104        .push(method)
105        .push("` is `")
106        .push(names[position])
107        .push("`, not `")
108        .push(name)
109        .push("`: sources bind to the operation's arguments in order")
110}
111
112/// States that a source can supply the argument at position `INDEX` of the argument product `Args`.
113#[diagnostic::on_unimplemented(
114    message = "`{Self}` cannot supply argument {INDEX} of the operation",
115    note = "sources bind to the operation's arguments in order, one `.arg(..)` each; check the order of the `.arg(..)` calls"
116)]
117pub trait CliSourceAt<Args, const INDEX: usize> {}
118
119impl<Source, Args, const INDEX: usize> CliSourceAt<Args, INDEX> for Source
120where
121    Args: CliArgAt<INDEX>,
122    Source: CliSourceFor<Args::Arg>,
123{
124}
125
126/// Names the type of the argument at position `INDEX` of an operation's argument product.
127pub trait CliArgAt<const INDEX: usize> {
128    /// The argument's type.
129    type Arg;
130}
131
132impl<A0> CliArgAt<0> for (A0,) {
133    type Arg = A0;
134}
135
136impl<A0, A1> CliArgAt<0> for (A0, A1) {
137    type Arg = A0;
138}
139
140impl<A0, A1> CliArgAt<1> for (A0, A1) {
141    type Arg = A1;
142}
143
144impl<A0, A1, A2> CliArgAt<0> for (A0, A1, A2) {
145    type Arg = A0;
146}
147
148impl<A0, A1, A2> CliArgAt<1> for (A0, A1, A2) {
149    type Arg = A1;
150}
151
152impl<A0, A1, A2> CliArgAt<2> for (A0, A1, A2) {
153    type Arg = A2;
154}
155
156impl<A0, A1, A2, A3> CliArgAt<0> for (A0, A1, A2, A3) {
157    type Arg = A0;
158}
159
160impl<A0, A1, A2, A3> CliArgAt<1> for (A0, A1, A2, A3) {
161    type Arg = A1;
162}
163
164impl<A0, A1, A2, A3> CliArgAt<2> for (A0, A1, A2, A3) {
165    type Arg = A2;
166}
167
168impl<A0, A1, A2, A3> CliArgAt<3> for (A0, A1, A2, A3) {
169    type Arg = A3;
170}
171
172impl<A0, A1, A2, A3, A4> CliArgAt<0> for (A0, A1, A2, A3, A4) {
173    type Arg = A0;
174}
175
176impl<A0, A1, A2, A3, A4> CliArgAt<1> for (A0, A1, A2, A3, A4) {
177    type Arg = A1;
178}
179
180impl<A0, A1, A2, A3, A4> CliArgAt<2> for (A0, A1, A2, A3, A4) {
181    type Arg = A2;
182}
183
184impl<A0, A1, A2, A3, A4> CliArgAt<3> for (A0, A1, A2, A3, A4) {
185    type Arg = A3;
186}
187
188impl<A0, A1, A2, A3, A4> CliArgAt<4> for (A0, A1, A2, A3, A4) {
189    type Arg = A4;
190}
191
192impl<A0, A1, A2, A3, A4, A5> CliArgAt<0> for (A0, A1, A2, A3, A4, A5) {
193    type Arg = A0;
194}
195
196impl<A0, A1, A2, A3, A4, A5> CliArgAt<1> for (A0, A1, A2, A3, A4, A5) {
197    type Arg = A1;
198}
199
200impl<A0, A1, A2, A3, A4, A5> CliArgAt<2> for (A0, A1, A2, A3, A4, A5) {
201    type Arg = A2;
202}
203
204impl<A0, A1, A2, A3, A4, A5> CliArgAt<3> for (A0, A1, A2, A3, A4, A5) {
205    type Arg = A3;
206}
207
208impl<A0, A1, A2, A3, A4, A5> CliArgAt<4> for (A0, A1, A2, A3, A4, A5) {
209    type Arg = A4;
210}
211
212impl<A0, A1, A2, A3, A4, A5> CliArgAt<5> for (A0, A1, A2, A3, A4, A5) {
213    type Arg = A5;
214}
215
216impl<A0, A1, A2, A3, A4, A5, A6> CliArgAt<0> for (A0, A1, A2, A3, A4, A5, A6) {
217    type Arg = A0;
218}
219
220impl<A0, A1, A2, A3, A4, A5, A6> CliArgAt<1> for (A0, A1, A2, A3, A4, A5, A6) {
221    type Arg = A1;
222}
223
224impl<A0, A1, A2, A3, A4, A5, A6> CliArgAt<2> for (A0, A1, A2, A3, A4, A5, A6) {
225    type Arg = A2;
226}
227
228impl<A0, A1, A2, A3, A4, A5, A6> CliArgAt<3> for (A0, A1, A2, A3, A4, A5, A6) {
229    type Arg = A3;
230}
231
232impl<A0, A1, A2, A3, A4, A5, A6> CliArgAt<4> for (A0, A1, A2, A3, A4, A5, A6) {
233    type Arg = A4;
234}
235
236impl<A0, A1, A2, A3, A4, A5, A6> CliArgAt<5> for (A0, A1, A2, A3, A4, A5, A6) {
237    type Arg = A5;
238}
239
240impl<A0, A1, A2, A3, A4, A5, A6> CliArgAt<6> for (A0, A1, A2, A3, A4, A5, A6) {
241    type Arg = A6;
242}
243
244impl<A0, A1, A2, A3, A4, A5, A6, A7> CliArgAt<0> for (A0, A1, A2, A3, A4, A5, A6, A7) {
245    type Arg = A0;
246}
247
248impl<A0, A1, A2, A3, A4, A5, A6, A7> CliArgAt<1> for (A0, A1, A2, A3, A4, A5, A6, A7) {
249    type Arg = A1;
250}
251
252impl<A0, A1, A2, A3, A4, A5, A6, A7> CliArgAt<2> for (A0, A1, A2, A3, A4, A5, A6, A7) {
253    type Arg = A2;
254}
255
256impl<A0, A1, A2, A3, A4, A5, A6, A7> CliArgAt<3> for (A0, A1, A2, A3, A4, A5, A6, A7) {
257    type Arg = A3;
258}
259
260impl<A0, A1, A2, A3, A4, A5, A6, A7> CliArgAt<4> for (A0, A1, A2, A3, A4, A5, A6, A7) {
261    type Arg = A4;
262}
263
264impl<A0, A1, A2, A3, A4, A5, A6, A7> CliArgAt<5> for (A0, A1, A2, A3, A4, A5, A6, A7) {
265    type Arg = A5;
266}
267
268impl<A0, A1, A2, A3, A4, A5, A6, A7> CliArgAt<6> for (A0, A1, A2, A3, A4, A5, A6, A7) {
269    type Arg = A6;
270}
271
272impl<A0, A1, A2, A3, A4, A5, A6, A7> CliArgAt<7> for (A0, A1, A2, A3, A4, A5, A6, A7) {
273    type Arg = A7;
274}
275
276impl<A0, A1, A2, A3, A4, A5, A6, A7, A8> CliArgAt<0> for (A0, A1, A2, A3, A4, A5, A6, A7, A8) {
277    type Arg = A0;
278}
279
280impl<A0, A1, A2, A3, A4, A5, A6, A7, A8> CliArgAt<1> for (A0, A1, A2, A3, A4, A5, A6, A7, A8) {
281    type Arg = A1;
282}
283
284impl<A0, A1, A2, A3, A4, A5, A6, A7, A8> CliArgAt<2> for (A0, A1, A2, A3, A4, A5, A6, A7, A8) {
285    type Arg = A2;
286}
287
288impl<A0, A1, A2, A3, A4, A5, A6, A7, A8> CliArgAt<3> for (A0, A1, A2, A3, A4, A5, A6, A7, A8) {
289    type Arg = A3;
290}
291
292impl<A0, A1, A2, A3, A4, A5, A6, A7, A8> CliArgAt<4> for (A0, A1, A2, A3, A4, A5, A6, A7, A8) {
293    type Arg = A4;
294}
295
296impl<A0, A1, A2, A3, A4, A5, A6, A7, A8> CliArgAt<5> for (A0, A1, A2, A3, A4, A5, A6, A7, A8) {
297    type Arg = A5;
298}
299
300impl<A0, A1, A2, A3, A4, A5, A6, A7, A8> CliArgAt<6> for (A0, A1, A2, A3, A4, A5, A6, A7, A8) {
301    type Arg = A6;
302}
303
304impl<A0, A1, A2, A3, A4, A5, A6, A7, A8> CliArgAt<7> for (A0, A1, A2, A3, A4, A5, A6, A7, A8) {
305    type Arg = A7;
306}
307
308impl<A0, A1, A2, A3, A4, A5, A6, A7, A8> CliArgAt<8> for (A0, A1, A2, A3, A4, A5, A6, A7, A8) {
309    type Arg = A8;
310}
311
312impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9> CliArgAt<0> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) {
313    type Arg = A0;
314}
315
316impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9> CliArgAt<1> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) {
317    type Arg = A1;
318}
319
320impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9> CliArgAt<2> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) {
321    type Arg = A2;
322}
323
324impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9> CliArgAt<3> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) {
325    type Arg = A3;
326}
327
328impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9> CliArgAt<4> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) {
329    type Arg = A4;
330}
331
332impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9> CliArgAt<5> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) {
333    type Arg = A5;
334}
335
336impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9> CliArgAt<6> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) {
337    type Arg = A6;
338}
339
340impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9> CliArgAt<7> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) {
341    type Arg = A7;
342}
343
344impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9> CliArgAt<8> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) {
345    type Arg = A8;
346}
347
348impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9> CliArgAt<9> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) {
349    type Arg = A9;
350}
351
352impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<0> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
353    type Arg = A0;
354}
355
356impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<1> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
357    type Arg = A1;
358}
359
360impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<2> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
361    type Arg = A2;
362}
363
364impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<3> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
365    type Arg = A3;
366}
367
368impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<4> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
369    type Arg = A4;
370}
371
372impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<5> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
373    type Arg = A5;
374}
375
376impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<6> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
377    type Arg = A6;
378}
379
380impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<7> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
381    type Arg = A7;
382}
383
384impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<8> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
385    type Arg = A8;
386}
387
388impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<9> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
389    type Arg = A9;
390}
391
392impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10> CliArgAt<10> for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) {
393    type Arg = A10;
394}
395
396impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<0>
397    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
398{
399    type Arg = A0;
400}
401
402impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<1>
403    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
404{
405    type Arg = A1;
406}
407
408impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<2>
409    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
410{
411    type Arg = A2;
412}
413
414impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<3>
415    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
416{
417    type Arg = A3;
418}
419
420impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<4>
421    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
422{
423    type Arg = A4;
424}
425
426impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<5>
427    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
428{
429    type Arg = A5;
430}
431
432impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<6>
433    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
434{
435    type Arg = A6;
436}
437
438impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<7>
439    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
440{
441    type Arg = A7;
442}
443
444impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<8>
445    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
446{
447    type Arg = A8;
448}
449
450impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<9>
451    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
452{
453    type Arg = A9;
454}
455
456impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<10>
457    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
458{
459    type Arg = A10;
460}
461
462impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11> CliArgAt<11>
463    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11)
464{
465    type Arg = A11;
466}
467
468impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<0>
469    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
470{
471    type Arg = A0;
472}
473
474impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<1>
475    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
476{
477    type Arg = A1;
478}
479
480impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<2>
481    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
482{
483    type Arg = A2;
484}
485
486impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<3>
487    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
488{
489    type Arg = A3;
490}
491
492impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<4>
493    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
494{
495    type Arg = A4;
496}
497
498impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<5>
499    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
500{
501    type Arg = A5;
502}
503
504impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<6>
505    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
506{
507    type Arg = A6;
508}
509
510impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<7>
511    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
512{
513    type Arg = A7;
514}
515
516impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<8>
517    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
518{
519    type Arg = A8;
520}
521
522impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<9>
523    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
524{
525    type Arg = A9;
526}
527
528impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<10>
529    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
530{
531    type Arg = A10;
532}
533
534impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<11>
535    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
536{
537    type Arg = A11;
538}
539
540impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12> CliArgAt<12>
541    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12)
542{
543    type Arg = A12;
544}
545
546impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<0>
547    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
548{
549    type Arg = A0;
550}
551
552impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<1>
553    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
554{
555    type Arg = A1;
556}
557
558impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<2>
559    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
560{
561    type Arg = A2;
562}
563
564impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<3>
565    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
566{
567    type Arg = A3;
568}
569
570impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<4>
571    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
572{
573    type Arg = A4;
574}
575
576impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<5>
577    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
578{
579    type Arg = A5;
580}
581
582impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<6>
583    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
584{
585    type Arg = A6;
586}
587
588impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<7>
589    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
590{
591    type Arg = A7;
592}
593
594impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<8>
595    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
596{
597    type Arg = A8;
598}
599
600impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<9>
601    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
602{
603    type Arg = A9;
604}
605
606impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<10>
607    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
608{
609    type Arg = A10;
610}
611
612impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<11>
613    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
614{
615    type Arg = A11;
616}
617
618impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<12>
619    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
620{
621    type Arg = A12;
622}
623
624impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13> CliArgAt<13>
625    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13)
626{
627    type Arg = A13;
628}
629
630impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<0>
631    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
632{
633    type Arg = A0;
634}
635
636impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<1>
637    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
638{
639    type Arg = A1;
640}
641
642impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<2>
643    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
644{
645    type Arg = A2;
646}
647
648impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<3>
649    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
650{
651    type Arg = A3;
652}
653
654impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<4>
655    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
656{
657    type Arg = A4;
658}
659
660impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<5>
661    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
662{
663    type Arg = A5;
664}
665
666impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<6>
667    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
668{
669    type Arg = A6;
670}
671
672impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<7>
673    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
674{
675    type Arg = A7;
676}
677
678impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<8>
679    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
680{
681    type Arg = A8;
682}
683
684impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<9>
685    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
686{
687    type Arg = A9;
688}
689
690impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<10>
691    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
692{
693    type Arg = A10;
694}
695
696impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<11>
697    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
698{
699    type Arg = A11;
700}
701
702impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<12>
703    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
704{
705    type Arg = A12;
706}
707
708impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<13>
709    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
710{
711    type Arg = A13;
712}
713
714impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14> CliArgAt<14>
715    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14)
716{
717    type Arg = A14;
718}
719
720impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<0>
721    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
722{
723    type Arg = A0;
724}
725
726impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<1>
727    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
728{
729    type Arg = A1;
730}
731
732impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<2>
733    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
734{
735    type Arg = A2;
736}
737
738impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<3>
739    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
740{
741    type Arg = A3;
742}
743
744impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<4>
745    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
746{
747    type Arg = A4;
748}
749
750impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<5>
751    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
752{
753    type Arg = A5;
754}
755
756impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<6>
757    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
758{
759    type Arg = A6;
760}
761
762impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<7>
763    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
764{
765    type Arg = A7;
766}
767
768impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<8>
769    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
770{
771    type Arg = A8;
772}
773
774impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<9>
775    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
776{
777    type Arg = A9;
778}
779
780impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<10>
781    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
782{
783    type Arg = A10;
784}
785
786impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<11>
787    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
788{
789    type Arg = A11;
790}
791
792impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<12>
793    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
794{
795    type Arg = A12;
796}
797
798impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<13>
799    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
800{
801    type Arg = A13;
802}
803
804impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<14>
805    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
806{
807    type Arg = A14;
808}
809
810impl<A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15> CliArgAt<15>
811    for (A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15)
812{
813    type Arg = A15;
814}
815
816/// States that a source can supply an argument as its method states it: a stated type is checked,
817/// one the context decides is left to the interpretation.
818#[diagnostic::on_unimplemented(
819    message = "`{Self}` cannot supply this argument as its method states it",
820    note = "sources bind to the operation's arguments in order, one `.arg(..)` each; check the order of the `.arg(..)` calls"
821)]
822pub trait CliStatedFor<Stated> {}
823
824impl<Source, Arg> CliStatedFor<StatedArg<Arg>> for Source where Source: CliSourceFor<Arg> {}
825
826impl<Source> CliStatedFor<ContextArg> for Source {}
827
828/// Names the parts a compound source supplies an argument's parts to, as the argument's type names
829/// them: a product's fields or a sum's alternatives; none for an argument the context decides.
830pub trait CliPartsFor<Stated> {
831    /// The argument's part names, in order.
832    const PARTS: &'static [&'static str];
833    /// What one part is called: `field` or `alternative`.
834    const PART: &'static str;
835    /// What the whole is called: `product` or `sum`.
836    const WHOLE: &'static str;
837}
838
839impl<Fields, Value> CliPartsFor<StatedArg<Value>> for ProductSource<Fields, Whole>
840where
841    Value: Product,
842{
843    const PARTS: &'static [&'static str] = Value::FIELDS;
844    const PART: &'static str = "field";
845    const WHOLE: &'static str = "product";
846}
847
848impl<Fields, Value> CliPartsFor<StatedArg<Option<Value>>> for ProductSource<Fields, Optional>
849where
850    Value: Product,
851{
852    const PARTS: &'static [&'static str] = Value::FIELDS;
853    const PART: &'static str = "field";
854    const WHOLE: &'static str = "product";
855}
856
857impl<Alternatives, Value> CliPartsFor<StatedArg<Value>> for SumSource<Alternatives, Whole>
858where
859    Value: Sum,
860{
861    const PARTS: &'static [&'static str] = Value::ALTERNATIVES;
862    const PART: &'static str = "alternative";
863    const WHOLE: &'static str = "sum";
864}
865
866impl<Alternatives, Value> CliPartsFor<StatedArg<Option<Value>>> for SumSource<Alternatives, Optional>
867where
868    Value: Sum,
869{
870    const PARTS: &'static [&'static str] = Value::ALTERNATIVES;
871    const PART: &'static str = "alternative";
872    const WHOLE: &'static str = "sum";
873}
874
875impl<Source> CliPartsFor<ContextArg> for Source {
876    const PARTS: &'static [&'static str] = &[];
877    const PART: &'static str = "part";
878    const WHOLE: &'static str = "argument";
879}
880
881/// Answers why the part at `position` of the argument `stated` states, which `Source` supplies, is
882/// not named `name`, or an empty message when it is or when no names are known, at compile time:
883/// "field 1 of the product is `port`, not `addr`".
884#[must_use]
885pub const fn cli_part_mismatch<Source, Stated>(_stated: &Stated, position: usize, name: &str) -> CliArgMessage
886where
887    Source: CliPartsFor<Stated>,
888{
889    let (names, part, whole) = (Source::PARTS, Source::PART, Source::WHOLE);
890    let message = CliArgMessage { bytes: [0; 256], len: 0 };
891    if names.is_empty() || cli_arg_named(names, position, name) {
892        return message;
893    }
894    if position >= names.len() {
895        return message
896            .push("the ")
897            .push(whole)
898            .push(" has ")
899            .push_number(names.len())
900            .push(" ")
901            .push(part)
902            .push("s, so `")
903            .push(name)
904            .push("` has no ")
905            .push(part)
906            .push(" to bind");
907    }
908    message
909        .push(part)
910        .push(" ")
911        .push_number(position)
912        .push(" of the ")
913        .push(whole)
914        .push(" is `")
915        .push(names[position])
916        .push("`, not `")
917        .push(name)
918        .push("`: sources bind to the ")
919        .push(whole)
920        .push("'s ")
921        .push(part)
922        .push("s in order")
923}
924
925/// Checks, at compile time, that `Source` can supply the argument `stated` states.
926pub const fn cli_source_stated<Source, Stated>(_stated: &Stated)
927where
928    Source: CliStatedFor<Stated>,
929{
930}