clap-config-fallback-derive 0.1.13

Macro implementation of #[derive(ConfigParser)]
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
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

use darling::{
    Error, FromVariant,
    ast::{Fields, Style},
};
use syn::{Ident, Type};

use crate::{
    TypeExt,
    derive::{Field, NamedField, Skippable},
};

/// Normalized variant shape.
pub enum VariantShape {
    /// Variant without payload.
    Unit,
    /// Variant with a single field payload.
    Newtype(Type),
    /// Variant with named fields payload.
    Struct(Vec<NamedField>),
}

/// Parsed enum variant metadata.
#[derive(FromVariant)]
#[darling(attributes(config),  and_then = Self::autocorrect)]
pub struct Variant {
    ident: Ident,
    fields: Fields<Field>,
    #[darling(default)]
    pub(crate) skip: bool,
}

impl Skippable for Variant {
    fn is_skipped(&self) -> bool {
        self.skip
    }
}

impl Variant {
    /// Variant identifier.
    pub fn ident(&self) -> &Ident {
        &self.ident
    }

    /// Returns the normalized variant shape.
    pub fn shape(&self) -> VariantShape {
        if self.is_unit() {
            VariantShape::Unit
        } else if let Some(ty) = self.as_newtype() {
            VariantShape::Newtype(ty)
        } else if let Some(fields) = self.as_struct() {
            VariantShape::Struct(fields)
        } else {
            unreachable!("variant must be either empty, newtype, or struct")
        }
    }

    /// Returns true if the variant has no fields.
    pub fn is_unit(&self) -> bool {
        self.fields.is_unit()
    }

    /// Returns the inner field type for newtype variants.
    pub fn as_newtype(&self) -> Option<Type> {
        self.fields
            .is_newtype()
            .then(|| self.fields.fields.first().unwrap().ty().clone())
    }

    /// Returns named fields for struct variants.
    pub fn as_struct(&self) -> Option<Vec<NamedField>> {
        self.fields.is_struct().then(|| {
            self.fields
                .fields
                .iter()
                .cloned()
                .map(|field| field.try_into().unwrap())
                .collect()
        })
    }

    /// Normalizes the variant shape and applies consistency checks.
    ///
    /// Returns an error if the variant is invalid, such as tuple variants with more than one field
    /// or struct variants with unnamed fields.
    fn autocorrect(mut self) -> Result<Self, Error> {
        let mut error = Error::accumulator();

        if let Some(ty) = self.as_newtype()
            && ty.is_unit()
        {
            self.fields = Fields::new(Style::Unit, Vec::default());
        }

        if self.fields.is_tuple() && self.fields.fields.len() != 1 {
            error.push(Error::custom("tuple enums are not supported").with_span(self.ident()));
        }

        if self.fields.is_struct() {
            for field in self.fields.fields.iter() {
                if field.ident().is_none() {
                    error.push(
                        Error::custom("struct enums requires named fields").with_span(field.ty()),
                    );
                }
            }
        }

        error.finish().map(|_| self)
    }
}