22 releases (1 stable)

new 1.0.0 Feb 28, 2025
1.0.0-rc2 Dec 13, 2024
1.0.0-rc1 Nov 6, 2024
0.12.0 Oct 4, 2024
0.7.3 Nov 8, 2023

#1173 in Database interfaces

Download history 115/week @ 2024-11-02 16/week @ 2024-11-09 14/week @ 2024-11-16 10/week @ 2024-11-23 12/week @ 2024-11-30 58/week @ 2024-12-07 75/week @ 2024-12-14 1/week @ 2024-12-21 4/week @ 2025-01-04 81/week @ 2025-01-11 18/week @ 2025-01-18 113/week @ 2025-01-25 11/week @ 2025-02-01 4/week @ 2025-02-08 1/week @ 2025-02-15

129 downloads per month
Used in 4 crates (via spacetimedb-core)

Custom license

150KB
3K SLoC

Abstract Virtual Machine for execution of end-user logic

It optimizes the code & include a more general "query planner"

The execution is split in 3 "phases":

1- AST formation

Generate the AST (that could be invalid according to the semantics).

This step is outside the [vm] and can be done, for example, by the SQL layer.

Use [dsl] to build the [expr:Expr] that build the AST.

2- AST validation

Calling eval::optimize verify the code has the correct semantics (ie: It checks types, schemas, functions are valid, etc.), and "desugar" the code in a more optimal form for later execution.

This build expr::Expr that is what could be stored in the database, ie: Is like bytecode.

3- Execution

Run the AST build from expr::Expr. It assumes is correct.

Dependencies

~16MB
~314K SLoC