[rtibblesbot]

Summary

• file_formats and js/FileFormats.js are generated from one spec, replacing the hand-maintained module and partial JSON lookup.
• Snapshot test pins the public API of the five legacy constants modules.
• Seven mimetypes that were extensions or non-standard types are corrected.
• getformat honours its default.
• Kolibri, Studio and ricecooker checked against the corrected mimetypes: none needs a change, so no follow-up issues.

References

Closes #182. Part of #181.

Reviewer guidance

Suggested review: Full code review, then manual QA once the reviewer sets Needs QA.

• User-visible files changed: js/FileFormats.js.
• Confirm downstream can take the mimetype changes: Studio's loadconstants writes them into stored FileFormat.mimetype rows, Kolibri's mp3/zip object[type=…] selectors become audio/mpeg/application/zip, and ricecooker loses its image/svg → svg mapping.
• Confirm Migrate licenses.py to spec + code generation #183–Migrate languages.py to spec + code generation #186 should copy this generator shape: it hard-codes an id field (record["id"], r.id) and one generate_list body (X(id=id, **record)), but Language has no id field and License is built differently.
• Confirm application/x-graphie should stand: no registry entry or Kolibri mapping backs it.

Commits run pin → migrate (snapshot unchanged) → correct (snapshot diff is only the seven mimetypes).

AI usage

Used Claude Code to write the generator, spec, snapshot test and corrections, and to trace the Kolibri, Studio and ricecooker consumers. Verified with the full test suite, make build idempotence, and prek.

🤖 Generated with Claude Code

Deviations from the issue spec

Criterion	Why not
h5p gets an IANA, x- or vendor type	Review asked for application/h5p+zip, matching the other +zip formats and Kolibri's mimetypes.js

---

Written by rtibblesbot, an LLM-based coding agent.

🟡 Waiting for feedback Last updated: 2026-10-25 17:58 UTC

[rtibbles]

Two mimetype changes needed. Neither type is IANA-registered, so pick values that match existing conventions:

• h5p → application/h5p+zip. This matches how we handle other zip files with custom extensions (perseus+zip, bloompub+zip, kpub+zip), and Kolibri's packages/kolibri/utils/mimetypes.js already maps it to h5p.
• zim → application/x-openzim. That's the type freedesktop shared-mime-info registers for *.zim.

Update the spec, regenerated files, tests/pinned_api.json, the CHANGELOG and the PR description to match.

[rtibbles]

Use application/h5p+zip here, to match the other zip-based formats with custom extensions and Kolibri's existing mimetypes.js mapping.

[rtibblesbot]

Changed to application/h5p+zip in 01ff28e: spec, generated Python/JS, tests/pinned_api.json, CHANGELOG, PR description. Searched for other invented x- types: only graphie (application/x-graphie) remains, left as-is since it is not a zip with a custom extension.

[rtibbles]

Use application/x-openzim here. It's the freedesktop shared-mime-info type for *.zim.

[rtibblesbot]

Changed to application/x-openzim in 01ff28e, with the same files updated.