fack-codegen 0.2.0

Standalone code generation engine for fack error handling
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

//! Code generation engine for the `fack` derive language.
//!
//! The public API keeps compiler representations opaque while exposing the
//! parse, validate, and expansion stages required by downstream tooling.
#![no_std]
#![forbid(unsafe_code, missing_docs, rustdoc::all)]

extern crate alloc;

mod binding;
mod bounds;
mod diagnostic;
mod enumerate;
mod expand;
mod field;
mod format;
mod resolve;
mod semantics;
mod source;
mod structure;
mod syntax;
mod target;
mod validate;

pub use target::Target;
pub use validate::ValidatedTarget;

/// Parse, validate, and expand one derive input.
///
/// # Errors
///
/// Returns the first syntax, semantic, or expansion diagnostic produced by the
/// engine.
#[inline]
pub fn generate(input: &syn::DeriveInput) -> syn::Result<proc_macro2::TokenStream> {
    Target::input(input)?.validate()?.expand()
}