#[non_exhaustive]pub struct Compilation {
pub commands: Vec<Vec<String>>,
pub query_cards: Vec<QueryCard>,
pub notes: Vec<String>,
}Expand description
The result of compile: engine commands, query cards, and notes.
let c = kevy_sql::compile(
"CREATE TABLE orders (id bigint PRIMARY KEY, user_id bigint);
CREATE INDEX ON orders (user_id);
CREATE VIEW mine AS SELECT * FROM orders WHERE user_id = 7;
CREATE VIEW by_user AS SELECT * FROM orders WHERE user_id = $1;",
)?;
assert_eq!(c.commands.len(), 2); // TABLE.DECLARE, then VIEW.CREATE
assert_eq!(c.query_cards.len(), 1);Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.commands: Vec<Vec<String>>Declaration commands in apply order: one TABLE.DECLARE per
table (declaration order), then the VIEW.CREATEs. Each is an
argv vector, ready for a RESP client.
let c = kevy_sql::compile(
"CREATE TABLE orders (id bigint PRIMARY KEY, user_id bigint);
CREATE INDEX ON orders (user_id);
CREATE VIEW mine AS SELECT * FROM orders WHERE user_id = 7;
CREATE VIEW by_user AS SELECT * FROM orders WHERE user_id = $1;",
)?;
assert_eq!(c.commands[0][..2], ["TABLE.DECLARE", "orders"]);
assert_eq!(c.commands[1][..2], ["VIEW.CREATE", "mine"]);query_cards: Vec<QueryCard>Runtime templates for parameterized / clause-bearing views, declaration order.
let c = kevy_sql::compile(
"CREATE TABLE orders (id bigint PRIMARY KEY, user_id bigint);
CREATE INDEX ON orders (user_id);
CREATE VIEW mine AS SELECT * FROM orders WHERE user_id = 7;
CREATE VIEW by_user AS SELECT * FROM orders WHERE user_id = $1;",
)?;
assert_eq!(c.query_cards[0].name, "by_user");notes: Vec<String>Honest-mapping notes (coarse type mappings, naming, read templates) — informational, never errors.
let c = kevy_sql::compile("CREATE TABLE ev (id bigint PRIMARY KEY, at timestamp);")?;
assert!(c.notes.iter().any(|n| n.contains("ev.at: timestamp → str")));Implementations§
Source§impl Compilation
impl Compilation
Sourcepub fn render_script(&self) -> String
pub fn render_script(&self) -> String
Render the compilation as a readable text artifact: commands as
pasteable lines, cards as documented comment blocks with a
machine-readable #@card / #@param / #@argv section (argv
tab-separated), then the notes. Deterministic.
let c = kevy_sql::compile(
"CREATE TABLE orders (id bigint PRIMARY KEY, user_id bigint);
CREATE INDEX ON orders (user_id);
CREATE VIEW by_user AS SELECT * FROM orders WHERE user_id = $1;",
)?;
let script = c.render_script();
assert!(script.contains("#@card by_user"));
assert!(script.contains("#@param 1 user_id i64"));Trait Implementations§
Source§impl Clone for Compilation
impl Clone for Compilation
Source§impl Debug for Compilation
impl Debug for Compilation
impl Eq for Compilation
Source§impl Hash for Compilation
impl Hash for Compilation
Source§impl PartialEq for Compilation
impl PartialEq for Compilation
impl StructuralPartialEq for Compilation
Auto Trait Implementations§
impl Freeze for Compilation
impl RefUnwindSafe for Compilation
impl Send for Compilation
impl Sync for Compilation
impl Unpin for Compilation
impl UnsafeUnpin for Compilation
impl UnwindSafe for Compilation
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more