modo-rs 0.8.0

Rust web framework for small monolithic apps
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

use crate::error::Result;
use crate::runtime::Task;

use super::database::Database;

/// Wrapper for graceful shutdown integration with [`crate::run!`].
///
/// Wraps a [`Database`] so it can be registered as a [`Task`] with the
/// modo runtime. On shutdown the inner `Database` is dropped, which
/// releases the underlying libsql connection and database handle once the
/// last clone is gone.
///
/// Created by [`managed`].
pub struct ManagedDatabase(Database);

impl Task for ManagedDatabase {
    async fn shutdown(self) -> Result<()> {
        // Dropping Database drops the Arc. When the last reference is dropped,
        // Inner is dropped, which drops libsql::Connection and libsql::Database.
        // libsql handles cleanup internally.
        drop(self.0);
        Ok(())
    }
}

/// Wrap a [`Database`] for use with [`crate::run!`].
///
/// # Examples
///
/// ```rust,no_run
/// use modo::db;
///
/// # async fn example() -> modo::Result<()> {
/// let config = db::Config::default();
/// let db = db::connect(&config).await?;
/// let task = db::managed(db.clone());
/// // Register `task` with modo::run!() for graceful shutdown
/// # Ok(())
/// # }
/// ```
pub fn managed(db: Database) -> ManagedDatabase {
    ManagedDatabase(db)
}