Struct ServerFnCall

pub struct ServerFnCall { /* private fields */ }

A parsed server function call.

Implementations

impl ServerFnCall

pub fn parse( default_path: &str, args: TokenStream2, body: TokenStream2, ) -> Result<Self>

Parse the arguments of a server function call.

#[proc_macro_attribute]
pub fn server(args: proc_macro::TokenStream, s: TokenStream) -> TokenStream {
    match ServerFnCall::parse(
        "/api",
        args.into(),
        s.into(),
    ) {
        Err(e) => e.to_compile_error().into(),
        Ok(s) => s.to_token_stream().into(),
    }
}

pub fn get_args(&self) -> &ServerFnArgs

Get a reference to the server function arguments.

pub fn get_args_mut(&mut self) -> &mut ServerFnArgs

Get a mutable reference to the server function arguments.

pub fn get_body(&self) -> &ServerFnBody

Get a reference to the server function body.

pub fn get_body_mut(&mut self) -> &mut ServerFnBody

Get a mutable reference to the server function body.

pub fn default_server_fn_path(self, path: Option<Path>) -> Self

Set the path to the server function crate.

pub fn default_server_type(self, server: Option<Type>) -> Self

Set the default server implementation.

pub fn default_protocol(self, protocol: Option<Type>) -> Self

Set the default protocol.

pub fn default_input_encoding(self, protocol: Option<Type>) -> Self

Set the default input http encoding. This will be used by Self::protocol if no protocol or default protocol is set or if only the output encoding is set

Defaults to PostUrl

pub fn default_output_encoding(self, protocol: Option<Type>) -> Self

Set the default output http encoding. This will be used by Self::protocol if no protocol or default protocol is set or if only the input encoding is set

Defaults to Json

pub fn client_type(&self) -> Type

Get the client type to use for the server function.

pub fn server_type(&self) -> Type

Get the server type to use for the server function.

pub fn server_fn_path(&self) -> Path

Get the path to the server_fn crate.

pub fn http_encodings(&self) -> Option<(Type, Type)>

Get the http input and output encodings for the server function if no protocol is set

pub fn protocol(&self) -> Type

Get the protocol to use for the server function.

pub fn docs(&self) -> TokenStream2

Get the docs for the server function.

pub fn struct_name(&self) -> Ident

Get the name of the server function struct that will be submitted to inventory.

This will either be the name specified in the macro arguments or the PascalCase version of the function name.

pub fn submit_to_inventory(&self) -> TokenStream2

Generate the code to submit the server function type to inventory.

pub fn server_fn_url(&self) -> TokenStream2

Generate the server function’s URL. This will be the prefix path, then by the module path if SERVER_FN_MOD_PATH is set, then the function name, and finally a hash of the function name and location in the source code.

Trait Implementations

impl ToTokens for ServerFnCall

fn to_tokens(&self, tokens: &mut TokenStream2)

Write self to the given TokenStream.

fn to_token_stream(&self) -> TokenStream

Convert self directly into a TokenStream object.

fn into_token_stream(self) -> TokenStream

where Self: Sized,

Convert self directly into a TokenStream object.