WUT_Computer_Science/DOCS-runnability.md
Krzysztof kuhy Rudnicki bd24dd57ea Hold the coursework to the same lint bar as the tooling
kuhy overruled the "do not fix coursework to be better than it was submitted"
rule: git history is the archive, so the working tree can be clean. This lands
the config and the mechanical half of the cleanup -- 9,281 ruff findings under
the fleet config down to 3,686, with no per-file-ignores anywhere.

What is in here:

- pyproject.toml, the first one in this repo. select = ["ALL"], mypy strict,
  and the vendored list mirrored into ruff exclude and coverage omit. Five
  rules are off and each says why; CPY001 is the only judgement call, because
  stamping a copyright header onto 137 university assignments would assert a
  licence that was never claimed. No hook is wired up yet -- a gate lands only
  once its subject is clean.

- ruff format + the safe fixes, then a second pass over the docstring rules
  ruff marks unsafe (they only edit docstring text). 108 files.

- TRAK/sightpy is vendored, not coursework: it is rafael-fuente/Python-Raytracer
  (BSD 3-Clause). Verified against a fresh upstream clone with line endings
  normalised -- 30 of 32 files byte-identical, ray.py and scene.py carrying a
  12- and 13-line local patch that counts rays for the report. 35 files that
  should never have been linted, now excluded and restored.

- WDWR, SPD, MOM and ECRYPT are fully clean, by hand and verified by running
  them: WDWR's three plot scripts print the same statistics as before, MOM's
  PuLP model solves to the same cost. WDWR's graph.py had a 342-character CSV
  header embedded as a string literal, which cannot be wrapped -- the data
  moved to data/pareto_front.csv. Two 0-byte .py stubs are deleted; an empty
  file is not a deliverable and git still has it.

Three harness bugs found by actually running things:

- `run` now forces MPLBACKEND=Agg. TRAK finished its ray trace in 37 seconds
  and then sat for 45 minutes: plt.show() had opened an image viewer and was
  waiting for someone to close the window.
- TRAK's main.py only pops that viewer with --show now, and its runner writes
  to a gitignored build/ via the new --entry-args. The default output path is
  outputs/output.png, which is TRACKED -- a plain run overwrote a submitted
  deliverable.
- course_lib.sh was 357 lines, over this repo's own cap. Split into
  course_probe.sh and course_run.sh.

Verified: ECOTE 26 tests pass, ECRYPT_PROJECT 99 pass, TRAK renders
cornell_box in 37s and exits 0, every module compiles, and every import ruff
removed was checked to be genuinely unused.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0172dj34FDpao6wsix8ZuCzE
2026-08-28 19:53:04 +02:00

59 lines
3.8 KiB
Markdown

# Runnability
Generated by `./run.sh status`. Do not edit by hand.
Status is recorded PER ENVIRONMENT, from `gates/runnability-local.tsv` and
`gates/runnability-ci.tsv`. A directory that is `runnable` locally and
`blocked` in CI is the normal case, not drift: the runner has no MATLAB, no
Unity and no .NET SDK. Each environment rewrites only its own file, so a CI
run cannot clobber the local column.
`-` means that environment has not probed yet.
| Course | local | ci | Detail (local) |
|---|---|---|---|
| `NotProgramming/DPZ` | runnable | - | builds the report with latexmk |
| `NotProgramming/ECOGR` | runnable | - | builds the report with latexmk |
| `NotProgramming/EDABA` | runnable | - | builds the report with latexmk |
| `NotProgramming/EDABA-LAB` | runnable | - | builds the report with latexmk |
| `NotProgramming/EDISE` | runnable | - | builds the report with latexmk |
| `NotProgramming/EDISP` | no-code | - | submitted lab reports as PDFs only; no source was produced |
| `NotProgramming/ELAC` | runnable | - | builds the report with latexmk |
| `NotProgramming/EMISY` | runnable | - | builds the report with latexmk |
| `NotProgramming/ENUME` | blocked | - | needs MATLAB or Octave (none of: matlab octave) |
| `NotProgramming/EPHY2` | no-code | - | submitted lab reports as PDFs only; no source was produced |
| `NotProgramming/EPOGAI` | no-code | - | a presentation only; no source was produced |
| `NotProgramming/ERPM` | runnable | - | builds the report with latexmk |
| `NotProgramming/ESDP1` | runnable | - | builds the report with latexmk |
| `NotProgramming/ESOEN` | runnable | - | builds the report with latexmk |
| `NotProgramming/MOM` | runnable | - | builds the report with latexmk |
| `NotProgramming/SDM` | runnable | - | builds the report with latexmk |
| `NotProgramming/SDM2` | runnable | - | builds the report with latexmk |
| `NotProgramming/SPD` | runnable | - | builds the report with latexmk |
| `NotProgramming/STUP` | runnable | - | npm install && npm start |
| `Programming/AIS` | runnable | - | builds the report with latexmk |
| `Programming/BD2` | runnable | - | npm install && npm start |
| `Programming/BSS` | runnable | - | builds the report with latexmk |
| `Programming/EADS` | runnable | - | compiles each standalone .cpp |
| `Programming/EARIN` | runnable | - | python3 the entry script |
| `Programming/ECOAR` | runnable | - | make |
| `Programming/ECOTE` | runnable | - | python3 /home/kuhy/WUT_Computer_Science/Programming/ECOTE/program/translator/main.py |
| `Programming/ECRYPT` | no-code | - | test1.py is a 0-byte stub; this course produced no submitted code |
| `Programming/ECRYPT_PROJECT` | runnable | - | python3 the entry script |
| `Programming/EGUI` | runnable | - | dotnet build |
| `Programming/EOOP` | runnable | - | compiles each standalone .cpp |
| `Programming/EOPSY` | runnable | - | make |
| `Programming/EPFU` | runnable | - | make |
| `Programming/E-PSYOPS` | runnable | - | opens in the Unity editor |
| `Programming/ERSMS-project` | runnable | - | docker compose up |
| `Programming/NLP` | runnable | - | python3 the entry script |
| `Programming/PBAD` | blocked | - | jupyter is on PATH but broken (bad interpreter) |
| `Programming/PORR` | runnable | - | python3 /home/kuhy/WUT_Computer_Science/Programming/PORR/code/main.py |
| `Programming/PSD` | runnable | - | starts the Kafka/Flink stack (installs packages with sudo) |
| `Programming/psd_project` | runnable | - | mvn package |
| `Programming/TRAK` | runnable | - | python3 /home/kuhy/WUT_Computer_Science/Programming/TRAK/main.py |
| `Programming/twm_4` | blocked | - | jupyter is on PATH but broken (bad interpreter) |
| `Programming/USD` | no-code | - | README describes a MetaDrive RL assignment; no implementation was submitted |
| `Programming/WDWR` | runnable | - | python3 the entry script |
| `Programming/ZPOB` | runnable | - | builds the report with latexmk |