mirror of
https://github.com/TheTom/turboquant_plus.git
synced 2026-10-21 18:42:44 -05:00
TheTomandClaude Opus 4.7
d952a45745
When llama-completion fails to launch (Linux missing libllama.so on the loader path, or Windows missing the DLL next to the .exe), the binary emits empty stdout and a "cannot open shared object" / 0xc0000135 stderr. The old selftest read empty stdout and reported "--jinja missing" — misleading diagnosis that sent users hunting for chat template support when the real problem was the loader. Now the selftest checks return code + stderr for shared-library / DLL errors and emits OS-specific remediation (LD_LIBRARY_PATH/ldconfig on Linux, PATH-next-to-exe on Windows). Three new tests pin both failure modes plus the happy path. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
297 lines
11 KiB
Python
297 lines
11 KiB
Python
"""Extra CLI tests to push coverage on selftest model probe + score floor."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import json
|
|
from pathlib import Path
|
|
from unittest import mock
|
|
|
|
import pytest
|
|
|
|
import refract.cli as cli
|
|
from refract.backends.base import CompletionResult
|
|
from refract.tests.test_cli_runs import (
|
|
_FakeBackend,
|
|
_gtm_result,
|
|
_kld_result,
|
|
_make_score_args,
|
|
_patch_backends,
|
|
_traj_result,
|
|
)
|
|
|
|
|
|
def test_run_score_measure_floor_passes(tmp_path, monkeypatch):
|
|
"""Floor=100 (perfect ref-vs-ref) → score continues normally."""
|
|
_patch_backends(monkeypatch)
|
|
monkeypatch.setattr(cli, "run_gtm", lambda **kw: _gtm_result(100.0))
|
|
monkeypatch.setattr(cli, "run_kld",
|
|
lambda **kw: _kld_result(100.0, mean_kld=0.0))
|
|
args = _make_score_args(tmp_path, axis_a="gtm", measure_floor=True)
|
|
rc = cli._run_score(args)
|
|
assert rc == 0
|
|
|
|
|
|
def test_run_score_floor_byte_identity_failure_aborts(tmp_path, monkeypatch, capsys):
|
|
"""Floor composite = 100 but mean_prefix != mean_cand → byte-identity fail."""
|
|
_patch_backends(monkeypatch)
|
|
|
|
def _broken_gtm(**kw):
|
|
from refract.axes.gtm import GTMResult
|
|
return GTMResult(
|
|
score=100.0, full_match_rate=1.0, median_first_divergence=None,
|
|
mean_prefix_agreement_length=99.0, # != mean_cand_length 100.0
|
|
mean_cand_length=100.0, mean_ref_length=100.0,
|
|
n_prompts=1, n_tokens_each=128, per_prompt=[], notes=[],
|
|
)
|
|
|
|
monkeypatch.setattr(cli, "run_gtm", _broken_gtm)
|
|
monkeypatch.setattr(cli, "run_kld",
|
|
lambda **kw: _kld_result(100.0, mean_kld=0.0))
|
|
args = _make_score_args(tmp_path, axis_a="gtm", measure_floor=True)
|
|
rc = cli._run_score(args)
|
|
assert rc == 2
|
|
assert "byte-identical" in capsys.readouterr().out
|
|
|
|
|
|
def test_run_selftest_model_probe_succeeds(tmp_path, monkeypatch, capsys):
|
|
"""Selftest with --model present + working backend → probe success path."""
|
|
bin_dir = tmp_path / "bin"
|
|
bin_dir.mkdir()
|
|
for tool in ("llama-cli", "llama-completion",
|
|
"llama-tokenize", "llama-perplexity"):
|
|
(bin_dir / tool).write_text("")
|
|
monkeypatch.setattr("refract.runner.DEFAULT_BIN_DIR", bin_dir)
|
|
# llama-completion --help check passes
|
|
monkeypatch.setattr(
|
|
"subprocess.run",
|
|
lambda *a, **kw: mock.MagicMock(stdout="--jinja flag\n"),
|
|
)
|
|
|
|
class _GoodBackend(_FakeBackend):
|
|
def run_completion(self, **kw):
|
|
return CompletionResult(text="4", n_tokens=1, metadata={})
|
|
|
|
import refract.backends as bk_mod
|
|
monkeypatch.setattr(bk_mod, "auto_backend",
|
|
lambda model: _GoodBackend())
|
|
|
|
model_path = tmp_path / "m.gguf"
|
|
model_path.write_text("")
|
|
args = argparse.Namespace(backend="auto", model=model_path)
|
|
rc = cli._run_selftest(args)
|
|
assert rc == 0
|
|
out = capsys.readouterr().out
|
|
assert "generation works" in out
|
|
assert "no thinking-mode markers" in out
|
|
|
|
|
|
def test_run_selftest_model_probe_generation_fails(tmp_path, monkeypatch, capsys):
|
|
"""Selftest --model where generation raises → recorded as failure."""
|
|
bin_dir = tmp_path / "bin"
|
|
bin_dir.mkdir()
|
|
for tool in ("llama-cli", "llama-completion",
|
|
"llama-tokenize", "llama-perplexity"):
|
|
(bin_dir / tool).write_text("")
|
|
monkeypatch.setattr("refract.runner.DEFAULT_BIN_DIR", bin_dir)
|
|
monkeypatch.setattr(
|
|
"subprocess.run",
|
|
lambda *a, **kw: mock.MagicMock(stdout="--jinja\n"),
|
|
)
|
|
|
|
class _BoomBackend(_FakeBackend):
|
|
def run_completion(self, **kw):
|
|
raise RuntimeError("model exploded")
|
|
|
|
import refract.backends as bk_mod
|
|
monkeypatch.setattr(bk_mod, "auto_backend", lambda m: _BoomBackend())
|
|
|
|
model_path = tmp_path / "m.gguf"
|
|
model_path.write_text("")
|
|
args = argparse.Namespace(backend="auto", model=model_path)
|
|
rc = cli._run_selftest(args)
|
|
assert rc == 2
|
|
assert "generation failed" in capsys.readouterr().out
|
|
|
|
|
|
def test_run_selftest_jinja_missing_records_failure(tmp_path, monkeypatch, capsys):
|
|
bin_dir = tmp_path / "bin"
|
|
bin_dir.mkdir()
|
|
for tool in ("llama-cli", "llama-completion",
|
|
"llama-tokenize", "llama-perplexity"):
|
|
(bin_dir / tool).write_text("")
|
|
monkeypatch.setattr("refract.runner.DEFAULT_BIN_DIR", bin_dir)
|
|
# No --jinja in help
|
|
monkeypatch.setattr(
|
|
"subprocess.run",
|
|
lambda *a, **kw: mock.MagicMock(stdout="some other help text"),
|
|
)
|
|
args = argparse.Namespace(backend="llamacpp", model=None)
|
|
rc = cli._run_selftest(args)
|
|
assert rc == 2
|
|
out = capsys.readouterr().out
|
|
assert "--jinja missing" in out
|
|
|
|
|
|
def test_run_selftest_help_probe_exception_is_warning(tmp_path, monkeypatch, capsys):
|
|
bin_dir = tmp_path / "bin"
|
|
bin_dir.mkdir()
|
|
for tool in ("llama-cli", "llama-completion",
|
|
"llama-tokenize", "llama-perplexity"):
|
|
(bin_dir / tool).write_text("")
|
|
monkeypatch.setattr("refract.runner.DEFAULT_BIN_DIR", bin_dir)
|
|
|
|
def boom(*a, **kw):
|
|
raise RuntimeError("subprocess died")
|
|
|
|
monkeypatch.setattr("subprocess.run", boom)
|
|
args = argparse.Namespace(backend="llamacpp", model=None)
|
|
rc = cli._run_selftest(args)
|
|
# Warnings only → rc 0
|
|
assert rc == 0
|
|
out = capsys.readouterr().out
|
|
assert "warning" in out.lower()
|
|
|
|
|
|
def test_run_selftest_mlx_backend_handles_missing_mlx(monkeypatch, capsys):
|
|
import sys
|
|
# Hide mlx imports so _require_mlx raises BackendCapabilityError.
|
|
monkeypatch.setitem(sys.modules, "mlx", None)
|
|
monkeypatch.setitem(sys.modules, "mlx.core", None)
|
|
monkeypatch.setitem(sys.modules, "mlx_lm", None)
|
|
args = argparse.Namespace(backend="mlx", model=None)
|
|
rc = cli._run_selftest(args)
|
|
assert rc == 2
|
|
out = capsys.readouterr().out
|
|
assert "mlx not importable" in out
|
|
|
|
|
|
def test_run_repeatability_warning_when_json_unparseable(tmp_path, monkeypatch, capsys):
|
|
_patch_backends(monkeypatch)
|
|
|
|
def fake_run_score(args):
|
|
# Write invalid JSON
|
|
args.json_out.write_text("not valid json")
|
|
return 0
|
|
|
|
monkeypatch.setattr(cli, "_run_score", fake_run_score)
|
|
args = argparse.Namespace(
|
|
model=tmp_path / "m.gguf",
|
|
reference="ctk=f16,ctv=f16", candidate="ctk=q8_0,ctv=q8_0",
|
|
prompts=tmp_path / "p.jsonl", corpus=tmp_path / "c.txt",
|
|
runs=2, n_predict=8, ctx=512, chunks=32, n_gpu_layers=99, seed=42,
|
|
axis_a="trajectory", full=False,
|
|
rniah_haystack=None, rniah_ctx_max=None,
|
|
backend="auto", out_dir=tmp_path / "out",
|
|
)
|
|
rc = cli._run_repeatability(args)
|
|
assert rc == 0
|
|
out = capsys.readouterr().out
|
|
assert "could not parse" in out
|
|
|
|
|
|
def test_run_selftest_detects_linux_shared_library_error(tmp_path, monkeypatch, capsys):
|
|
"""Bug: a binary that can't find libllama.so emits empty --help and a
|
|
'cannot open shared object' stderr. Old selftest read empty stdout and
|
|
blamed '--jinja missing'. New selftest detects the real launch failure
|
|
AND emits a Linux-specific remediation hint."""
|
|
bin_dir = tmp_path / "bin"
|
|
bin_dir.mkdir()
|
|
for tool in ("llama-cli", "llama-completion",
|
|
"llama-tokenize", "llama-perplexity"):
|
|
(bin_dir / tool).write_text("")
|
|
monkeypatch.setattr("refract.runner.DEFAULT_BIN_DIR", bin_dir)
|
|
monkeypatch.setattr(
|
|
"subprocess.run",
|
|
lambda *a, **kw: mock.MagicMock(
|
|
stdout="",
|
|
stderr=("/opt/llama.cpp/bin/llama-completion: error while "
|
|
"loading shared libraries: libllama.so.0: cannot open "
|
|
"shared object file: No such file or directory"),
|
|
returncode=127,
|
|
),
|
|
)
|
|
args = argparse.Namespace(backend="llamacpp", model=None)
|
|
rc = cli._run_selftest(args)
|
|
assert rc == 2
|
|
out = capsys.readouterr().out
|
|
assert "can't launch" in out
|
|
assert "LD_LIBRARY_PATH" in out or "ldconfig" in out
|
|
# Must NOT mistakenly blame --jinja
|
|
assert "--jinja missing" not in out
|
|
|
|
|
|
def test_run_selftest_detects_windows_dll_error(tmp_path, monkeypatch, capsys):
|
|
"""Same root cause on Windows: DLLs not on PATH → empty --help, code
|
|
0xc0000135. Selftest gives the right remediation per OS."""
|
|
bin_dir = tmp_path / "bin"
|
|
bin_dir.mkdir()
|
|
for tool in ("llama-cli", "llama-completion",
|
|
"llama-tokenize", "llama-perplexity"):
|
|
(bin_dir / tool).write_text("")
|
|
monkeypatch.setattr("refract.runner.DEFAULT_BIN_DIR", bin_dir)
|
|
monkeypatch.setattr(
|
|
"subprocess.run",
|
|
lambda *a, **kw: mock.MagicMock(
|
|
stdout="",
|
|
stderr=("The application failed to start because llama.dll was "
|
|
"not found. Error 0xc0000135."),
|
|
returncode=3221225781, # 0xc0000135
|
|
),
|
|
)
|
|
args = argparse.Namespace(backend="llamacpp", model=None)
|
|
rc = cli._run_selftest(args)
|
|
assert rc == 2
|
|
out = capsys.readouterr().out
|
|
assert "can't launch" in out
|
|
assert "PATH" in out # Windows hint mentions adding bin dir to PATH
|
|
|
|
|
|
def test_run_selftest_launch_succeeds_then_jinja_check_runs(tmp_path, monkeypatch, capsys):
|
|
"""When binary launches OK + --jinja in help → success path."""
|
|
bin_dir = tmp_path / "bin"
|
|
bin_dir.mkdir()
|
|
for tool in ("llama-cli", "llama-completion",
|
|
"llama-tokenize", "llama-perplexity"):
|
|
(bin_dir / tool).write_text("")
|
|
monkeypatch.setattr("refract.runner.DEFAULT_BIN_DIR", bin_dir)
|
|
monkeypatch.setattr(
|
|
"subprocess.run",
|
|
lambda *a, **kw: mock.MagicMock(
|
|
stdout="usage: ...\n--jinja apply chat template\n",
|
|
stderr="", returncode=0,
|
|
),
|
|
)
|
|
args = argparse.Namespace(backend="llamacpp", model=None)
|
|
rc = cli._run_selftest(args)
|
|
out = capsys.readouterr().out
|
|
assert "--jinja chat template flag supported" in out
|
|
# No misleading launch-failure message
|
|
assert "can't launch" not in out
|
|
|
|
|
|
def test_run_repeatability_noisy_label(tmp_path, monkeypatch, capsys):
|
|
"""Composite stdev between 1.0 and 3.0 → NOISY warning, not unstable."""
|
|
_patch_backends(monkeypatch)
|
|
seq = iter([90.0, 92.0, 90.0, 92.0]) # stdev ~1.15
|
|
|
|
def fake_run_score(args):
|
|
rep = {"composite": next(seq),
|
|
"axes": {"gtm": {"score": 90.0}, "kld": {"score": 90.0}}}
|
|
args.json_out.write_text(json.dumps(rep))
|
|
return 0
|
|
|
|
monkeypatch.setattr(cli, "_run_score", fake_run_score)
|
|
args = argparse.Namespace(
|
|
model=tmp_path / "m.gguf",
|
|
reference="ctk=f16,ctv=f16", candidate="ctk=q8_0,ctv=q8_0",
|
|
prompts=tmp_path / "p.jsonl", corpus=tmp_path / "c.txt",
|
|
runs=4, n_predict=8, ctx=512, chunks=32, n_gpu_layers=99, seed=42,
|
|
axis_a="trajectory", full=False,
|
|
rniah_haystack=None, rniah_ctx_max=None,
|
|
backend="auto", out_dir=tmp_path / "out",
|
|
)
|
|
rc = cli._run_repeatability(args)
|
|
assert rc == 0
|
|
assert "NOISY" in capsys.readouterr().out
|