diesel 2.3.3

A safe, extensible ORM and Query Builder for PostgreSQL, SQLite, and MySQL
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

use crate::expression::Expression;
use crate::query_source::Table;

/// The `order` method
///
/// This trait should not be relied on directly by most apps. Its behavior is
/// provided by [`QueryDsl`]. However, you may need a where clause on this trait
/// to call `order` from generic code.
///
/// [`QueryDsl`]: crate::QueryDsl
pub trait OrderDsl<Expr: Expression> {
    /// The type returned by `.order`.
    type Output;

    /// See the trait documentation.
    fn order(self, expr: Expr) -> Self::Output;
}

impl<T, Expr> OrderDsl<Expr> for T
where
    Expr: Expression,
    T: Table,
    T::Query: OrderDsl<Expr>,
{
    type Output = <T::Query as OrderDsl<Expr>>::Output;

    fn order(self, expr: Expr) -> Self::Output {
        self.as_query().order(expr)
    }
}

/// The `then_order_by` method
///
/// This trait should not be relied on directly by most apps. Its behavior is
/// provided by [`QueryDsl`]. However, you may need a where clause on this trait
/// to call `then_order_by` from generic code.
///
/// [`QueryDsl`]: crate::QueryDsl
pub trait ThenOrderDsl<Expr> {
    /// The type returned by `.then_order_by`.
    type Output;

    /// See the trait documentation.
    fn then_order_by(self, expr: Expr) -> Self::Output;
}

impl<T, Expr> ThenOrderDsl<Expr> for T
where
    Expr: Expression,
    T: Table,
    T::Query: ThenOrderDsl<Expr>,
{
    type Output = <T::Query as ThenOrderDsl<Expr>>::Output;

    fn then_order_by(self, expr: Expr) -> Self::Output {
        self.as_query().then_order_by(expr)
    }
}

#[diagnostic::on_unimplemented(
    message = "invalid order of elements in your `DISTINCT ON` clause in relation to your `ORDER BY` clause",
    note = "the elements in your `DISTINCT ON` clause needs to match the elements \
            in your `ORDER BY` clause up to which clause contains less elements"
)]
pub trait ValidOrderingForDistinct<D> {}