tank-core 0.34.0

Core of Tank: the Rust data layer. This is intended to be used by drivers to implement a backend.
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
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

use crate::{Connection, Driver, Error, Result};
use deadpool::managed::{Manager, Metrics, Object, Pool, RecycleResult, Timeouts};
use std::{borrow::Cow, fmt::Debug, future, time::Duration};

#[derive(Debug)]
pub struct DBConnectionManager<D: Driver> {
    driver: D,
    url: Cow<'static, str>,
}

impl<D: Driver> DBConnectionManager<D> {
    pub fn new(driver: D, url: Cow<'static, str>) -> Self {
        Self { driver, url }
    }
}

impl<D: Driver> Manager for DBConnectionManager<D> {
    type Type = D::Connection;
    type Error = Error;
    async fn create(&self) -> Result<Self::Type> {
        Ok(D::Connection::connect(&self.driver, self.url.clone()).await?)
    }
    fn recycle(
        &self,
        _: &mut Self::Type,
        _: &Metrics,
    ) -> impl Future<Output = RecycleResult<Self::Error>> + Send {
        future::ready(RecycleResult::Ok(()))
    }
}

pub trait ConnectionPool<D: Driver>: Debug {
    fn get(
        &self,
    ) -> impl Future<Output = Result<impl AsRef<D::Connection> + AsMut<D::Connection>>> + Send;
    fn timeout_get(
        &self,
        timeout: Duration,
    ) -> impl Future<Output = Result<impl AsRef<D::Connection> + AsMut<D::Connection>>> + Send;
    fn detach(&self) -> impl Future<Output = Result<D::Connection>> + Send
    where
        Self: Sized;
    fn resize(&self, max_size: usize) -> Result<()>;
    fn close(self) -> impl Future<Output = Result<()>> + Send;
}

impl<D: Driver> ConnectionPool<D> for Pool<DBConnectionManager<D>>
where
    <D as Driver>::Connection: Debug,
{
    async fn get(&self) -> Result<impl AsRef<D::Connection> + AsMut<D::Connection>> {
        Ok(Pool::<DBConnectionManager<D>>::get(self)
            .await
            .map_err(|e| Error::msg(format!("{e:#?}")))?)
    }

    async fn timeout_get(
        &self,
        timeout: Duration,
    ) -> Result<impl AsRef<D::Connection> + AsMut<D::Connection>> {
        Ok(Pool::<DBConnectionManager<D>>::timeout_get(
            self,
            &Timeouts::wait_millis(timeout.as_millis() as u64),
        )
        .await
        .map_err(|e| Error::msg(format!("{e:#?}")))?)
    }

    async fn detach(&self) -> Result<D::Connection>
    where
        Self: Sized,
    {
        let v = Pool::<DBConnectionManager<D>>::get(self)
            .await
            .map_err(|e| Error::msg(format!("{e:#?}")))?;
        Ok(Object::<DBConnectionManager<D>>::take(v))
    }

    fn resize(&self, max_size: usize) -> Result<()> {
        Ok(self.resize(max_size))
    }

    fn close(self) -> impl Future<Output = Result<()>> + Send {
        Self::close(&self);
        future::ready(Ok(()))
    }
}

#[derive(Clone, Copy)]
pub enum QueueMode {
    Fifo,
    Lifo,
}

#[derive(Clone, Copy)]
pub struct PoolConfig {
    pub max_size: usize,
    pub wait_timeout: Option<Duration>,
    pub create_timeout: Option<Duration>,
    pub recycle_timeout: Option<Duration>,
    pub queue_mode: QueueMode,
}

impl PoolConfig {
    pub fn new() -> Self {
        deadpool::managed::PoolConfig::default().into()
    }
}

impl From<PoolConfig> for deadpool::managed::PoolConfig {
    fn from(value: PoolConfig) -> Self {
        Self {
            max_size: value.max_size,
            timeouts: deadpool::managed::Timeouts {
                wait: value.wait_timeout,
                create: value.create_timeout,
                recycle: value.recycle_timeout,
            },
            queue_mode: match value.queue_mode {
                QueueMode::Fifo => deadpool::managed::QueueMode::Fifo,
                QueueMode::Lifo => deadpool::managed::QueueMode::Lifo,
            },
        }
    }
}

impl From<deadpool::managed::PoolConfig> for PoolConfig {
    fn from(value: deadpool::managed::PoolConfig) -> Self {
        Self {
            max_size: value.max_size,
            wait_timeout: value.timeouts.wait,
            create_timeout: value.timeouts.create,
            recycle_timeout: value.timeouts.recycle,
            queue_mode: match value.queue_mode {
                deadpool::managed::QueueMode::Fifo => QueueMode::Fifo,
                deadpool::managed::QueueMode::Lifo => QueueMode::Lifo,
            },
        }
    }
}

impl Default for PoolConfig {
    fn default() -> Self {
        Self::new()
    }
}