octra-sqlite 0.6.3

Real SQLite inside an Octra Circle, with a Rust CLI and client library
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
98
99

use std::fs;
use std::path::Path;

#[test]
fn protocol_layer_stays_transport_and_cli_free() {
    let forbidden = [
        "anyhow",
        "ureq",
        "clap",
        "dirs",
        "std::env",
        "std::fs",
        "PathBuf",
        "println!",
        "eprintln!",
    ];
    for path in source_files("src/protocol") {
        let text = fs::read_to_string(&path).unwrap();
        for needle in forbidden {
            assert!(
                !text.contains(needle),
                "{} must not contain {needle}",
                path.display()
            );
        }
    }
}

#[test]
fn client_layer_does_not_depend_on_cli_rendering() {
    let forbidden = [
        "clap",
        "crate::cli::",
        "crate::cli;",
        "cli::",
        "OutputMode",
        "print_result",
    ];
    for path in source_files("src/client") {
        let text = fs::read_to_string(&path).unwrap();
        for needle in forbidden {
            assert!(
                !text.contains(needle),
                "{} must not contain {needle}",
                path.display()
            );
        }
    }
}

#[test]
fn cli_orchestrator_is_organized_by_responsibility() {
    let orchestrator = fs::read_to_string("src/cli/mod.rs").unwrap();
    for module in [
        "catalog",
        "databases",
        "deployment",
        "inspection",
        "onboarding",
        "sql",
        "tests",
    ] {
        assert!(
            orchestrator.contains(&format!("mod {module};")),
            "CLI orchestrator must retain the {module} responsibility boundary"
        );
    }
    for workflow in [
        "fn cmd_setup(",
        "fn cmd_new(",
        "fn cmd_database(",
        "fn cmd_open(",
        "fn cmd_limits(",
        "fn cmd_status(",
        "fn cmd_deploy(",
    ] {
        assert!(
            !orchestrator.contains(workflow),
            "{workflow} belongs in its focused CLI module"
        );
    }
}

fn source_files(dir: impl AsRef<Path>) -> Vec<std::path::PathBuf> {
    let mut out = Vec::new();
    collect_source_files(dir.as_ref(), &mut out);
    out
}

fn collect_source_files(dir: &Path, out: &mut Vec<std::path::PathBuf>) {
    for entry in fs::read_dir(dir).unwrap() {
        let path = entry.unwrap().path();
        if path.is_dir() {
            collect_source_files(&path, out);
        } else if path.extension().and_then(|ext| ext.to_str()) == Some("rs") {
            out.push(path);
        }
    }
}