liter 0.0.8

Experimental library for using SQLite with minimal SQL
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

//! The [`Schema`] is a set of [`Table`]s and defines a [`Database`](crate::Database)

use construe::StrConstrue;

use crate::Table;
use crate::table::TableDef;

/// The set of [`Table`]s contained in a [`Database`](crate::Database)
///
/// Don't try to implement this trait manually -- use [`#[database]`](crate::database) on a tuple struct of [`Table`]s.
/// The proc macro won't just generate the [`Schema`] implementation, it will also validate it.
pub trait Schema {
	/// Represents the list of tables in the type system
	type Tables: TableList;
	/// Statically generated list of table definition structs
	const DEFINITIONS: &'static [TableDef];
	/// Statically generated schema definition SQL
	const CREATE: &'static str;
}

/// Assemble [`Table`] definitions into schema definition (internal)
///
/// You won't need to call this function yourself, the proc-macros will generate code that uses this function to generate the full schema SQL at compile-time.
pub const fn define<const N: usize>(mut tables: &[&str]) -> StrConstrue<N> {
	let mut sc = StrConstrue::new();

	sc = sc.push_str("BEGIN TRANSACTION;\n");
	while let [table, rest @ ..] = tables {
		sc = sc.push_str(table);
		sc = sc.push_str("\n");
		tables = rest;
	}
	sc.push_str("END TRANSACTION;\n")
}

/// Helper trait for implementing the [`Schema`]
///
/// This trait is sealed.
/// It's implemented for nested tuples of [`Table`]s like `(TableA, (TableB, (TableC, )))` and so on.
/// This theoretically allows for [`Schema`]s with any number (> 0) of [`Table`]s, though eventually you might hit compiler limits.
///
/// Again, don't bother implementing [`Schema`] manually, use [`#[database]`](crate::database).
pub trait TableList: private::Sealed {}

impl<T: Table> TableList for (T, ) {}
impl<T: Table, L: TableList> TableList for (T, L) {}

mod private {
	use super::*;
	pub trait Sealed {}
	impl<T: Table> Sealed for (T, ) {}
	impl<T: Table, L: TableList> Sealed for (T, L) {}
}