pdk-macros 1.6.0

PDK 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

// Copyright (c) 2025, Salesforce, Inc.,
// All rights reserved.
// For full license text, see the LICENSE.txt file

//! PDK Macros
//!
//! This module provides the macros to declare the entry points of your code as a custom policy.

mod entrypoint;

use crate::entrypoint::{generate_entrypoint, generate_entrypoint_flex};
use proc_macro2::TokenStream;

#[proc_macro_attribute]
/// Use this macro to annotate the configuration function for you custom policy.
/// ```rust
/// #[entrypoint]
/// async fn configure(
///     launcher: Launcher,
///     Configuration(configuration): Configuration,
/// ) -> anyhow::Result<()> {
///     ...
/// }
/// ```
pub fn entrypoint(
    metadata: proc_macro::TokenStream,
    input: proc_macro::TokenStream,
) -> proc_macro::TokenStream {
    let input = TokenStream::from(input);
    let metadata = TokenStream::from(metadata);
    let output = match generate_entrypoint(metadata, input) {
        Ok(stream) => stream,
        Err(error) => error.to_compile_error(),
    };
    proc_macro::TokenStream::from(output)
}

#[proc_macro_attribute]
/// Macro to annotate the setup function for the flex abi entrypoint. Manual usage of this macro is
/// discouraged. It should is automatically handled with the autogenerated code from the policy definition.
pub fn entrypoint_flex(
    metadata: proc_macro::TokenStream,
    input: proc_macro::TokenStream,
) -> proc_macro::TokenStream {
    let input = TokenStream::from(input);
    let metadata = TokenStream::from(metadata);
    let output = match generate_entrypoint_flex(metadata, input) {
        Ok(stream) => stream,
        Err(error) => error.to_compile_error(),
    };
    proc_macro::TokenStream::from(output)
}