facet-core 0.45.0

Core reflection traits and types for the facet ecosystem - provides the Facet trait, Shape metadata, and type-erased pointers
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

#![cfg(feature = "fn-ptr")]

use crate::{
    Facet, FunctionAbi, FunctionPointerDef, PointerType, Shape, ShapeBuilder, Type, TypeOpsDirect,
    TypeParam, VTableDirect, Variance, VarianceDep, VarianceDesc, type_ops_direct, vtable_direct,
};

macro_rules! impl_facet_for_fn_ptr {
    // Used to implement the next bigger `fn` type, by taking the next typename out of `remaining`,
    // if it exists.
    {
        continue from $(extern $extern:literal)? fn($($args:ident),*) -> R with $abi:expr,
        remaining ()
    } => {};
    {
        continue from $(extern $extern:literal)? fn($($args:ident),*) -> R with $abi:expr,
        remaining ($next:ident $(, $remaining:ident)*)
    } => {
        impl_facet_for_fn_ptr! {
            impl $(extern $extern)? fn($($args,)* $next) -> R with $abi,
            remaining ($($remaining),*)
        }
    };
    // Actually generate the trait implementation, and keep the remaining possible arguments around
    {
        impl $(extern $extern:literal)? fn($($args:ident),*) -> R with $abi:expr,
        remaining ($($remaining:ident),*)
    } => {
        unsafe impl<'a, $($args,)* R> Facet<'a> for $(extern $extern)? fn($($args),*) -> R
        where
            $($args: Facet<'a>,)*
            R: Facet<'a>,
        {
            const SHAPE: &'static Shape = &const {
                const fn build_vtable<$($args,)* R>() -> VTableDirect {
                    vtable_direct!($(extern $extern)? fn($($args),*) -> R =>
                        Debug,
                        PartialEq,
                        PartialOrd,
                        Ord,
                    )
                }

                const fn build_type_ops<$($args,)* R>() -> TypeOpsDirect {
                    type_ops_direct!($(extern $extern)? fn($($args),*) -> R => Clone)
                }

                ShapeBuilder::for_sized::<$(extern $extern)? fn($($args),*) -> R>("fn")
                    .decl_id(crate::DeclId::new(crate::decl_id_hash("#fn#fn")))
                    .ty(Type::Pointer(PointerType::Function(
                        FunctionPointerDef::new($abi, &[$($args::SHAPE),*], R::SHAPE)
                    )))
                    .type_params(&[
                        $(TypeParam { name: stringify!($args), shape: $args::SHAPE },)*
                    ])
                    .vtable_direct(&const { build_vtable::<$($args,)* R>() })
                    .type_ops_direct(&const { build_type_ops::<$($args,)* R>() })
                    // Compute variance based on argument and return types.
                    // Arguments are contravariant (flipped), returns are covariant.
                    // With bivariance: fn(i32) -> i32 is bivariant, not invariant!
                    // See: https://github.com/facet-rs/facet/issues/1708
                    .variance(VarianceDesc {
                        base: Variance::Bivariant,
                        deps: &const { [
                            $(VarianceDep::contravariant($args::SHAPE),)*
                            VarianceDep::covariant(R::SHAPE),
                        ] },
                    })
                    .eq()
                    .copy()
                    .build()
            };
        }
        impl_facet_for_fn_ptr! {
            continue from $(extern $extern)? fn($($args),*) -> R with $abi,
            remaining ($($remaining),*)
        }
    };
    // The entry point into this macro, all smaller `fn` types get implemented as well.
    {$(extern $extern:literal)? fn($($args:ident),*) -> R with $abi:expr} => {
        impl_facet_for_fn_ptr! {
            impl $(extern $extern)? fn() -> R with $abi,
            remaining ($($args),*)
        }
    };
}

impl_facet_for_fn_ptr! { fn(T0, T1, T2, T3, T4, T5) -> R with FunctionAbi::Rust }
impl_facet_for_fn_ptr! { extern "C" fn(T0, T1, T2, T3, T4, T5) -> R with FunctionAbi::C }