Files

3.5 KiB

Original-encoder compatibility corpus

These five archives were made with UC2 Pro 2.3 in DOSBox-X from the payloads in tests/corpus/. They exercise the actual original encoder. They were generated for this project, not collected in the 1990s.

manifest.json pins every archive, every decoded payload, and the original encoder distribution by SHA-256. The payloads and fixtures are distributed under the repository's GPL-3.0-or-later license. The original DOS executable is not part of the browser bundle or Python source distribution.

The corpus covers text, binary data, an empty file, repeated zeros, and a multi-file archive with master blocks. Python migration tests decode these archives, compare each file hash to its known payload, then reopen both ZIP and tar exports and compare their contents. Browser tests use the same archives and compare downloaded files with the native reader.

Additional Turbo/method 80, SAS and UC2SEA fixtures are described below. tests/scripts/create_archives.sh documents the original fixture-generation procedure; regeneration changes archive timestamps and requires reviewing and updating the pinned hashes.

Historical collections

historical.json includes three independently sourced archives from the Sembiance format samples: BLKTXT.UC2, MKMSG.UC2 and UC2INFO.UC2. Their 88 entries carry DOS timestamps from 1993-1995. Both ZIP and tar migrations passed on November 7, 2026. All decoded file sizes and SHA-256 hashes also match the independent Go decoder at commit 53622f89ada1cf0d4a69f91b653bdd44ec5b0f92, with ASCII filename case normalized.

The repository distributes URLs, hashes and expected metadata for these archives. Their third-party payloads are downloaded separately because their redistribution permissions have not been established. Nothing from these archives is executed. The Go project's pinned sample list supplied the URLs; the JSON records exact provenance and hashes.

Run the optional network check with an installed UC2 package:

python tests/scripts/check_historical.py --cache /tmp/uc2-historical

The five bundled original-encoder archives form the basic offline CI corpus.

Turbo fixtures turbo0.uc2 and turbo1.uc2 are generated format fixtures, with SuperMaster and NoMaster respectively. Their original-DOS and independent Go output checks are pinned in turbo.json. They are not historical captures or original-encoder output. test_turbo covers 18 length/master combinations and malformed block/literal/terminator/output-bound cases.

The optional historical.json corpus now covers 39 archives and 684 entries: 13 historical collections, four unarc-rs test archives, and 22 original-DOS encoder oracle archives from the pinned Go repository (revisions 2, 2.3 and 2.37b; long names, revisions, delta methods and damage protection). All file sizes and SHA-256 hashes agree with that independent decoder. External bytes are fetched separately; only provenance and expected metadata/hashes ship here.

sas/ contains three original SAS 2.3 split parts of the generated Turbo fixture. The original SAS B SPLIT tool reassembled them byte for byte. Their manifest records hashes and provenance. Native reads reassemble these parts directly in alpha10. The sea/ fixtures preserve original UC2SEA compressed records under a synthetic envelope without the restricted executable stub; their manifest records payload and part hashes.