sabi_redis 0.8.0

// Copyright (C) 2026 Takayuki Sato. All Rights Reserved.
// This program is free software under MIT License.
// See the file LICENSE in this distribution for more details.

mod pubsub;
pub use pubsub::{RedisPubSubSubscriberAsync, RedisPubSubSubscriberErrorAsync};

use deadpool_redis::{Config, Connection, Pool, PoolConfig, Runtime};
use redis::aio::MultiplexedConnection;
use sabi::tokio::{AsyncGroup, DataConn, DataSrc};

use std::future::Future;
use std::{mem, pin, time};

/// Errors related to Redis data source and connection for asynchronous standalone configuration.
#[derive(Debug)]
pub enum RedisErrorAsync {
    /// Indicates that the data source is not yet setup.
    NotSetupYet,
    /// Indicates that the data source is already setup.
    AlreadySetup,
    /// Failed to build a Redis connection pool.
    FailToBuildPool {
        /// The Redis configuration.
        config: Config,
    },
    /// Failed to connect to Redis.
    FailToConnect {
        /// The Redis configuration.
        config: Config,
    },
    /// Failed to get a connection from the pool.
    FailToGetConnectionFromPool,
}

type BoxedFuture = pin::Pin<Box<dyn Future<Output = errs::Result<()>> + Send + 'static>>;

/// A struct that holds a Redis connection and asynchronous transaction callbacks for standalone configuration.
pub struct RedisDataConnAsync {
    conn: Connection,
    pre_commit_vec: Vec<BoxedFuture>,
    post_commit_vec: Vec<BoxedFuture>,
    force_back_vec: Vec<BoxedFuture>,
}

impl RedisDataConnAsync {
    fn new(conn: Connection) -> Self {
        Self {
            conn,
            pre_commit_vec: Vec::new(),
            post_commit_vec: Vec::new(),
            force_back_vec: Vec::new(),
        }
    }

    /// Returns a mutable reference to the underlying Redis multiplexed connection.
    ///
    /// # Returns
    ///
    /// A mutable reference to the `redis::aio::MultiplexedConnection`.
    pub fn get_connection(&mut self) -> &mut MultiplexedConnection {
        &mut self.conn
    }

    /// Adds an asynchronous callback function to be executed before a transaction is committed.
    ///
    /// # Arguments
    ///
    /// * `f` - A callback function that takes a `MultiplexedConnection` and returns a `Future`.
    pub async fn add_pre_commit_async<F, Fut>(&mut self, mut f: F)
    where
        F: FnMut(MultiplexedConnection) -> Fut,
        Fut: Future<Output = errs::Result<()>> + Send + 'static,
    {
        let fut = f(self.conn.clone());
        self.pre_commit_vec.push(Box::pin(fut))
    }

    /// Adds an asynchronous callback function to be executed after a transaction is committed.
    ///
    /// # Arguments
    ///
    /// * `f` - A callback function that takes a `MultiplexedConnection` and returns a `Future`.
    pub async fn add_post_commit_async<F, Fut>(&mut self, mut f: F)
    where
        F: FnMut(MultiplexedConnection) -> Fut,
        Fut: Future<Output = errs::Result<()>> + Send + 'static,
    {
        let fut = f(self.conn.clone());
        self.post_commit_vec.push(Box::pin(fut))
    }

    /// Adds an asynchronous callback function to be executed when a transaction is rolled back or forced back.
    ///
    /// # Arguments
    ///
    /// * `f` - A callback function that takes a `MultiplexedConnection` and returns a `Future`.
    pub async fn add_force_back_async<F, Fut>(&mut self, mut f: F)
    where
        F: FnMut(MultiplexedConnection) -> Fut,
        Fut: Future<Output = errs::Result<()>> + Send + 'static,
    {
        let fut = f(self.conn.clone());
        self.force_back_vec.push(Box::pin(fut))
    }
}

impl DataConn for RedisDataConnAsync {
    async fn pre_commit_async(&mut self, _ag: &mut AsyncGroup) -> errs::Result<()> {
        let vec = mem::take(&mut self.pre_commit_vec);
        for fut in vec.into_iter() {
            fut.await?;
        }
        Ok(())
    }

    async fn commit_async(&mut self, _ag: &mut AsyncGroup) -> errs::Result<()> {
        Ok(())
    }

    async fn post_commit_async(&mut self, _ag: &mut AsyncGroup) {
        let vec = mem::take(&mut self.post_commit_vec);
        for fut in vec.into_iter() {
            // The error is not exposed externally, but a notification is triggered when
            // errs::Err is created.
            let _ = fut.await;
        }
    }

    fn should_force_back(&self) -> bool {
        true
    }

    async fn rollback_async(&mut self, _ag: &mut AsyncGroup) {}

    async fn force_back_async(&mut self, _ag: &mut AsyncGroup) {
        let vec = mem::take(&mut self.force_back_vec);
        for fut in vec.into_iter().rev() {
            // The error is not exposed externally, but a notification is triggered when
            // errs::Err is created.
            let _ = fut.await;
        }
    }

    fn close(&mut self) {
        self.pre_commit_vec.clear();
        self.post_commit_vec.clear();
        self.force_back_vec.clear();
    }
}

/// A struct that manages an asynchronous Redis connection pool for standalone configuration.
pub struct RedisDataSrcAsync {
    pool: Option<RedisPool>,
}

enum RedisPool {
    Object(Pool),
    Config(Config),
}

impl RedisDataSrcAsync {
    /// Creates a new `RedisDataSrcAsync` with a connection address string.
    ///
    /// # Arguments
    ///
    /// * `addr` - A string slice that holds the Redis connection address (e.g., "redis://127.0.0.1/").
    ///
    /// # Returns
    ///
    /// A new instance of `RedisDataSrcAsync`.
    pub fn new<S>(addr: S) -> Self
    where
        S: AsRef<str>,
    {
        Self {
            pool: Some(RedisPool::Config(Config {
                url: Some(addr.as_ref().to_string()),
                connection: None,
                pool: Some(PoolConfig::default()),
            })),
        }
    }

    /// Creates a new `RedisDataSrcAsync` with a connection address and a custom pool configuration.
    ///
    /// # Arguments
    ///
    /// * `addr` - A string slice that holds the Redis connection address.
    /// * `pool_config` - A `deadpool_redis::PoolConfig` for configuring the connection pool.
    ///
    /// # Returns
    ///
    /// A new instance of `RedisDataSrcAsync`.
    pub fn with_pool_config<S>(addr: S, pool_config: PoolConfig) -> Self
    where
        S: AsRef<str>,
    {
        Self {
            pool: Some(RedisPool::Config(Config {
                url: Some(addr.as_ref().to_string()),
                connection: None,
                pool: Some(pool_config),
            })),
        }
    }

    /// Creates a new `RedisDataSrcAsync` with a `deadpool_redis::Config`.
    ///
    /// # Arguments
    ///
    /// * `config` - A `deadpool_redis::Config`.
    ///
    /// # Returns
    ///
    /// A new instance of `RedisDataSrcAsync`.
    pub fn with_config(config: Config) -> Self {
        Self {
            pool: Some(RedisPool::Config(config)),
        }
    }
}

impl DataSrc<RedisDataConnAsync> for RedisDataSrcAsync {
    async fn setup_async(&mut self, _ag: &mut AsyncGroup) -> errs::Result<()> {
        let pool_opt = mem::take(&mut self.pool);
        let pool = pool_opt.ok_or_else(|| errs::Err::new(RedisErrorAsync::AlreadySetup))?;
        match pool {
            RedisPool::Config(config) => {
                let pool = config.create_pool(Some(Runtime::Tokio1)).map_err(|e| {
                    errs::Err::with_source(
                        RedisErrorAsync::FailToBuildPool {
                            config: config.clone(),
                        },
                        e,
                    )
                })?;

                let mut timeouts = config.pool.map(|p| p.timeouts).unwrap_or_default();
                timeouts
                    .wait
                    .get_or_insert(time::Duration::from_millis(100));
                timeouts
                    .create
                    .get_or_insert(time::Duration::from_millis(100));

                pool.timeout_get(&timeouts).await.map_err(|e| {
                    errs::Err::with_source(RedisErrorAsync::FailToConnect { config }, e)
                })?;
                self.pool = Some(RedisPool::Object(pool));
                Ok(())
            }
            _ => Err(errs::Err::new(RedisErrorAsync::AlreadySetup)),
        }
    }

    fn close(&mut self) {
        if let Some(RedisPool::Object(pool)) = self.pool.as_mut() {
            pool.close()
        }
    }

    async fn create_data_conn_async(&mut self) -> errs::Result<Box<RedisDataConnAsync>> {
        let pool = self
            .pool
            .as_mut()
            .ok_or_else(|| errs::Err::new(RedisErrorAsync::NotSetupYet))?;
        match pool {
            RedisPool::Object(pool) => match pool.get().await {
                Ok(conn) => Ok(Box::new(RedisDataConnAsync::new(conn))),
                Err(e) => Err(errs::Err::with_source(
                    RedisErrorAsync::FailToGetConnectionFromPool,
                    e,
                )),
            },
            _ => Err(errs::Err::new(RedisErrorAsync::NotSetupYet)),
        }
    }
}

#[cfg(test)]
mod unit_tests_of_data_src {
    use super::*;

    mod test_new {
        use super::*;
        use url::Url;

        #[tokio::test]
        async fn addr_is_str_and_ok() {
            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0");
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_str_and_fail() {
            let mut ds = RedisDataSrcAsync::new("redis://xxxx:6379/0");
            let mut ag = AsyncGroup::new();
            let Err(err) = ds.setup_async(&mut ag).await else {
                panic!();
            };
            let Ok(RedisErrorAsync::FailToConnect { config }) = err.reason::<RedisErrorAsync>()
            else {
                panic!();
            };
            #[cfg(target_os = "linux")]
            assert_eq!(format!("{:?}", config), "Config { url: Some(\"redis://xxxx:6379/0\"), connection: None, pool: Some(PoolConfig { max_size: 8, timeouts: Timeouts { wait: None, create: None, recycle: None }, queue_mode: Fifo }) }");
            #[cfg(not(target_os = "linux"))]
            assert_eq!(format!("{:?}", config), "Config { url: Some(\"redis://xxxx:6379/0\"), connection: None, pool: Some(PoolConfig { max_size: 24, timeouts: Timeouts { wait: None, create: None, recycle: None }, queue_mode: Fifo }) }");
            #[cfg(target_os = "linux")]
            assert_eq!(
                format!("{:?}", err.source().unwrap()),
                "Backend(failed to lookup address information: Temporary failure in name resolution)",
            );
            #[cfg(not(target_os = "linux"))]
            assert_eq!(
                format!("{:?}", err.source().unwrap()),
                "Backend(failed to lookup address information: nodename nor servname provided, or not known)",
            );
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_string_and_ok() {
            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0".to_string());
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_string_and_fail() {
            let mut ds = RedisDataSrcAsync::new("xxxx".to_string());
            let mut ag = AsyncGroup::new();
            let Err(err) = ds.setup_async(&mut ag).await else {
                panic!();
            };
            let Ok(RedisErrorAsync::FailToBuildPool { config }) = err.reason::<RedisErrorAsync>()
            else {
                panic!();
            };
            #[cfg(target_os = "linux")]
            assert_eq!(format!("{:?}", config), "Config { url: Some(\"xxxx\"), connection: None, pool: Some(PoolConfig { max_size: 8, timeouts: Timeouts { wait: None, create: None, recycle: None }, queue_mode: Fifo }) }");
            #[cfg(not(target_os = "linux"))]
            assert_eq!(format!("{:?}", config), "Config { url: Some(\"xxxx\"), connection: None, pool: Some(PoolConfig { max_size: 24, timeouts: Timeouts { wait: None, create: None, recycle: None }, queue_mode: Fifo }) }");
            assert_eq!(
                format!("{:?}", err.source().unwrap()),
                "Config(Redis(Redis URL did not parse - InvalidClientConfig))",
            );
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_url_and_ok() {
            let Ok(url) = Url::parse("redis://127.0.0.1:6379/0") else {
                panic!("bad url");
            };
            let mut ds = RedisDataSrcAsync::new(url);
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_url_and_fail() {
            let Ok(url) = Url::parse("redis://") else {
                panic!("bad url");
            };
            let mut ds = RedisDataSrcAsync::new(url);
            let mut ag = AsyncGroup::new();
            let Err(err) = ds.setup_async(&mut ag).await else {
                panic!();
            };
            let Ok(RedisErrorAsync::FailToBuildPool { config }) = err.reason::<RedisErrorAsync>()
            else {
                panic!();
            };
            #[cfg(target_os = "linux")]
            assert_eq!(format!("{:?}", config), "Config { url: Some(\"redis://\"), connection: None, pool: Some(PoolConfig { max_size: 8, timeouts: Timeouts { wait: None, create: None, recycle: None }, queue_mode: Fifo }) }");
            #[cfg(not(target_os = "linux"))]
            assert_eq!(format!("{:?}", config), "Config { url: Some(\"redis://\"), connection: None, pool: Some(PoolConfig { max_size: 24, timeouts: Timeouts { wait: None, create: None, recycle: None }, queue_mode: Fifo }) }");
            assert_eq!(
                format!("{:?}", err.source().unwrap()),
                "Config(Redis(Missing hostname - InvalidClientConfig))",
            );
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }
    }

    mod test_with_pool_config {
        use super::*;
        use deadpool_redis::Timeouts;
        use tokio::time;
        use url::Url;

        #[tokio::test]
        async fn addr_is_str_and_ok() {
            let pool_cfg = PoolConfig {
                max_size: 10,
                timeouts: Timeouts {
                    wait: Some(time::Duration::from_secs(10)),
                    create: Some(time::Duration::from_secs(11)),
                    recycle: Some(time::Duration::from_secs(12)),
                },
                ..Default::default()
            };
            let mut ds = RedisDataSrcAsync::with_pool_config("redis://127.0.0.1:6379/0", pool_cfg);
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_str_and_fail() {
            let pool_cfg = PoolConfig {
                max_size: 10,
                timeouts: Timeouts {
                    wait: Some(time::Duration::from_secs(10)),
                    create: Some(time::Duration::from_secs(11)),
                    recycle: Some(time::Duration::from_secs(12)),
                },
                ..Default::default()
            };
            let mut ds = RedisDataSrcAsync::with_pool_config("redis://xxxx:6379/0", pool_cfg);
            let mut ag = AsyncGroup::new();
            let Err(err) = ds.setup_async(&mut ag).await else {
                panic!();
            };
            let Ok(RedisErrorAsync::FailToConnect { config }) = err.reason::<RedisErrorAsync>()
            else {
                panic!();
            };
            assert_eq!(format!("{:?}", config), "Config { url: Some(\"redis://xxxx:6379/0\"), connection: None, pool: Some(PoolConfig { max_size: 10, timeouts: Timeouts { wait: Some(10s), create: Some(11s), recycle: Some(12s) }, queue_mode: Fifo }) }");
            #[cfg(target_os = "linux")]
            assert_eq!(
                format!("{:?}", err.source().unwrap()),
                "Backend(failed to lookup address information: Temporary failure in name resolution)",
            );
            #[cfg(not(target_os = "linux"))]
            assert_eq!(
                format!("{:?}", err.source().unwrap()),
                "Backend(failed to lookup address information: nodename nor servname provided, or not known)",
            );
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_string_and_ok() {
            let pool_cfg = PoolConfig {
                max_size: 10,
                timeouts: Timeouts {
                    wait: Some(time::Duration::from_secs(10)),
                    create: Some(time::Duration::from_secs(11)),
                    recycle: Some(time::Duration::from_secs(12)),
                },
                ..Default::default()
            };
            let mut ds = RedisDataSrcAsync::with_pool_config(
                "redis://127.0.0.1:6379/0".to_string(),
                pool_cfg,
            );
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_string_and_fail() {
            let pool_cfg = PoolConfig {
                max_size: 10,
                timeouts: Timeouts {
                    wait: Some(time::Duration::from_secs(10)),
                    create: Some(time::Duration::from_secs(11)),
                    recycle: Some(time::Duration::from_secs(12)),
                },
                ..Default::default()
            };
            let mut ds = RedisDataSrcAsync::with_pool_config("xxxx".to_string(), pool_cfg);
            let mut ag = AsyncGroup::new();
            let Err(err) = ds.setup_async(&mut ag).await else {
                panic!();
            };
            let Ok(RedisErrorAsync::FailToBuildPool { config }) = err.reason::<RedisErrorAsync>()
            else {
                panic!();
            };
            assert_eq!(format!("{:?}", config), "Config { url: Some(\"xxxx\"), connection: None, pool: Some(PoolConfig { max_size: 10, timeouts: Timeouts { wait: Some(10s), create: Some(11s), recycle: Some(12s) }, queue_mode: Fifo }) }");
            assert_eq!(
                format!("{:?}", err.source().unwrap()),
                "Config(Redis(Redis URL did not parse - InvalidClientConfig))",
            );
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_url_and_ok() {
            let pool_cfg = PoolConfig {
                max_size: 10,
                timeouts: Timeouts {
                    wait: Some(time::Duration::from_secs(10)),
                    create: Some(time::Duration::from_secs(11)),
                    recycle: Some(time::Duration::from_secs(12)),
                },
                ..Default::default()
            };
            let Ok(url) = Url::parse("redis://127.0.0.1:6379/0") else {
                panic!("bad url");
            };
            let mut ds = RedisDataSrcAsync::with_pool_config(url, pool_cfg);
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_url_and_fail() {
            let pool_cfg = PoolConfig {
                max_size: 10,
                timeouts: Timeouts {
                    wait: Some(time::Duration::from_secs(10)),
                    create: Some(time::Duration::from_secs(11)),
                    recycle: Some(time::Duration::from_secs(12)),
                },
                ..Default::default()
            };
            let Ok(url) = Url::parse("redis://") else {
                panic!("bad url");
            };
            let mut ds = RedisDataSrcAsync::with_pool_config(url, pool_cfg);
            let mut ag = AsyncGroup::new();
            let Err(err) = ds.setup_async(&mut ag).await else {
                panic!();
            };
            let Ok(RedisErrorAsync::FailToBuildPool { config }) = err.reason::<RedisErrorAsync>()
            else {
                panic!();
            };
            assert_eq!(format!("{:?}", config), "Config { url: Some(\"redis://\"), connection: None, pool: Some(PoolConfig { max_size: 10, timeouts: Timeouts { wait: Some(10s), create: Some(11s), recycle: Some(12s) }, queue_mode: Fifo }) }");
            assert_eq!(
                format!("{:?}", err.source().unwrap()),
                "Config(Redis(Missing hostname - InvalidClientConfig))",
            );
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }
    }

    mod test_with_config {
        use super::*;
        use deadpool_redis::Timeouts;
        use std::time;

        #[tokio::test]
        async fn ok() {
            let url = "redis://127.0.0.1:6379/2".to_string();
            let pool_cfg = PoolConfig {
                max_size: 10,
                timeouts: Timeouts {
                    wait: Some(time::Duration::from_secs(10)),
                    create: Some(time::Duration::from_secs(11)),
                    recycle: Some(time::Duration::from_secs(12)),
                },
                ..Default::default()
            };
            let cfg = Config {
                url: Some(url),
                connection: None,
                pool: Some(pool_cfg),
            };
            let mut ds = RedisDataSrcAsync::with_config(cfg);
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }

        #[tokio::test]
        async fn addr_is_url_and_fail() {
            let url = "xxxx".to_string();
            let pool_cfg = PoolConfig {
                max_size: 10,
                timeouts: Timeouts {
                    wait: Some(time::Duration::from_secs(10)),
                    create: Some(time::Duration::from_secs(11)),
                    recycle: Some(time::Duration::from_secs(12)),
                },
                ..Default::default()
            };
            let cfg = Config {
                url: Some(url),
                connection: None,
                pool: Some(pool_cfg),
            };
            let mut ds = RedisDataSrcAsync::with_config(cfg);
            let mut ag = AsyncGroup::new();
            let Err(err) = ds.setup_async(&mut ag).await else {
                panic!();
            };
            let Ok(RedisErrorAsync::FailToBuildPool { config }) = err.reason::<RedisErrorAsync>()
            else {
                panic!();
            };
            assert_eq!(format!("{:?}", config), "Config { url: Some(\"xxxx\"), connection: None, pool: Some(PoolConfig { max_size: 10, timeouts: Timeouts { wait: Some(10s), create: Some(11s), recycle: Some(12s) }, queue_mode: Fifo }) }");
            assert_eq!(
                format!("{:?}", err.source().unwrap()),
                "Config(Redis(Redis URL did not parse - InvalidClientConfig))",
            );
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
            ds.close();
        }
    }

    mod test_create_data_conn {
        use super::*;
        use redis::AsyncTypedCommands;

        #[tokio::test]
        async fn ok() {
            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0");
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            let Ok(mut data_conn) = ds.create_data_conn_async().await else {
                panic!("fail to create data_conn");
            };
            let redis_conn = data_conn.get_connection();

            redis_conn.set("test_create_data_conn", "1").await.unwrap();
            let s = redis_conn.get("test_create_data_conn").await.unwrap();
            redis_conn.del("test_create_data_conn").await.unwrap();
            assert_eq!(s, Some("1".to_string()));

            ds.close();
        }

        #[tokio::test]
        async fn fail() {
            let mut pcfg = PoolConfig::default();
            pcfg.max_size = 1usize;
            pcfg.timeouts.create = Some(time::Duration::from_millis(100));
            pcfg.timeouts.wait = Some(time::Duration::from_millis(100));
            let mut ds = RedisDataSrcAsync::with_pool_config("redis://127.0.0.1:6379/0", pcfg);
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            let Ok(_data_conn) = ds.create_data_conn_async().await else {
                panic!("fail to create data_conn");
            };
            let Err(err) = ds.create_data_conn_async().await else {
                panic!("fail to create data_conn");
            };
            let Ok(RedisErrorAsync::FailToGetConnectionFromPool) = err.reason::<RedisErrorAsync>()
            else {
                panic!();
            };
            assert_eq!(format!("{:?}", err.source().unwrap()), "Timeout(Wait)",);

            ds.close();
        }

        #[tokio::test]
        async fn not_setup_yet() {
            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0");
            let Err(err) = ds.create_data_conn_async().await else {
                panic!("fail to create data_conn");
            };
            let Ok(RedisErrorAsync::NotSetupYet) = err.reason::<RedisErrorAsync>() else {
                panic!();
            };
        }
    }

    mod test_setup {
        use super::*;

        #[tokio::test]
        async fn fail_due_to_setup_twice() {
            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0");
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            let mut ag = AsyncGroup::new();
            let Err(err) = ds.setup_async(&mut ag).await else {
                panic!();
            };
            let Ok(RedisErrorAsync::AlreadySetup) = err.reason::<RedisErrorAsync>() else {
                panic!("{err:?}");
            };
            let errors = ag.join_async().await;
            assert!(errors.is_empty());
        }
    }
}

#[cfg(test)]
mod unit_tests_of_data_conn {
    use super::*;

    mod test_and_pre_commt {
        use super::*;
        use redis::AsyncTypedCommands;

        #[tokio::test]
        async fn ok() {
            const KEY: &str = "test_add_pre_commit_async";

            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0");
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            let Ok(mut data_conn) = ds.create_data_conn_async().await else {
                panic!("fail to create data_conn");
            };
            assert!(data_conn.should_force_back());

            data_conn
                .add_pre_commit_async(async |mut redis_conn| {
                    redis_conn.set(KEY, "1").await.unwrap();
                    Ok(())
                })
                .await;

            let mut ag = AsyncGroup::new();
            data_conn.pre_commit_async(&mut ag).await.unwrap();
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                redis_conn.del(KEY).await.unwrap();
                assert_eq!(s, Some("1".to_string()));
            }

            let mut ag = AsyncGroup::new();
            data_conn.commit_async(&mut ag).await.unwrap();
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.post_commit_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.rollback_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.force_back_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            data_conn.close();
            ds.close();
        }

        #[tokio::test]
        async fn fail() {
            const KEY: &str = "test_add_pre_commit_async/fail";

            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0");
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            let Ok(mut data_conn) = ds.create_data_conn_async().await else {
                panic!("fail to create data_conn");
            };
            assert!(data_conn.should_force_back());

            data_conn
                .add_pre_commit_async(async |mut redis_conn| {
                    redis_conn.set(KEY, "1").await.unwrap();
                    Err(errs::Err::new("fail"))
                })
                .await;

            let mut ag = AsyncGroup::new();
            let Err(err) = data_conn.pre_commit_async(&mut ag).await else {
                panic!();
            };
            let s = err.reason::<&str>().unwrap();
            assert_eq!(*s, "fail");

            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                redis_conn.del(KEY).await.unwrap();
                assert_eq!(s, Some("1".to_string()));
            }

            let mut ag = AsyncGroup::new();
            data_conn.commit_async(&mut ag).await.unwrap();
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.post_commit_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.rollback_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.force_back_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            data_conn.close();
            ds.close();
        }
    }

    mod test_add_post_commit {
        use super::*;
        use redis::AsyncTypedCommands;

        #[tokio::test]
        async fn ok() {
            const KEY: &str = "test_add_post_commit_async";

            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0");
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            let Ok(mut data_conn) = ds.create_data_conn_async().await else {
                panic!("fail to create data_conn");
            };
            assert!(data_conn.should_force_back());

            data_conn
                .add_post_commit_async(async |mut redis_conn| {
                    redis_conn.set(KEY, "1").await.unwrap();
                    Ok(())
                })
                .await;

            let mut ag = AsyncGroup::new();
            data_conn.pre_commit_async(&mut ag).await.unwrap();
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.commit_async(&mut ag).await.unwrap();
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.post_commit_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                redis_conn.del(KEY).await.unwrap();
                assert_eq!(s, Some("1".to_string()));
            }

            let mut ag = AsyncGroup::new();
            data_conn.rollback_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.force_back_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            data_conn.close();
            ds.close();
        }

        #[tokio::test]
        async fn fail() {
            const KEY: &str = "test_add_post_commit_async/fail";

            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0");
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            let Ok(mut data_conn) = ds.create_data_conn_async().await else {
                panic!("fail to create data_conn");
            };
            assert!(data_conn.should_force_back());

            data_conn
                .add_post_commit_async(async |mut redis_conn| {
                    redis_conn.set(KEY, "1").await.unwrap();
                    Err(errs::Err::new("fail"))
                })
                .await;

            let mut ag = AsyncGroup::new();
            if let Err(err) = data_conn.pre_commit_async(&mut ag).await {
                panic!("{err:?}");
            };
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.commit_async(&mut ag).await.unwrap();
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.post_commit_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                redis_conn.del(KEY).await.unwrap();
                assert_eq!(s, Some("1".to_string()));
            }

            let mut ag = AsyncGroup::new();
            data_conn.rollback_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.force_back_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            data_conn.close();
            ds.close();
        }
    }

    mod test_add_force_back {
        use super::*;
        use redis::AsyncTypedCommands;

        #[tokio::test]
        async fn ok() {
            const KEY: &str = "test_add_force_back_async";

            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0");
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            let Ok(mut data_conn) = ds.create_data_conn_async().await else {
                panic!("fail to create data_conn");
            };
            assert!(data_conn.should_force_back());

            data_conn
                .add_force_back_async(async |mut redis_conn| {
                    redis_conn.set(KEY, "1").await.unwrap();
                    Ok(())
                })
                .await;

            let mut ag = AsyncGroup::new();
            data_conn.pre_commit_async(&mut ag).await.unwrap();
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.commit_async(&mut ag).await.unwrap();
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.post_commit_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.rollback_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.force_back_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                redis_conn.del(KEY).await.unwrap();
                assert_eq!(s, Some("1".to_string()));
            }

            data_conn.close();
            ds.close();
        }

        #[tokio::test]
        async fn fail() {
            const KEY: &str = "test_add_force_back_async/fail";

            let mut ds = RedisDataSrcAsync::new("redis://127.0.0.1:6379/0");
            let mut ag = AsyncGroup::new();
            if let Err(err) = ds.setup_async(&mut ag).await {
                panic!("{err:?}");
            }
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            let Ok(mut data_conn) = ds.create_data_conn_async().await else {
                panic!("fail to create data_conn");
            };
            assert!(data_conn.should_force_back());

            data_conn
                .add_force_back_async(async |mut redis_conn| {
                    redis_conn.set(KEY, "1").await.unwrap();
                    Err(errs::Err::new("fail"))
                })
                .await;

            let mut ag = AsyncGroup::new();
            if let Err(err) = data_conn.pre_commit_async(&mut ag).await {
                panic!("{:?}", err);
            };

            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.commit_async(&mut ag).await.unwrap();
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.post_commit_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.rollback_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                assert_eq!(s, None);
            }

            let mut ag = AsyncGroup::new();
            data_conn.force_back_async(&mut ag).await;
            let errors = ag.join_async().await;
            assert!(errors.is_empty());

            {
                let redis_conn = data_conn.get_connection();
                let s = redis_conn.get(KEY).await.unwrap();
                redis_conn.del(KEY).await.unwrap();
                assert_eq!(s, Some("1".to_string()));
            }

            data_conn.close();
            ds.close();
        }
    }
}