haematite-cli 0.21.1

The haematite command: serve a store, its door and Studio, answer MCP, query with jq, and host the store's assistant seat
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

use std::io::Read;

use flate2::read::GzDecoder;

use super::{Packed, gzip, hashed, takes_gzip};

type TestResult = Result<(), Box<dyn std::error::Error>>;

/// Fails while a file that can change under its name is kept for good, or a
/// content-hashed asset is not: only `/assets/` names ending `-` and the
/// eight-character hash before their extension are hashed.
#[test]
fn only_a_content_hashed_asset_is_hashed() {
    for path in [
        "/assets/index-BdF3x9kZ.js",
        "/assets/graphmother.esm-Ab_d-234.js",
        "/assets/haematite_query_bg-0aZ9_-xY.wasm",
        "/assets/index-C0ffee12.css",
    ] {
        assert!(hashed(path), "{path} was not taken as hashed");
    }
    for path in [
        "/index.html",
        "/app-BdF3x9kZ.js",
        "/assets/logo.svg",
        "/assets/index-short.js",
        "/assets/-BdF3x9kZ.js",
        "/assets/index-BdF3x9k!.js",
        "/assets/index-BdF3x9kZ",
    ] {
        assert!(!hashed(path), "{path} was taken as hashed");
    }
}

/// Fails while gzip is sent to a browser that did not ask for it, or refused
/// one that did: named, or `*`, with a quality above zero.
#[test]
fn gzip_is_taken_only_when_the_browser_asks_for_it() {
    for accept in [
        "gzip",
        "gzip, deflate, br",
        "br;q=1.0, GZIP;q=0.5",
        "x-gzip",
        "*",
    ] {
        assert!(takes_gzip(Some(accept)), "{accept} was refused gzip");
    }
    for accept in [
        None,
        Some(""),
        Some("br"),
        Some("identity"),
        Some("gzip;q=0"),
        Some("*, gzip;q=0.000"),
    ] {
        assert!(!takes_gzip(accept), "{accept:?} was given gzip");
    }
}

/// The gzipped bytes decode back to the file; a hashed file is answered from
/// memory once compressed, and any other is read again.
#[test]
fn a_hashed_file_is_compressed_once_and_another_read_again() -> TestResult {
    let files = tempfile::tempdir()?;
    let path = files.path().join("index-BdF3x9kZ.js");
    let text = "export const studio = 1;\n".repeat(64);
    std::fs::write(&path, &text)?;
    let packed = Packed::default();
    let first = packed.gzipped(&path, true)?;
    let mut decoded = String::new();
    GzDecoder::new(&first[..]).read_to_string(&mut decoded)?;
    assert_eq!(decoded, text);
    assert_eq!(&first[..], gzip(text.as_bytes())?.as_slice());
    std::fs::remove_file(&path)?;
    assert_eq!(
        packed.gzipped(&path, true)?,
        first,
        "a hashed file was read again"
    );
    assert!(
        packed.gzipped(&path, false).is_err(),
        "a file that can change was answered from memory"
    );
    Ok(())
}