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
55
56
57
58

//! Root module of data storage operations

use crate::{FLMError, FLMResult};
use rusqlite::{Connection, Transaction};

pub(crate) mod blob;
pub mod constants;
pub(crate) mod database_status;
pub(crate) mod db_bootstrap;
mod db_connection_manager;
pub(crate) mod entities;
pub mod error;
mod migrations;
pub(crate) mod repositories;
pub(crate) mod sql_generators;
mod utils;

pub use db_connection_manager::database_name;
pub use db_connection_manager::DbConnectionManager;
pub use entities::hydrate::Hydrate;

#[doc(hidden)]
/// Make a block, wrapped with transaction
///
/// # Failure
///
/// returns [`rusqlite::Error`] if an error encountered
pub(crate) fn with_transaction<F, U>(conn: &mut Connection, f: F) -> FLMResult<U>
where
    F: FnOnce(&Transaction) -> rusqlite::Result<U>,
{
    let transaction = conn.transaction().map_err(FLMError::from_database)?;
    let out = f(&transaction).map_err(FLMError::from_database)?;
    transaction.commit().map_err(FLMError::from_database)?;

    Ok(out)
}

#[doc(hidden)]
/// Make a transactional block, but don't commit transaction. Return it instead
///
/// Returns tuple([`Transaction`], `U`)
///
/// # Failure
///
/// Returns [`rusqlite::Error`] if an error encountered
pub(crate) fn spawn_transaction<F, U>(
    conn: &mut Connection,
    f: F,
) -> rusqlite::Result<(Transaction, U)>
where
    F: FnOnce(&Transaction) -> rusqlite::Result<U>,
{
    let transaction = conn.transaction()?;
    let out = f(&transaction)?;

    Ok((transaction, out))
}