duvis 0.1.6

Disk usage visualizer for both AI and humans
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

// Materializes the bundled browser UI into Cargo's `OUT_DIR` so `src/ui.rs`
// can `include_str!` it. Two paths:
//
// - **Developer checkout** (`ui/` present): run `npm run build` so the
//   bundled UI is always in sync with `ui/src/`, copy to OUT_DIR.
// - **End-user install from crates.io** (`ui/` excluded from the tarball):
//   read `prebuilt/ui.html` (which Cargo.toml `include` ships in the
//   tarball) and copy that to OUT_DIR. No Node required.
//
// `prebuilt/ui.html` is gitignored (we don't want a 200KB blob diff per UI
// change) and refreshed by `just ui-build-prebuilt` before publishing.
// Cargo build never writes to `prebuilt/` itself, so day-to-day cargo runs
// leave the working tree alone. `cargo publish` does need `--allow-dirty`
// because the file is untracked at publish time, but the include list
// guarantees it rides into the tarball.
//
// We deliberately avoid writing the bundle into `src/` — generated artifacts
// inside the source tree confuse readers and `git status`.

use std::env;
use std::fs;
use std::path::{Path, PathBuf};
use std::process::Command;

fn main() {
    println!("cargo:rerun-if-changed=ui/src");
    println!("cargo:rerun-if-changed=ui/index.html");
    println!("cargo:rerun-if-changed=ui/package.json");
    println!("cargo:rerun-if-changed=ui/package-lock.json");
    println!("cargo:rerun-if-changed=ui/vite.config.ts");
    println!("cargo:rerun-if-changed=ui/tsconfig.json");
    println!("cargo:rerun-if-changed=prebuilt/ui.html");

    let out_dir: PathBuf = env::var_os("OUT_DIR")
        .expect("OUT_DIR is set by cargo for build scripts")
        .into();
    let dst = out_dir.join("ui.html");

    let ui_dir = Path::new("ui");
    let prebuilt = Path::new("prebuilt/ui.html");

    if ui_dir.join("package.json").exists() {
        // Dev / repo build: rebuild from sources so the binary always reflects
        // the current ui/src/ state. Does NOT update prebuilt/ — that's a
        // separate, explicit step (`just ui-build-prebuilt`) so the working
        // tree only changes when the developer means it to.
        if !ui_dir.join("node_modules").exists() {
            warn("installing ui/ dependencies (npm ci)...");
            npm(&["--prefix", "ui", "ci"]);
        }
        warn("building ui/ via vite...");
        npm(&["--prefix", "ui", "run", "build"]);

        let dist = ui_dir.join("dist/index.html");
        assert!(
            dist.exists(),
            "expected vite output at {} after `npm run build`",
            dist.display()
        );
        fs::copy(&dist, &dst).unwrap_or_else(|e| {
            panic!(
                "failed to copy {} -> {}: {e}",
                dist.display(),
                dst.display()
            )
        });
    } else if prebuilt.exists() {
        // End-user install: tarball ships prebuilt/ui.html via Cargo.toml
        // `include`. Just stage it for include_str!.
        fs::copy(prebuilt, &dst).unwrap_or_else(|e| {
            panic!(
                "failed to copy {} -> {}: {e}",
                prebuilt.display(),
                dst.display()
            )
        });
    } else {
        panic!(
            "neither ui/ source nor prebuilt/ui.html is present. \
             A duvis tarball must include the prebuilt UI."
        );
    }
}

fn warn(msg: &str) {
    println!("cargo:warning={msg}");
}

fn npm(args: &[&str]) {
    // Windows resolves shims via PATHEXT, but Command::new doesn't, so we have
    // to spell out npm.cmd there.
    let cmd = if cfg!(windows) { "npm.cmd" } else { "npm" };
    let status = Command::new(cmd).args(args).status().unwrap_or_else(|e| {
        panic!("failed to spawn `{cmd}`: {e}. Install Node.js to build the UI.")
    });
    assert!(status.success(), "`{cmd} {}` failed", args.join(" "));
}