adguard-flm 2.6.0

This crate represents a library for managing AdGuard filter lists
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

use super::DbConnectionManager;
use crate::{FLMError, FLMResult};
use rusqlite::{Connection, OpenFlags};

#[doc(hidden)]
/// Open a new connection to a SQLite storage. If db file does not exist, it will be created.
///
/// # Failure
///
/// [`FLMError`] if you couldn't open db
pub(super) fn connect_with_create(
    connection_source: &DbConnectionManager,
) -> FLMResult<Connection> {
    connect_internal(
        connection_source,
        OpenFlags::SQLITE_OPEN_READ_WRITE | OpenFlags::SQLITE_OPEN_CREATE,
    )
}

/// Creates connection to existing db from path in R/W mode.
///
/// # Failure
///
/// returns [`FLMError`] if an error encountered
pub(super) fn connect(connection_source: &DbConnectionManager) -> FLMResult<Connection> {
    connect_internal(connection_source, OpenFlags::SQLITE_OPEN_READ_WRITE)
}

/// Main connection function
#[inline]
fn connect_internal(
    connection_source: &DbConnectionManager,
    open_flags: OpenFlags,
) -> FLMResult<Connection> {
    Connection::open_with_flags(connection_source.get_calculated_path(), open_flags)
        .map_err(FLMError::from_database)
}

#[cfg(test)]
mod tests {
    use super::connect;
    use crate::storage::error::DatabaseError;
    use crate::storage::DbConnectionManager;
    use crate::FLMError;

    #[test]
    fn test_db_file_does_not_exists() {
        let database_path_holder = DbConnectionManager::factory_test().unwrap();

        let err = connect(&database_path_holder).err().unwrap();

        assert_eq!(err, FLMError::Database(DatabaseError::CannotOpen));
    }
}