tideorm 0.9.3

A developer-friendly ORM for Rust with clean, expressive syntax
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
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

use std::future::Future;
use std::sync::Arc;

use crate::error::{Error, Result};

use super::state::with_connection_override;
use super::{Database, DatabaseHandle};

impl Database {
    /// Execute a closure within a database transaction
    pub async fn transaction<F, T>(&self, f: F) -> Result<T>
    where
        F: for<'c> FnOnce(
                &'c Transaction,
            )
                -> std::pin::Pin<Box<dyn Future<Output = Result<T>> + Send + 'c>>
            + Send,
        T: Send,
    {
        use crate::internal::TransactionTrait;

        let txn = match self.__get_connection()? {
            ConnectionRef::Database(conn) => conn
                .connection()
                .begin()
                .await
                .map_err(|e| Error::transaction(e.to_string()))?,
            ConnectionRef::Transaction(tx) => tx
                .as_ref()
                .begin()
                .await
                .map_err(|e| Error::transaction(e.to_string()))?,
        };

        let outcome = {
            let txn = Arc::new(txn);
            let tx = Transaction { inner: txn.clone() };
            let override_handle = DatabaseHandle::Transaction(txn.clone());
            let outcome = with_connection_override(override_handle, f(&tx)).await;

            (txn, outcome)
        };

        let (txn, outcome) = outcome;

        match outcome {
            Ok(result) => {
                let txn = Arc::try_unwrap(txn).map_err(|_| {
                    Error::transaction(
                        "transaction handle leaked outside the transaction scope".to_string(),
                    )
                })?;
                txn.commit()
                    .await
                    .map_err(|e| Error::transaction(e.to_string()))?;
                Ok(result)
            }
            Err(e) => {
                let txn = Arc::try_unwrap(txn).map_err(|_| {
                    Error::transaction(
                        "transaction handle leaked outside the transaction scope".to_string(),
                    )
                })?;
                let _ = txn.rollback().await;
                Err(e)
            }
        }
    }
}

/// A database transaction handle
pub struct Transaction {
    pub(super) inner: Arc<crate::internal::DatabaseTransaction>,
}

impl Transaction {
    /// Get a reference to the underlying connection.
    pub fn connection(&self) -> &crate::internal::DatabaseTransaction {
        self.inner.as_ref()
    }

    /// Get the raw internal transaction (for internal use only)
    #[doc(hidden)]
    pub fn __internal_transaction(&self) -> &crate::internal::DatabaseTransaction {
        self.inner.as_ref()
    }
}

/// Trait for types that can be used as a database connection
pub trait Connection: Send + Sync {
    /// Get the internal connection for query execution
    #[doc(hidden)]
    fn __get_connection(&self) -> Result<ConnectionRef>;
}

/// Internal connection reference (hidden from users)
#[doc(hidden)]
pub enum ConnectionRef {
    Database(Arc<crate::internal::InternalConnection>),
    Transaction(Arc<crate::internal::DatabaseTransaction>),
}

impl Connection for Database {
    fn __get_connection(&self) -> Result<ConnectionRef> {
        Ok(match self.current_handle()? {
            DatabaseHandle::Connection(inner) => ConnectionRef::Database(inner),
            DatabaseHandle::Transaction(tx) => ConnectionRef::Transaction(tx),
        })
    }
}

impl Connection for Transaction {
    fn __get_connection(&self) -> Result<ConnectionRef> {
        Ok(ConnectionRef::Transaction(self.inner.clone()))
    }
}