[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 application/x-graphie is the intended type: IANA was never checked, and Kolibri's object[type=…] selectors and Studio's associated_mimetypes read mimetype.
• Confirm the generator's fixed generate_list body (X(id=id, **record)) and r.id lookup are what Migrate licenses.py to spec + code generation #183–Migrate languages.py to spec + code generation #186 should extend: Language has no id field, and licenses parse their ids differently.
• Confirm downstream can absorb these changes: resources/formatlookup.json is deleted, Kolibri's mp3/zip selectors become audio/mpeg/application/zip, and ricecooker loses its image/svg → svg mapping.

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

---

Written by rtibblesbot, an LLM-based coding agent.

⚪ Updating PR Last updated: 2026-10-24 16:45 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.