Crate scyllax

Scyllax (sɪl-æks)

A SQLx and Discord inspired query system for ScyllaDB

Example

1. Model definition

Before you can write any queries, you have to define a model.

#[derive(Clone, Debug, FromRow, PartialEq, ValueList, Entity)]
pub struct PersonEntity {
    #[pk]
    pub id: uuid::Uuid,
    pub email: String,
    pub created_at: i64,
}

2. Select queries

With the [select_query] attribute, it’s easy to define select queries.

#[read_query(
    query = "select * from person where id = ? limit 1",
    entity_type = "PersonEntity"
)]
pub struct GetPersonById {
    pub id: Uuid,
}

3. Upsert queries

With the [upsert_query] attribute, it’s easy to define upsert queries.

#[upsert_query(table = "person", name = UpsertPerson)]
#[derive(Clone, Debug, FromRow, PartialEq, ValueList, Entity)]
pub struct PersonEntity {
    #[pk]
    pub id: uuid::Uuid,
    pub email: String,
    pub created_at: i64,
}

Modules

• collection
• entity
• error
  ScyllaX error types
• executor
  The scyllax Executor processes queries.
• maybe_unset
  A wrapper around a value that can be unincluded but not overwritten/made null
• prelude
  Re-exports of the most commonly used types and traits.
• queries
• rows
  Macros for matching rows from a scylla::QueryResult
• util
  Utility functions

Macros

• match_row
  Take a QueryResult and return a Result<Option<T>> Example:
• match_rows
  Take a QueryResult and return a Result<Vec<T>> Example: