sqlx-query-as-builder 0.1.2

Builder pattern macros for SQLx query_as! - populate builders instead of constructing structs directly
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
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

//! Builder pattern macros for SQLx `query_as!` - populate builders instead of constructing structs directly.
//!
//! The builder expression must have setter methods matching the SQL column names.

/// Like `query_as!` but populates a builder instead of constructing a struct directly.
///
/// # Example
/// ```ignore
/// let user = query_as_builder!(User::builder(), "SELECT id, name FROM users WHERE id = ?", user_id)
///     .fetch_one(&pool)
///     .await?
///     .role("admin")
///     .build();
/// ```
#[macro_export]
macro_rules! query_as_builder {
    ($builder_expr:expr, $query:expr) => {{
        $crate::sqlx_query_as_builder_macros::expand_query_as_builder!(
            $builder_expr,
            source = $query
        )
    }};
    ($builder_expr:expr, $query:expr, $($args:tt)*) => {{
        $crate::sqlx_query_as_builder_macros::expand_query_as_builder!(
            $builder_expr,
            source = $query,
            args = [$($args)*]
        )
    }};
}

/// Unchecked version of `query_as_builder!` - does not verify query at compile time.
#[macro_export]
macro_rules! query_as_builder_unchecked {
    ($builder_expr:expr, $query:expr) => {{
        $crate::sqlx_query_as_builder_macros::expand_query_as_builder!(
            $builder_expr,
            source = $query,
            checked = false
        )
    }};
    ($builder_expr:expr, $query:expr, $($args:tt)*) => {{
        $crate::sqlx_query_as_builder_macros::expand_query_as_builder!(
            $builder_expr,
            source = $query,
            args = [$($args)*],
            checked = false
        )
    }};
}

/// Like `query_file_as!` but populates a builder instead of constructing a struct directly.
#[macro_export]
macro_rules! query_file_as_builder {
    ($builder_expr:expr, $path:literal) => {{
        $crate::sqlx_query_as_builder_macros::expand_query_as_builder!(
            $builder_expr,
            source_file = $path
        )
    }};
    ($builder_expr:expr, $path:literal, $($args:tt)*) => {{
        $crate::sqlx_query_as_builder_macros::expand_query_as_builder!(
            $builder_expr,
            source_file = $path,
            args = [$($args)*]
        )
    }};
}

/// Unchecked version of `query_file_as_builder!` - does not verify query at compile time.
#[macro_export]
macro_rules! query_file_as_builder_unchecked {
    ($builder_expr:expr, $path:literal) => {{
        $crate::sqlx_query_as_builder_macros::expand_query_as_builder!(
            $builder_expr,
            source_file = $path,
            checked = false
        )
    }};
    ($builder_expr:expr, $path:literal, $($args:tt)*) => {{
        $crate::sqlx_query_as_builder_macros::expand_query_as_builder!(
            $builder_expr,
            source_file = $path,
            args = [$($args)*],
            checked = false
        )
    }};
}

#[doc(hidden)]
pub use sqlx_query_as_builder_macros;