rasn 0.28.12

A safe no_std ASN.1 codec framework.
Documentation
//! Representing all possible variants for a `CHOICE` type.

use alloc::{borrow::Cow, vec, vec::Vec};

use crate::types::{Tag, TagTree};

/// A set of tags which represents all possible tags used in this field.
#[derive(Debug, Clone)]
pub struct Variants {
    fields: Vec<Tag>,
}

impl Variants {
    /// Creates a new set of variants from a given set of tag trees.
    #[must_use]
    pub fn new(fields: Cow<'static, [TagTree]>) -> Self {
        Self::flatten_tree((*fields).iter())
    }

    /// Returns an empty set of variants.
    #[must_use]
    pub const fn empty() -> Self {
        Self { fields: Vec::new() }
    }

    /// Creates a new set of variants from a static set of tag trees.
    #[must_use]
    pub fn from_static(fields: &'static [TagTree]) -> Self {
        Self::new(Cow::Borrowed(fields))
    }

    /// Creates a new set of variants a static set of tag trees.
    #[must_use]
    pub fn from_slice(fields: &[TagTree]) -> Self {
        Self::flatten_tree(fields.iter())
    }

    fn flatten_tree<'a, I>(field_iter: I) -> Self
    where
        I: Iterator<Item = &'a TagTree>,
    {
        let fields = field_iter
            .flat_map(|tree| {
                fn flatten_tree(tree: &TagTree) -> Vec<Tag> {
                    match tree {
                        TagTree::Leaf(tag) => vec![*tag],
                        TagTree::Choice(tree) => tree.iter().flat_map(flatten_tree).collect(),
                    }
                }

                flatten_tree(tree)
            })
            .collect();

        Self { fields }
    }
}

impl From<Cow<'static, [TagTree]>> for Variants {
    fn from(fields: Cow<'static, [TagTree]>) -> Self {
        Self::new(fields)
    }
}

impl core::ops::Deref for Variants {
    type Target = [Tag];

    fn deref(&self) -> &Self::Target {
        &self.fields
    }
}