spacetimedb-primitives 2.2.0

Primitives such as TableId and ColumnIndexAttribute
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

//! Error numbers for the wasm abi.

use core::num::NonZeroU16;

/// Takes a macro that expects `$($err_name:ident($errno:literal, $errmsg:literal),)*` and invokes
/// it with the errnos defined in this module.
#[macro_export]
macro_rules! errnos {
    ($mac:ident) => {
        $mac!(
            HOST_CALL_FAILURE(1, "ABI called by host returned an error"),
            NOT_IN_TRANSACTION(2, "ABI call can only be made while in a transaction"),
            BSATN_DECODE_ERROR(3, "Couldn't decode the BSATN to the expected type"),
            NO_SUCH_TABLE(4, "No such table"),
            NO_SUCH_INDEX(5, "No such index"),
            NO_SUCH_ITER(6, "The provided row iterator is not valid"),
            NO_SUCH_CONSOLE_TIMER(7, "The provided console timer does not exist"),
            NO_SUCH_BYTES(8, "The provided bytes source or sink is not valid"),
            NO_SPACE(9, "The provided sink has no more space left"),
            WRONG_INDEX_ALGO(10, "The Index does not support range scans"),
            BUFFER_TOO_SMALL(11, "The provided buffer is not large enough to store the data"),
            UNIQUE_ALREADY_EXISTS(12, "Value with given unique identifier already exists"),
            SCHEDULE_AT_DELAY_TOO_LONG(13, "Specified delay in scheduling row was too long"),
            INDEX_NOT_UNIQUE(14, "The index was not unique"),
            NO_SUCH_ROW(15, "The row was not found, e.g., in an update call"),
            AUTO_INC_OVERFLOW(16, "The auto-increment sequence overflowed"),
            WOULD_BLOCK_TRANSACTION(
                17,
                "Attempted async or blocking op while holding open a transaction"
            ),
            TRANSACTION_NOT_ANONYMOUS(18, "Not in an anonymous transaction. Called by a reducer?"),
            TRANSACTION_IS_READ_ONLY(19, "ABI call can only be made while within a mutable transaction"),
            TRANSACTION_IS_MUT(
                20,
                "ABI call can only be made while within a read-only transaction"
            ),
            HTTP_ERROR(21, "The HTTP request failed"),
        );
    };
}
pub use errnos;

const fn nz(n: u16) -> NonZeroU16 {
    match NonZeroU16::new(n) {
        Some(n) => n,
        None => panic!(),
    }
}

macro_rules! def_errnos {
    ($($err_name:ident($errno:literal, $errmsg:literal),)*) => {
        $(#[doc = $errmsg] pub const $err_name: NonZeroU16 = nz($errno);)*

        /// Get the error message for an error number, if it exists.
        pub const fn strerror(num: NonZeroU16) -> Option<&'static str> {
            match num.get() {
                $($errno => Some($errmsg),)*
                _ => None,
            }
        }
    };
}
errnos!(def_errnos);