cratestack-macros 0.7.7

Rust-native schema-first framework for typed HTTP APIs, generated clients, and backend services.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

//! Procedure-attribute predicates. Currently just `@stream` — see
//! `crate::procedure::generate_procedure_registry_method` and
//! `crate::axum::procedure` for the two call sites that need to agree on
//! whether a procedure is stream-shaped.

use cratestack_core::Procedure;

/// Procedure carries a bare `@stream` attribute — opts a `T[]`-returning
/// procedure's generated `ProcedureRegistry` trait method into a
/// stream-shaped return instead of the default buffered
/// `Future<Output = Result<Vec<T>, _>>`. `cratestack-parser` rejects
/// `@stream` on a non-list return type before macro codegen ever runs
/// (see `cratestack_parser::validate::stream_attribute`), so callers here
/// may assume list arity whenever this returns `true`.
pub(crate) fn is_stream_procedure(procedure: &Procedure) -> bool {
    procedure
        .attributes
        .iter()
        .any(|attribute| attribute.raw == "@stream")
}