umbral-admin 0.0.12

Auto-generated CRUD admin UI for umbral models.
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

//! Cargo build script for umbral-admin.
//!
//! Attempts to run the Tailwind CSS build to produce
//! `src/assets/admin.css` from `css/input.css`. If Node or npx is not
//! installed the build is silently skipped and the fallback dev-CDN
//! path is used at runtime.
//!
//! Manual build: `cd plugins/umbral-admin/css && npm install && npm run build`

use std::path::PathBuf;
use std::process::Command;

fn main() {
    // Re-run if any template or input CSS changes.
    println!("cargo:rerun-if-changed=templates");
    println!("cargo:rerun-if-changed=css/input.css");
    println!("cargo:rerun-if-changed=css/tailwind.config.js");

    let manifest_dir = std::env::var("CARGO_MANIFEST_DIR").unwrap_or_else(|_| ".".to_string());
    let css_dir = PathBuf::from(&manifest_dir).join("css");
    let out_css = PathBuf::from(&manifest_dir).join("src/assets/admin.css");

    // Skip if node_modules doesn't exist (user hasn't run npm install).
    if !css_dir.join("node_modules").exists() {
        println!(
            "cargo:warning=umbral-admin: Tailwind CSS not built (node_modules missing). \
             Run `cd plugins/umbral-admin/css && npm install && npm run build` for production CSS. \
             Development uses the Tailwind CDN."
        );
        return;
    }

    // Try to run the build.
    let status = Command::new("npx")
        .arg("tailwindcss")
        .arg("-c")
        .arg("tailwind.config.js")
        .arg("-i")
        .arg("input.css")
        .arg("-o")
        .arg(&out_css)
        .arg("--minify")
        .current_dir(&css_dir)
        .status();

    match status {
        Ok(s) if s.success() => {
            // NOT `cargo:warning=` — that channel means "something is wrong", and this is the
            // happy path. Announcing success through it printed a `warning:` line into every
            // single build of every umbral app, which trains users to skim past warnings; the
            // next one, the real one, gets skimmed past too. Plain stdout from a build script
            // is captured by cargo and shown with `-vv`, which is the right volume for "the
            // thing that was supposed to happen happened."
            println!("umbral-admin: Tailwind CSS built successfully.");
        }
        Ok(s) => {
            println!(
                "cargo:warning=umbral-admin: Tailwind CSS build exited with status {s}. \
                 Using CDN fallback in dev."
            );
        }
        Err(e) => {
            println!(
                "cargo:warning=umbral-admin: Tailwind CSS build failed ({e}). \
                 Using CDN fallback in dev."
            );
        }
    }
}