示例

Swap json for orjson on Alpine, without the wheel surprise or the silent output changes

sha256:84dc3de1142d9942eb7c819b260089b9174ebd77f0213fd16a72c9f0640eb35e

案例

目标

Swap json for orjson on Alpine, without the wheel surprise or the silent output changes MIGRATION

包

orjson 3.11.9

环境

python 3.12

创建时间

2026-08-14T08:53:26Z

契约

• assert pip took the musllinux wheel, orjson-3.11.9-cp312-cp312-musllinux_1_2_x86_64.whl, reconstructed from the recorded dist-info tag
• assert the distribution is a compiled extension, not pure Python, whose filename is this interpreter's own EXT_SUFFIX, and declares no runtime dependencies of its own
• assert the extension needs exactly one library, libc.so, and no file of that name exists under any directory the loader searches
• assert musl's loader resolves that name to itself, which is the only reason the extension imports
• assert no CPython library is linked, so the Py symbols are resolved from the interpreter that imports it
• assert the same ELF reader finds the versioned musl soname and libpython in the interpreter binary, so the reading is real
• assert the interpreter itself reports musl, with musl's loader present and glibc's absent
• assert orjson.dumps returns bytes where json.dumps returns str, with no separator spaces and no \uXXXX escaping
• assert OPT_INDENT_2 puts the space after the colon back and matches json.dumps(indent=2) byte for byte
• assert there is no orjson.dump or orjson.load, so writing to a file is the caller's job
• assert datetime, date, time and UUID serialize natively as RFC 3339 with +00:00 unless OPT_UTC_Z, where json raises TypeError
• assert orjson accepts default as its second positional argument and json.dumps refuses a positional there, the reverse of the usual warning
• assert every other json.dumps keyword is a TypeError, and sort_keys is instead option=OPT_SORT_KEYS with the same code point ordering
• assert orjson.JSONEncodeError is builtins.TypeError itself while JSONDecodeError is a real subclass of json.JSONDecodeError
• assert non-str dict keys raise unless OPT_NON_STR_KEYS, while json coerces them silently and loses a value when two keys collide
• assert nan and infinity serialize as null with the default hook never consulted, while json emits tokens orjson then refuses to read back
• assert a walk over the payload finds the non-finite floats orjson will not report
• assert a non-finite Decimal raises instead of vanishing, until a default hook floats it and it becomes null too
• assert integers outside -2**63 through 2**64-1 raise where json prints them

文件

• csx.json
• requirements.txt
• src/__init__.py
• src/serialize.py
• src/wheel.py
• test/contract.py

原始种子者

anonymous

验证回执

• python 3.12 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · pypi@1 · 2026-08-14 · ed25519:a2ec939a4c60e243
• · CONTAINER_RUN · compile:SKIPPED · contract:FAIL · load:SKIPPED · resolve:PASS · pypi@1 · 2026-08-14 · ed25519:7da3f610facce8bf