codd 0.1.0

codd is a minimal in-memory database with relational algebraic expressions as queries.
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

/*! Implements a minimal [database] and relational algebraic [expressions] for evaluating queries in the database.

[database]: ./struct.Database.html
[expressions]: ./expression/index.html
 */
mod database;
pub mod expression;

#[cfg(feature = "unstable")]
mod macros;

pub use database::{Database, Tuples};
pub use expression::Expression;
use thiserror::Error;

/// Is the trait of tuples. Tuples are the smallest unit of data stored in databases.
///
/// **Note**: Tuples are analogous to the rows of a table in a conventional database.
pub trait Tuple: Ord + Clone + std::fmt::Debug {}
impl<T: Ord + Clone + std::fmt::Debug> Tuple for T {}

/// Is the type of errors returned by `codd`.
#[derive(Error, Debug)]
pub enum Error {
    /// Is returned when an unsupported operation is performed on an expression.
    #[error("unsopported operation `{operation:?}` on expression `{name:?}`")]
    UnsupportedExpression { name: String, operation: String },

    /// Is returned when a given relation instance doesn't exist.
    #[error("database instance `{name:?}` not found")]
    InstanceNotFound { name: String },

    /// Is returned when attempting to re-define an existing instance in a database.
    #[error("database instance `{name:?}` already exists")]
    InstanceExists { name: String },
}