lariv-rs 0.1.0

Compile-time plugin web application framework built on Axum, SeaORM, Maud, and HTMX
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
71
72
73
74
75
76
77

//! Blog post management and hierarchical tagging.
//!
//! CRUD for blog articles and ltree-backed tags at `/blog/…`.
//! Auth via [`crate::plugins::users::middleware::RequireAuth`].
//!
//! # Database models
//!
//! - [`entities::Blog`]: article with title, markdown content, author (`CreatedBy`), and tags.
//! - [`entities::BlogTag`]: hierarchical tags (PostgreSQL `ltree`) with many-to-many blogs.
//!
//! # Routes
//!
//! - `/blog/`, `/blog/create/`, `/blog/{id}/`, edit/delete
//! - `/blog/tags/`, tag CRUD variants

pub mod apps;
pub mod create_modals;
pub mod entities;
pub mod forms;
pub mod handlers;
pub mod keys;
pub mod migrations;
pub mod routes;
pub mod slug;
pub mod state;
pub mod templates;

use frunk::{HCons, hlist::HList};

use crate::plugin_install::define_plugin_install;
use crate::{
    app::App,
    capability::{CapStore, define_passthrough_cap},
    db::{DbCap, DbTag},
    hooks::AttachState,
    traits::{
        add::{AddCapability, CapTagAbsent},
        get::GetByCapTag,
    },
};

use state::BlogState;

/// Capability tag for the blog plugin state.
pub struct BlogTag;

define_passthrough_cap!(BlogStateCap, BlogTag, BlogState);

define_plugin_install! {
    plugin: BlogTag;
    /// Register blog deferred hooks (apps, migrations, templates, slots, routes, state).
    steps: [
        apps(apps::Hook),
        migrations(migrations::Hook),
        templates(templates::Hook),
        slots(templates::SlotsHook),
        http(routes::Hook),
        state(StateHook),
    ]
}

/// Attaches [`BlogState`] (DB connection) at app mount.
#[derive(Clone, Copy, Default)]
pub struct StateHook;

impl<L, DbIdx, TagProof> AttachState<L, (DbIdx, TagProof)> for StateHook
where
    L: GetByCapTag<DbTag, DbIdx, Value = DbCap>,
    L: HList + CapTagAbsent<BlogTag, TagProof>,
{
    type Output = HCons<BlogStateCap, L>;

    fn attach_state(app: App<L>) -> App<Self::Output> {
        let conn = app.get_capability::<DbTag, DbIdx>().items.conn.clone();
        app.add_capability(CapStore::with_items(BlogState::new(conn)))
    }
}