Skip to main content

Crate excel_api_macros

Crate excel_api_macros 

Source
Expand description

§excel-api-macros

Procedural attributes for the excel-api native XLL framework. Normally use them through excel-api’s default macros feature rather than depending on this crate directly.

#[excel_function] and #[excel_command] retain the annotated Rust function, generate deterministic registration metadata, and emit a panic-contained native Excel ABI thunk. Their signature model is deliberately closed: unsupported argument/result types, borrowed returns, generic functions, incompatible context/flag combinations, and malformed metadata are compile-time errors.

See the complete macro reference and the trybuild fixtures in the repository for supported and rejected forms. Async function support is preview and requires owned inputs; it never permits a worker to call Excel directly.

Licensed under either Apache-2.0 or MIT.

§Excel authoring attributes

This crate supplies the attributes re-exported by excel-api’s default macros feature. They retain the annotated Rust function, generate a fixed registration descriptor, and emit a panic-contained Excel ABI thunk with the requested exported name. They accept a deliberately closed signature model; unsupported types and incompatible context/flag combinations are rejected at compile time.

See the repository macro reference for the complete syntax, mapping tables, and compile-fail examples. The trybuild suite is the normative regression test for diagnostic text.

Attribute Macros§

excel_command
Mark a Rust function for future command registration.
excel_function
Generate deterministic worksheet-function registration metadata and an ABI thunk.