drizzle_core/traits/param.rs
1use crate::dialect::Dialect;
2
3/// A marker trait for types that can be used as SQL parameters.
4///
5/// This trait is used as a bound on the parameter type in SQL fragments.
6/// It ensures type safety when building SQL queries with parameters.
7#[diagnostic::on_unimplemented(
8 message = "`{Self}` is not a SQL parameter type",
9 label = "use a dialect-specific value type (e.g., SQLiteValue, PostgresValue)"
10)]
11pub trait SQLParam: Clone + core::fmt::Debug {
12 /// The SQL dialect for this parameter type
13 const DIALECT: Dialect;
14
15 /// Type-level dialect marker for compile-time dispatch.
16 ///
17 /// Used by [`crate::row::SQLTypeToRust`] to select dialect-specific type mappings
18 /// and by [`crate::dialect::DialectTypes`] to resolve conceptual SQL types to
19 /// dialect-native markers.
20 type DialectMarker: crate::dialect::DialectTypes;
21}
22
23// Implement SQLParam for common types
24// impl<T: SQLParam> SQLParam for Option<T> {}
25// impl<T: SQLParam> SQLParam for Vec<T> {}
26// impl<T: SQLParam> SQLParam for Box<[T]> {}
27// impl<T: SQLParam> SQLParam for Rc<T> {}
28// impl<T: SQLParam> SQLParam for Arc<T> {}
29// impl<T: SQLParam> SQLParam for RefCell<T> {}
30// impl<'a, T: SQLParam> SQLParam for Cow<'a, T> {}
31// impl<T: SQLParam> SQLParam for &[T] {}
32// impl<T: SQLParam> SQLParam for &T {}
33// impl<const N: usize, T: SQLParam> SQLParam for [T; N] {}