spin-sdk 7.0.0

The Spin Rust SDK makes it easy to build Spin components in Rust.
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
94
95

//! The Rust Spin SDK.
//!
//! This crate is the main entry point for building [Spin](https://spinframework.dev)
//! components in Rust. Each capability is exposed as a feature-gated
//! module. All features are enabled by default; disable `default-features`
//! and pick only what you need to slim down compile times.
//!
//! The [`http_service`] and [`redis_subscriber`] attribute macros
//! generate the boilerplate required to expose a component to the
//! Spin runtime.

#![deny(missing_docs)]
#![cfg_attr(docsrs, feature(doc_cfg))]

// Re-export entrypoint macros
pub use spin_macro::{dependencies, http_service, redis_subscriber};

/// Incoming and outgoing HTTP requests.
#[cfg(feature = "http")]
#[cfg_attr(docsrs, doc(cfg(feature = "http")))]
pub mod http;

// Persistent key-value storage.
#[cfg(feature = "key-value")]
#[cfg_attr(docsrs, doc(cfg(feature = "key-value")))]
pub mod key_value;

/// Large-language-model inference.
#[cfg(feature = "llm")]
#[cfg_attr(docsrs, doc(cfg(feature = "llm")))]
pub mod llm;

// MQTT message publishing.
#[cfg(feature = "mqtt")]
#[cfg_attr(docsrs, doc(cfg(feature = "mqtt")))]
pub mod mqtt;

// MySQL database access.
#[cfg(feature = "mysql")]
#[cfg_attr(docsrs, doc(cfg(feature = "mysql")))]
pub mod mysql;

// PostgreSQL database access.
#[cfg(feature = "pg")]
#[cfg_attr(docsrs, doc(cfg(feature = "pg")))]
pub mod pg;

// Redis storage and pub/sub.
#[cfg(feature = "redis")]
#[cfg_attr(docsrs, doc(cfg(feature = "redis")))]
pub mod redis;

/// SQLite database access.
#[cfg(feature = "sqlite")]
#[cfg_attr(docsrs, doc(cfg(feature = "sqlite")))]
pub mod sqlite;

/// Time-related functions.
pub mod time;

// Application variable lookup.
#[cfg(feature = "variables")]
#[cfg_attr(docsrs, doc(cfg(feature = "variables")))]
pub mod variables;

// SAFETY: There should only be a single definition of the spin-sdk-version-* symbol.
#[unsafe(export_name = concat!("spin-sdk-version-", env!("SDK_VERSION")))]
extern "C" fn __spin_sdk_version() {}

// SAFETY: There should only be a single definition of the spin-sdk-language-rust symbol.
#[cfg(feature = "export-sdk-language")]
#[unsafe(export_name = "spin-sdk-language-rust")]
extern "C" fn __spin_sdk_language() {}

// SAFETY: There should only be a single definition of the spin-sdk-commit-* symbol.
#[unsafe(export_name = concat!("spin-sdk-commit-", env!("SDK_COMMIT")))]
extern "C" fn __spin_sdk_hash() {}

pub use wasip3::{self, wit_bindgen};

#[doc(hidden)]
pub mod experimental {
    #![allow(missing_docs)]
    use crate::wit_bindgen;

    wit_bindgen::generate!({
        runtime_path: "crate::wit_bindgen::rt",
        world: "spin-sdk-experimental",
        path: "wit",
        generate_all,
    });
}

#[cfg(test)]
mod test;