compose-idents 0.3.0

A Rust macro for generating new identifiers (names of variables, functions, traits, etc) by concatenating one or more arbitrary parts and applying other manipulations.
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

use crate::ast::{AliasSpec, Ast, ComposeItemSpec, LoopSpec, NodeId};
use proc_macro2::Span;
use std::rc::Rc;
use syn::spanned::Spanned;
use syn::Block;

/// Root AST produced by the parse phase, containing optional loops, optional alias spec, and a user block.
#[derive(Debug)]
pub struct RawAST {
    id: NodeId,
    loops: Option<Rc<LoopSpec>>,
    spec: Option<Rc<AliasSpec>>,
    block: Block,
}

impl Ast for RawAST {
    fn id(&self) -> NodeId {
        self.id
    }
    fn span(&self) -> Span {
        if let Some(loops) = &self.loops {
            loops.span()
        } else if let Some(spec) = &self.spec {
            spec.span()
        } else {
            self.block.span()
        }
    }
}

impl RawAST {
    /// Creates new RawAST with the given components.
    pub fn new(
        id: NodeId,
        loops: Option<Rc<LoopSpec>>,
        spec: Option<Rc<AliasSpec>>,
        block: Block,
    ) -> Self {
        Self {
            id,
            loops,
            spec,
            block,
        }
    }

    /// Created new RawAST from a [`ComposeItemSpec`] and a code block.
    pub fn from_compose_item_spec(spec: &ComposeItemSpec, block: Block) -> Self {
        Self {
            id: spec.id(),
            loops: spec.loops(),
            spec: spec.spec(),
            block,
        }
    }

    /// Reads the loop specification if any.
    pub fn loops(&self) -> Option<Rc<LoopSpec>> {
        self.loops.clone()
    }

    /// Reads the alias specification if any.
    pub fn spec(&self) -> Option<Rc<AliasSpec>> {
        self.spec.clone()
    }

    /// Reads an immutable reference to the code block.
    pub fn block(&self) -> &Block {
        &self.block
    }
}