Files
Jason Larabie 52b6c66fa1 Add C++ Bindings (#3544)
# Description of Changes

This adds C++ server bindings (/crate/bindings-cpp) to allow writing C++
20 modules.

- Emscripten WASM build system integration with CMake
- Macro-based code generation (SPACETIMEDB_TABLE, SPACETIMEDB_REDUCER,
etc)
- All SpacetimeDB types supported (primitives, Timestamp, Identity,
Uuid, etc)
- Product types via SPACETIMEDB_STRUCT
- Sum types via SPACETIMEDB_ENUM
- Constraints marked with FIELD* macros

# API and ABI breaking changes

None

# Expected complexity level and risk

2 - Doesn't heavily impact any other areas but is complex macro C++
structure to support a similar developer experience, did have a small
impact on init command

# Testing

- [x] modules/module-test-cpp - heavily tested every reducer
- [x] modules/benchmarks-cpp - tested through the standalone (~6x faster
than C#, ~6x slower than Rust)
- [x] modules/sdk-test-cpp
- [x] modules/sdk-test-procedure-cpp
- [x] modules/sdk-test-view-cpp  
- [x] Wrote several test modules myself
- [x] Quickstart smoketest [Currently in progress]
- [ ] Write Blackholio C++ server module

---------

Signed-off-by: Jason Larabie <jason@clockworklabs.io>
Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
Co-authored-by: Ryan <r.ekhoff@clockworklabs.io>
Co-authored-by: John Detter <4099508+jdetter@users.noreply.github.com>
2026-02-07 04:26:45 +00:00

26 lines
765 B
Markdown

# SDK Test Procedure C++
This module tests the procedure functionality in the SpacetimeDB C++ bindings.
## Tests Included
- **return_primitive**: Procedure returning primitive type (u32)
- **return_struct**: Procedure returning custom struct
- **return_enum_a/return_enum_b**: Procedures returning enum variants
- **will_panic**: Procedure that panics (for error testing)
## Tests Excluded (Part 2+)
The following Rust tests are excluded as they require features not yet implemented:
- HTTP requests (`read_my_schema`, `invalid_request`)
- Transactions (`insert_with_tx_commit`, `insert_with_tx_rollback`)
- Scheduled procedures (`schedule_proc`, `scheduled_proc`)
## Building
```bash
.\compile.bat
```
This will generate `lib.wasm` in the build directory.