WUT_Computer_Science/Programming/ECOTE/finalReport/sections/04-unit-tests.tex
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

23 lines
1.9 KiB
TeX

\section{Unit tests}
There are over 12 unit tests for program functions, all of them can be ran by using python test environment:
\begin{lstlisting}
python -m pytest unit_tests
collected 12 items
unit_tests/test_code/test_begin_document.py . [ 8%]
unit_tests/test_code/test_begin_tabular.py . [ 16%]
unit_tests/test_code/test_document_class.py . [ 25%]
unit_tests/test_code/test_length_conversions.py . [ 33%]
unit_tests/test_code/test_only_pipes_and_space.py . [ 41%]
unit_tests/test_code/test_split_columns.py . [ 50%]
unit_tests/test_code/test_split_rows.py . [ 58%]
unit_tests/test_code/test_tabular_columns_parameters.py . [ 66%]
unit_tests/test_code/test_tabular_parameters.py . [ 75%]
unit_tests/test_code/test_tabular_required_parameters.py . [ 83%]
unit_tests/test_code/test_translate_column.py . [ 91%]
unit_tests/test_code/test_translate_inside_to_html.py . [100%]
===================================================== 12 passed in 0.02s ======================================================
\end{lstlisting}