WUT_Computer_Science/Programming/ECOTE
Krzysztof kuhy Rudnicki ffa5dad02a Split 19 over-cap LaTeX reports, proving each PDF is unchanged
The 250-line cap applies to prose too, and the reports were the worst
offenders -- ENUME's projectA.tex alone was 1,876 lines. Each is now a
preamble plus one \input{} per section, which is how a long LaTeX document is
normally organised; not one byte of prose was rewritten.

"The PDF is unchanged" is checked by a script rather than by eye, because
hashing the PDF cannot work: pdflatex stamps a /CreationDate and an /ID into
every build, so two runs of the SAME source already differ. tex_fingerprint.sh
compares what a reader sees instead -- page count plus a hash of the extracted
text -- and it is stable across rebuilds of untouched sources, which is the
property that makes it usable as a gate.

It earned its keep immediately. Both ECOTE reports quote an example LaTeX
document inside an lstlisting block, so \end{document} appears in the middle
of the file; splitting on the FIRST one stranded everything after it. Same
page count, different text, caught automatically. EOPSY lab3 exposed a second
bug: a \section{} title that runs onto the next line.

Result: 19 .tex over the cap -> 1. The survivor,
ELAC/.../03-building-nfa-...tex, is 418 lines of consecutive tikz figures
with no subsection to split on and needs a hand-placed boundary.

Verified: 29 splits across two passes (section, then subsection for the
pieces still over), every one reporting `unchanged` from
scripts/tex_fingerprint.sh --check.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0172dj34FDpao6wsix8ZuCzE
2026-08-28 19:47:12 +02:00
..
examples feat: move ECOTE 2023-06-16 10:59:29 +02:00
finalReport Split 19 over-cap LaTeX reports, proving each PDF is unchanged 2026-08-28 19:47:12 +02:00
helpfulMaterials feat: move ECOTE 2023-06-16 10:59:29 +02:00
preliminaryReport Split 19 over-cap LaTeX reports, proving each PDF is unchanged 2026-08-28 19:47:12 +02:00
program Gate the invariants, fix ECOTE's unrunnable tests, contain build output 2026-08-28 18:43:13 +02:00
README.md Organise markdown into the four namespaces and add CLAUDE.md 2026-08-28 17:41:11 +02:00
run.sh Run all 33 safe courses; fix what that broke 2026-08-28 18:52:31 +02:00

ECOTE — Compilation Techniques

A translator that converts LaTeX tabular environments into HTML tables, written for the ECOTE (Compilation Techniques) course.

Path What it is
program/code/ The translator. Entry point is main.py.
program/unit_tests/test_code/ 17 pytest modules covering the lexer, parser and emitter.
preliminaryReport/ The design document submitted before implementation.
finalReport/ The final report.

See program/README.md for how to run it and the test suite.

This file previously held a stale copy of the repository root README, describing the group projects as not included. They have been merged in since (see the root README.md), and this directory is about ECOTE.