runique 3.0.2

A Django-inspired web framework for Rust with ORM, templates, and comprehensive security middleware
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

//! Global registry of URL names — `register_pending`, `reverse()`, `reverse_with_parameters()`.
use crate::utils::aliases::{AEngine, PendingUrls};
use std::sync::LazyLock;
use std::sync::Mutex;

// --- 1. Temporary storage for the macro ---
pub static PENDING_URLS: LazyLock<Mutex<PendingUrls>> = LazyLock::new(|| Mutex::new(Vec::new()));

/// Used by the urlpatterns! macro
pub fn register_pending(name: impl Into<String>, path: impl Into<String>) {
    let mut pending = PENDING_URLS.lock().unwrap_or_else(|e| e.into_inner());
    pending.push((name.into(), path.into()));
}

// --- 2. Functions directly using RuniqueEngine (Runtime) ---

/// Registers a URL in the engine
pub fn register_name_url(engine: &AEngine, name: impl Into<String>, path: impl Into<String>) {
    let mut map = engine
        .url_registry
        .write()
        .unwrap_or_else(|e| e.into_inner());
    map.insert(name.into(), path.into());
}

/// Retrieves a URL from its name
pub fn reverse(engine: &AEngine, name: &str) -> Option<String> {
    let map = engine
        .url_registry
        .read()
        .unwrap_or_else(|e| e.into_inner());
    map.get(name).cloned()
}

/// Retrieves a URL with parameter substitution
pub fn reverse_with_parameters(
    engine: &AEngine,
    name: &str,
    parameters: &[(&str, &str)],
) -> Option<String> {
    let path = reverse(engine, name)?;
    let result = parameters
        .iter()
        .fold(path, |acc, (k, v)| acc.replace(&format!("{{{}}}", k), v));
    Some(result)
}

/// Transfers all pending URLs to the engine
pub fn add_urls(engine: &AEngine) {
    let mut pending = PENDING_URLS.lock().unwrap_or_else(|e| e.into_inner());
    let mut map = engine
        .url_registry
        .write()
        .unwrap_or_else(|e| e.into_inner());

    for (name, path) in pending.drain(..) {
        map.insert(name, path);
    }
}