qql-cli 0.4.2

Command-line interface, REPL, converter, and migration tools for QQL
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! End-to-end tests for CLI embedder diagnostics and parameter ergonomics.

use std::path::PathBuf;
use std::process::Command;
use std::time::{SystemTime, UNIX_EPOCH};

fn temp_json(tag: &str, contents: &str) -> PathBuf {
    let nanos = SystemTime::now()
        .duration_since(UNIX_EPOCH)
        .expect("clock")
        .as_nanos();
    let dir = std::env::temp_dir().join(format!("qql-params-it-{}-{nanos}", std::process::id()));
    std::fs::create_dir_all(&dir).expect("create temp dir");
    let path = dir.join(format!("{tag}.json"));
    std::fs::write(&path, contents).expect("write json fixture");
    path
}

fn qql(args: &[&str]) -> std::process::Output {
    let nanos = SystemTime::now()
        .duration_since(UNIX_EPOCH)
        .expect("clock")
        .as_nanos();
    let home = std::env::temp_dir().join(format!("qql-test-home-{nanos}-{}", std::process::id()));
    let _ = std::fs::create_dir_all(&home);
    Command::new(env!("CARGO_BIN_EXE_qql"))
        .args(args)
        .env("HOME", &home)
        .env_remove("EMBED_URL")
        .env_remove("EMBED_TYPE")
        .env_remove("QQL_FASTEMBED")
        .output()
        .expect("run qql")
}

#[test]
fn missing_embedder_returns_qql_embedding_unavailable() {
    let out = qql(&[
        "run",
        "QUERY TEXT 'apartment' FROM stays USING dense LIMIT 5;",
    ]);
    assert!(!out.status.success(), "run should fail without embedder");
    let stderr = String::from_utf8_lossy(&out.stderr);
    assert!(
        stderr.contains("QQL-EMBEDDING-UNAVAILABLE"),
        "expected QQL-EMBEDDING-UNAVAILABLE error code, got: {stderr}"
    );
    assert!(
        stderr.contains("--params-file"),
        "expected remediation guidance mentioning --params-file, got: {stderr}"
    );
}

#[test]
fn explain_with_high_dimensional_vector_params_file() {
    // 384-dimensional vector
    let vec_384: Vec<f64> = (0..384).map(|i| (i as f64) * 0.001).collect();
    let json_content = serde_json::json!({
        "qvec": vec_384
    })
    .to_string();

    let json_path = temp_json("vec384", &json_content);

    let out = qql(&[
        "explain",
        "--params-file",
        json_path.to_str().unwrap(),
        "QUERY :qvec FROM docs LIMIT 5;",
    ]);

    assert!(
        out.status.success(),
        "stderr: {}",
        String::from_utf8_lossy(&out.stderr)
    );
    let stdout = String::from_utf8_lossy(&out.stdout);
    assert!(
        stdout.contains("Query Nearest") || stdout.contains("docs"),
        "expected plan output, got: {stdout}"
    );
}

#[test]
fn repl_help_displays_params_file_flag() {
    let out = qql(&["repl", "--help"]);
    assert!(out.status.success());
    let stdout = String::from_utf8_lossy(&out.stdout);
    assert!(stdout.contains("--params-file"));
    assert!(stdout.contains("--param"));
}

#[test]
fn test_version_command_reports_valid_json_and_edition() {
    let out = qql(&["version"]);
    assert!(out.status.success(), "qql version should succeed");
    let stdout = String::from_utf8_lossy(&out.stdout);
    let val: serde_json::Value =
        serde_json::from_str(&stdout).expect("version output must be valid json");
    assert_eq!(val["ok"], true);
    assert_eq!(val["command"], "version");
    assert!(val["version"].is_string());
    assert!(val["edition"].is_string());
    let edition = val["edition"].as_str().unwrap();
    assert!(
        edition == "standard" || edition == "full" || edition == "custom",
        "unexpected edition: {edition}"
    );
    let message = val["message"].as_str().unwrap();
    assert!(
        message.contains(&format!("({edition})")),
        "message should contain edition in parens, got: {message}"
    );
}