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 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201
use std::fmt::Display;
pub trait ToNodeBuilder<T: Display = Self>: Display {
/// Draws the start of a relation `->node`
///
/// # Example
/// ```
/// use surreal_simple_querybuilder::prelude::*;
///
/// let s = "user".with("project");
///
/// assert_eq!("user->project", s);
/// ```
fn with(&self, relation_or_node: &str) -> String {
format!("{self}->{relation_or_node}")
}
/// Draws the end of a relation `<-node`
///
/// # Example
/// ```
/// use surreal_simple_querybuilder::prelude::*;
///
/// let s = "user".from("project");
///
/// assert_eq!("user<-project", s);
/// ```
fn from(&self, node: &str) -> String {
format!("{self}<-{node}")
}
/// Take the current string and add in front of it the given label name as to
/// make a string of the following format `LabelName:CurrentString`
///
/// # Example
/// ```
/// use surreal_simple_querybuilder::prelude::*;
///
/// let label = "John".as_named_label("Account");
///
/// assert_eq!(label, "Account:John");
/// ```
fn as_named_label(&self, label_name: &str) -> String {
format!("{label_name}:{self}")
}
/// # Example
/// ```
/// use surreal_simple_querybuilder::prelude::*;
///
/// let s = "user".equals("John");
///
/// // Note that it doesn't add quotes around strings
/// assert_eq!("user = John", s);
/// ```
fn equals(&self, value: &str) -> String {
format!("{self} = {value}")
}
/// Take the current string and add `= $current_string` after it
///
/// # Example
/// ```
/// use surreal_simple_querybuilder::prelude::*;
///
/// let s = "account".equals_parameterized();
///
/// assert_eq!("account = $account", s);
/// ```
fn equals_parameterized(&self) -> String {
format!("{self} = ${self}")
}
/// Take the current string and add `as alias` after it
///
/// # Example
/// ```
/// use surreal_simple_querybuilder::prelude::*;
///
/// let s = "account->manage->project".as_alias("account_projects");
///
/// assert_eq!("account->manage->project AS account_projects", s);
/// ```
fn as_alias(&self, alias: &str) -> String {
format!("{self} AS {alias}")
}
/// Take the current string, extract the last segment if it is a nested property,
/// then add parenthesis around it and add the supplied condition in them.
///
/// # Example
/// ```
/// use surreal_simple_querybuilder::prelude::*;
///
/// let path = "account->manage->project";
/// let s = path.filter("name = 'a_cool_project'");
///
/// assert_eq!("account->manage->(project WHERE name = 'a_cool_project')", s);
/// ```
///
fn filter(&self, condition: &str) -> String {
// This is a default implementation, but since we need the original string
// to iterate over the chars the function does two string allocations.
let original = self.to_string();
let original_size = original.len();
// this yields the size of the last segment, until a non alphanumeric character
// is found.
let last_segment_size = original
.chars()
.rev()
.take_while(|c| c.is_alphanumeric())
.count();
let left = &original[..original_size - last_segment_size];
let right = &original[original_size - last_segment_size..];
format!("{left}({right} WHERE {condition})")
}
}
impl<'a> ToNodeBuilder for &'a str {
fn filter(&self, condition: &str) -> String {
// unlike the default implementation of this trait function, the &str impl
// does only one allocation.
let original_size = self.len();
// this yields the size of the last segment, until a non alphanumeric character
// is found.
let last_segment_size = self
.chars()
.rev()
.take_while(|c| c.is_alphanumeric())
.count();
let left = &self[..original_size - last_segment_size];
let right = &self[original_size - last_segment_size..];
format!("{left}({right} WHERE {condition})")
}
}
pub trait NodeBuilder<T: Display = Self>: Display {
/// Draws the start of a relation `->node`
///
/// # Example
/// ```
/// use surreal_simple_querybuilder::prelude::*;
///
/// let s = "user".with("project");
///
/// assert_eq!("user->project", s);
/// ```
fn with(&mut self, relation_or_node: &str) -> &mut String;
/// Allows you to pass a lambda that should mutate the current string when the
/// passed `condition` is `true`. If `condition` is `false` then the `action`
/// lambda is ignored and the string stays intact.
///
/// # Example
/// ```
/// use surreal_simple_querybuilder::prelude::*;
///
/// // demonstrate how the given closure is ignored if the condition is `false`
/// let mut label = "John".as_named_label("User");
/// let intact = &mut label
/// .if_then(false, |s| s.with("LOVES").with("User"))
/// .with("FRIEND")
/// .with("User");
///
/// assert_eq!("User:John->FRIEND->User", *intact);
///
/// // demonstrate how the given closure is executed if the condition is `true`
/// let mut label = "John".as_named_label("User");
/// let modified = &mut label
/// .if_then(true, |s| s.with("LOVES").with("User"))
/// .with("FRIEND")
/// .with("User");
///
/// assert_eq!("User:John->LOVES->User->FRIEND->User", *modified);
/// ```
fn if_then(&mut self, condition: bool, action: fn(&mut Self) -> &mut Self) -> &mut String;
}
impl NodeBuilder for String {
fn with(&mut self, node: &str) -> &mut String {
self.push_str("->");
self.push_str(node);
self
}
fn if_then(&mut self, condition: bool, action: fn(&mut Self) -> &mut Self) -> &mut String {
match condition {
true => action(self),
false => self,
}
}
}
impl ToNodeBuilder for String {}