rspack_cacheable_macros 0.100.0

rspack cacheable macros
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

use proc_macro::TokenStream;
use quote::quote;
use syn::{Field, Item, Token, Type, parse_macro_input, parse_quote, visit_mut::VisitMut};

use super::CacheableArgs;

/// A visitor to collect #[cacheable] info on field
#[derive(Default)]
struct FieldAttrVisitor {
  /// Whether any field set #[cacheable(omit_bounds)]
  omit_bounds: bool,
}

impl VisitMut for FieldAttrVisitor {
  fn visit_field_mut(&mut self, f: &mut Field) {
    let mut with_info = None;
    let mut omit_bounds = false;
    f.attrs.retain(|item| {
      if item.path().is_ident("cacheable") {
        let _ = item.parse_nested_meta(|meta| {
          if meta.path.is_ident("with") {
            meta.input.parse::<Token![=]>()?;
            with_info = Some(meta.input.parse::<Type>()?);
            return Ok(());
          }
          if meta.path.is_ident("omit_bounds") {
            omit_bounds = true;
            return Ok(());
          }
          Err(meta.error("unrecognized cacheable arguments"))
        });
        false
      } else {
        true
      }
    });

    // add rkyv with
    if let Some(with_info) = with_info {
      f.attrs.push(parse_quote!(#[rkyv(with=#with_info)]));
    }
    // add rkyv omit_bounds
    if omit_bounds {
      self.omit_bounds = true;
      f.attrs.push(parse_quote!(#[rkyv(omit_bounds)]));
    }
  }
}

/// impl #[cacheable] without with args
pub fn impl_cacheable(tokens: TokenStream, args: CacheableArgs) -> TokenStream {
  let mut input = parse_macro_input!(tokens as Item);

  let mut visitor = FieldAttrVisitor::default();
  visitor.visit_item_mut(&mut input);

  let crate_path = &args.crate_path;
  let archived_impl_hash = if args.hashable {
    quote! {#[rkyv(derive(Hash, PartialEq, Eq))]}
  } else {
    quote! {}
  };
  let bounds = if visitor.omit_bounds {
    quote! {
        #[rkyv(serialize_bounds(
            __S: #crate_path::__private::rkyv::ser::Writer + #crate_path::__private::rkyv::ser::Allocator + #crate_path::__private::rkyv::rancor::Fallible<Error = #crate_path::Error>,
        ))]
        #[rkyv(deserialize_bounds(
            __D: #crate_path::__private::rkyv::rancor::Fallible<Error = #crate_path::Error>
        ))]
        #[rkyv(bytecheck(
            bounds(
                __C: #crate_path::__private::rkyv::validation::ArchiveContext + #crate_path::__private::rkyv::rancor::Fallible<Error = #crate_path::Error>,
            )
        ))]
    }
  } else {
    quote! {}
  };

  quote! {
      #[derive(
          #crate_path::__private::rkyv::Archive,
          #crate_path::__private::rkyv::Deserialize,
          #crate_path::__private::rkyv::Serialize
      )]
      #[rkyv(crate=#crate_path::__private::rkyv)]
      #archived_impl_hash
      #bounds
      #input
  }
  .into()
}