Repository navigation
Module c64_test_harness missing when running UCI test scripts #90
Description
After building with 'make BACKEND=uci', running any of the UCI test scripts results in the following error:
$ python3 tools/uci/test_http_local.py
Traceback (most recent call last):
File "/Users/armitage/git/c64-https/tools/uci/test_http_local.py", line 29, in
from c64_test_harness import Labels
ModuleNotFoundError: No module named 'c64_test_harness'
Activity
JC-000 commentedon Aug 14, 2026
Thanks for the report — this is a gap in our docs rather than anything wrong with your build.
c64_test_harnessis a separate public package, not vendored into this repo.requirements.txthere carries onlycryptography, which is why nothing hinted the dependency was missing:git clone https://github.com/JC-000/c64-test-harness # as a sibling of c64-https pip install -e ../c64-test-harnessFrom your traceback that would be
/Users/armitage/git/c64-test-harness, alongside/Users/armitage/git/c64-https.One detail worth stating explicitly, since you invoked plain
python3: install it into the same interpreter you run the scripts with. Ifpython3resolves to a virtualenv butpipdoesn't (or vice versa), you get this identicalModuleNotFoundErrorafter an install that looked like it succeeded.python3 -m pip install -e ../c64-test-harnessavoids that by construction.Why you hit this
The instruction did exist, at README.md:155 — but inside the general VICE testing section. The "Ultimate 64 Elite Hardware Tests" section goes straight from
make BACKEND=ucito invokingtools/uci/scripts and never mentions it, so following the UCI path meant never crossing the line that would have told you. Your report is the second in an hour of that exact shape (the other wasip65-c64.binmissing on a fresh clone), so it is a pattern worth fixing rather than a one-off.PR #91 adds the prerequisite to both UCI sections — README and CLAUDE.md — including the traceback text so searching for the error finds the fix, and the interpreter caveat above.
Once it's installed,
tools/uci/scripts need a reachable Ultimate 64 Elite; setU64_HOSTif yours isn't at the192.168.1.81default. If you're only after the emulator suites, those need no hardware —python3 tools/run_all_tests.pycovers 11 suites under VICE.Merge pull request #91 from JC-000/docs/uci-test-prereqs
docs: one-time prerequisites block at the top of the README