embedded_redis_client 0.1.0

Automatically runs a local redis-server instance
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

use std::time::Duration;

use crate::embedded_redis_server::connection::{
    get_redis_server_connection, try_to_get_redis_server_connection_until_timeout,
};
use crate::embedded_redis_server::states::{ReadyToStart, RedisServerRunningInAnotherProcess};
use crate::embedded_redis_server::util::get_processes_using_target_port;
use crate::embedded_redis_server::{EmbeddedRedisServer, RedisServerConnectionSettings};
use crate::error::{EmbeddedRedisClientError, ErrorType};

pub struct CheckingRedisServerEnvironment {
    pub redis_server_connection: Option<redis::Connection>,
}

// Check if Redis is running in another process
// Check if the port if free

impl CheckingRedisServerEnvironment {
    pub fn start(
        connection_settings: RedisServerConnectionSettings,
        max_duration_to_attempt_connection: Duration,
    ) -> Result<EmbeddedRedisServer, EmbeddedRedisClientError> {
        match get_redis_server_connection(connection_settings.clone()) {
            Ok(connection) => {
                let environment = CheckingRedisServerEnvironment {
                    redis_server_connection: Some(connection),
                };
                let state = RedisServerRunningInAnotherProcess::try_from(environment)?;
                Ok(EmbeddedRedisServer::RunningInAnotherProcess(state))
            }
            Err(_) => {
                let environment = CheckingRedisServerEnvironment {
                    redis_server_connection: None,
                };
                let process_using_target_port =
                    get_processes_using_target_port(connection_settings.server_address.port());
                if process_using_target_port.is_empty() {
                    Ok(EmbeddedRedisServer::ReadyToStart(ReadyToStart::from(
                        environment,
                    )))
                } else {
                    // It might be that another process is in the process of starting a redis server, and has already blocked the port but is not yet ready to accept a new connection
                    match try_to_get_redis_server_connection_until_timeout(
                        connection_settings.clone(),
                        max_duration_to_attempt_connection,
                    ) {
                        Ok(_) => CheckingRedisServerEnvironment::start(
                            connection_settings,
                            max_duration_to_attempt_connection,
                        ),
                        Err(_) => {
                            let error_context = format!("These processses are using redis' port {} without enabling a connection: {:#?}\n", connection_settings.server_address, process_using_target_port);
                            if cfg!(debug_assertions) {
                                println!("{}", error_context);
                            }
                            Err(EmbeddedRedisClientError::new(
                                ErrorType::ServerEnvironment,
                                error_context,
                            ))
                        }
                    }
                }
            }
        }
    }

    // pub fn get_connection(&self) -> Option<redis::Connection> {
    //     self.redis_server_connection
    // }
}