borg-web 0.7.4

A local, live page of a collective's knowledge and usage statistics
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

//! `borg web [--port 7979] [--dir DIR]`: the command line around the page (lib.rs).

use std::path::PathBuf;
use std::sync::Arc;

use borg_web::{App, USAGE, minds, publish, router};

/// The page's port unless `--port` says otherwise. Protocol: the address the docs and `borg web`
/// print; one fixed port so a bookmark keeps working.
const PORT: u16 = 7979;

#[tokio::main]
async fn main() {
    let args: Vec<String> = std::env::args().skip(1).collect();
    let flag = |name: &str| args.iter().position(|a| a == name).and_then(|i| args.get(i + 1)).cloned();
    if args.iter().any(|a| a == "-h" || a == "--help") {
        println!("{USAGE}");
        return;
    }
    if args.iter().any(|a| a == "-V" || a == "--version") {
        println!("borg-web {}", env!("CARGO_PKG_VERSION"));
        return;
    }
    let port: u16 = match flag("--port").map(|p| p.parse()) {
        None => PORT,
        Some(Ok(p)) => p,
        Some(Err(_)) => {
            eprintln!("{USAGE}");
            std::process::exit(2);
        }
    };
    let dir = flag("--dir").map(PathBuf::from).unwrap_or_else(|| std::env::current_dir().unwrap_or_default());
    let dir = std::path::absolute(&dir).unwrap_or(dir).display().to_string();
    let (minds, first) = match minds(&dir) {
        Ok(v) => v,
        Err(e) => {
            eprintln!("borg web: invalid collectives config: {e}");
            std::process::exit(1);
        }
    };
    if minds.is_empty() {
        eprintln!("borg web: no collective on this machine");
        std::process::exit(1);
    }
    tokio::spawn(publish(minds.clone()));
    // Loopback only: the page shows lessons and who works where, never to the network.
    let addr = std::net::SocketAddr::from(([127, 0, 0, 1], port));
    let listener = match tokio::net::TcpListener::bind(addr).await {
        Ok(l) => l,
        Err(e) => {
            eprintln!("borg web: cannot listen on {addr}: {e}");
            std::process::exit(1);
        }
    };
    println!("borg web: http://{addr}/  ({} collectives, showing {first}; Ctrl-C stops)", minds.len());
    let (stopping, stop) = tokio::sync::watch::channel(false);
    let app = Arc::new(App { minds, first, cwd: dir, stop });
    let stop = async move {
        let _ = tokio::signal::ctrl_c().await;
        let _ = stopping.send(true);
    };
    if let Err(e) = axum::serve(listener, router(app)).with_graceful_shutdown(stop).await {
        eprintln!("borg web: {e}");
        std::process::exit(1);
    }
}