somnia 0.8.0

Type-safe SurrealDB ORM for Rust: typed query builder, #[derive(SurrealRecord)], schema generation, and Diesel-style migrations.
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

//! # somnia — Type-safe SurrealDB ORM
//!
//! ```ignore
//! use somnia::{SomniaClient, SurrealRecord, Thing};
//! use serde::{Deserialize, Serialize};
//!
//! #[derive(SurrealRecord, Serialize, Deserialize)]
//! #[table("asset")]
//! struct Asset {
//!     #[field(thing)]
//!     id: Thing<Asset>,
//!     name: String,
//!     #[field(name = "content_type")]
//!     content_type: Option<String>,
//!     file_size: Option<i64>,
//! }
//!
//! async fn example() -> Result<(), SomniaError> {
//!     let db = SomniaClient::connect("ws://localhost:8000", "root", "root", "ns", "db").await?;
//!
//!     // Typed column accessors are generated by the derive macro:
//!     let videos: Vec<Asset> = db.query(
//!         &Asset::table()
//!             .select(Asset::all())
//!             .filter(Asset::name().eq("video/mp4".to_string()))
//!             .filter(Asset::file_size().gt(1024 * 1024))
//!             .limit(10)
//!     ).await?;
//!
//!     let db = db;
//!     Ok(())
//! }
//! ```

pub mod auth;
pub mod connection;
pub mod live;
pub mod migrate;

pub use auth::Credentials;
pub use connection::{SomniaClient, SomniaError};
pub use live::{Action, LiveQueryStream, Notification};
pub use migrate::{MigrationStatus, Migrator};
pub use somnia_core::{
    col,
    expr::{
        Closure, Column, ColumnMeta, ColumnSet, DynExpr, IfExpr, KnnExpr, Literal, MatchesExpr,
        Order, Param, Path, SurrealQL,
    },
    field, ident,
    query::{
        Batch, Create, DefineAnalyzer, DefineEvent, DefineFunction, DefineIndex, DefineParam,
        Delete, For, Insert, LetVar, Relate, RelateEdge, Returning, Search, Select, Table,
        Transaction, Update, VectorSearch,
    },
    types::{Key, SurrealEdge, SurrealRecord, SurrealSchema, Thing},
    DynExprBox, Func, Grouped, Ident, NoneLit, Projection, Raw, RecordLink,
};
pub use somnia_derive::{SurrealEdge, SurrealRecord};