# ujson と simplejson のローカルJSON読み書き実測

依頼: req-20261022-065 / 題材ID: ujson-simplejson-local-hikaku
測定日: 2026-11-18（Asia/Tokyo）。UTCの実行開始・終了時刻は raw.json に保存した。

## 実行できるか

このMacのworkspace-write砂場で両方をCPU実行でき、値の一致・書き出し・読み込み・処理時間の比較軸が成立した。
ujson 6.1.0 と simplejson 4.3.0 の実際のAPIを呼んだ。インターネットの速度表は実測の根拠にしていない。
公開PyPIのwheel取得以外の通信は測定に不要。鍵・秘密鍵ファイル・ログイン・有料API・買い物は使っていない。
権限の拡張、公開、X投稿、git commitは行っていない。public/配下は保存先であり、配信処理はしていない。

## 環境とCPU実行

macOS 27.2.1 / arm64 / CPython 3.14.10（通常のGIL版）/ 論理CPU数12。
独立したpipなしvenvに固定版の公開wheelを展開し、`-I -B` の子プロセスで測定した。
ujsonのネイティブ拡張とsimplejsonのC拡張が存在することを確認した。両者の版と拡張ファイル名は raw.json の environment にある。
simplejsonのCエンコーダー・スキャナーが利用可能な状態で、通常の公開APIを使った。
CPU用のJSON APIのみで完結する。GPU選択機能のある推論フレームワークを導入・importせず、Metalを初期化する呼び出しもない。
GPU、音声入出力、macOS say、Bluetoothは使っていない。CPU製品名やMacの機種名は取得・推定していない。

## 人工入力

入力生成の完全なコードは replay.txt の corpus() にある。外部データ・乱数・利用者のファイルは入力にしていない。
入力はPythonのメモリ内で生成する。WAV・画像・モデル・入力ファイルは使わない。

- dict10 / dict1000 / dict10000: records配列を持つ入れ子辞書。それぞれ10 / 1,000 / 10,000件の自作レコード。
  日本語・英字・絵文字・アクセント文字・引用符・逆斜線・改行・タブ・スラッシュ・HTML風文字列、整数、有限小数、真偽値、null、空辞書・空配列を含む。
- array10 / array1000 / array100000: トップレベルの数値配列。長さ10 / 1,000 / 100,000。
  小整数と1/8刻みの有限小数を決定的に配置した。

小数は二進数で正確に表せる値に限定した。dict入力には負のゼロも含めた。
標準jsonで `ensure_ascii=False, allow_nan=False, separators=(',', ':')` にした同一のstrを読み込み入力として使う。
各入力のUTF-8バイト数とSHA256は cases[] に残した。文字コード変換は計時しない。

## API・試行・計時範囲

- encode: 同一のPythonオブジェクトを dumps し、strを返す。
- decode: 同一の標準json製strを loads する。
- roundtrip: 同一の元オブジェクトに対して `loads(dumps(obj))` を行う。

両者のdumpsで `ensure_ascii=False, separators=(',', ':')` を指定する。
ujsonには `escape_forward_slashes=False`、simplejsonには `allow_nan=False` を指定した。
loadsは既定設定。キーのソート・インデント・Decimal・型指定・スキーマ検証は使っていない。
有限数の有効JSONに範囲を絞っているため、非有限数に対する既定動作の違いは比較していない。

同じ入力・操作の両ツールでループ回数をそろえた。各条件で1バッチのウォームアップ後、7バッチを取得した。
同じ条件内で試行ごとにツール順を交互にし、条件ごとの開始ツールも交互にした。
全252測定バッチと、集計から除いた36ウォームアップバッチを保存した。
perf_counter_ns（mach_absolute_time）で整数nsを記録した。循環GCはバッチ前に回収し、計時中だけ停止した。
通常の参照カウントによる結果解放は各呼び出しの直後に行う。

計時に含む: Pythonループとラッパー、API呼び出し、メモリ割当、結果の解放。
計時から除外: wheel取得・照合、venv作成、import、人工入力生成、値の検証、ハッシュ計算、保存、ディスクI/O。
独立した1回ごとのレイテンシーやディスクからのJSON読み込み速度を測ったものではない。

## 値の一致

全6入力・両ツールで、以下の確認が計時前と計時後にすべて通った。

- 共通strをloadsした値と元データの一致。
- dumpsしたstrを標準jsonで読んだ値と元データの一致。
- 同じツールでdumps→loadsした値と元データの一致。
- 一方でdumpsしたstrを他方でloadsした値と元データの一致。

単純なPythonの `==` だけにせず、入れ子の型と値を再帰的に確認した。
intとbool、intとfloatの違い、負のゼロの符号も確認対象。辞書のキー順は一致条件に含めない。
両ツールの書き出し文字列はこの6入力ではUTF-8バイトでも一致した。出力の長さ・SHA256を cases[] に保存した。
dict10・array10の両ツールの実際の出力も、それぞれJSONとして残した。
これは人工入力内の一致であり、全JSON仕様への適合、実業務の品質・精度を測ったものではない。

## 処理時間

各行は7試行の**バッチ全体の時間の中央値（整数ns）**。両ツールで1バッチ内の回数は同じ。
1呼び出し当たりの参考平均時間が必要なら、バッチnsを回数で割る。バッチで平均化した値と単発の遅延は区別する。
入力バイト数は共通strをUTF-8にした場合のサイズである。

| 入力 | 入力UTF-8 bytes | バッチ内回数 | 操作 | ujson 中央値 ns/バッチ | simplejson 中央値 ns/バッチ |
|---|---:|---:|---|---:|---:|
| dict10 | 2,725 | 1500 | encode | 21,768,250 | 66,352,250 |
| dict10 | 2,725 | 1500 | decode | 22,785,000 | 34,074,000 |
| dict10 | 2,725 | 1500 | roundtrip | 47,427,333 | 102,596,667 |
| dict1000 | 270,909 | 25 | encode | 45,120,084 | 103,284,875 |
| dict1000 | 270,909 | 25 | decode | 41,547,875 | 64,928,250 |
| dict1000 | 270,909 | 25 | roundtrip | 116,621,292 | 237,327,000 |
| dict10000 | 2,758,196 | 3 | encode | 67,399,375 | 163,430,292 |
| dict10000 | 2,758,196 | 3 | decode | 60,979,416 | 117,700,458 |
| dict10000 | 2,758,196 | 3 | roundtrip | 114,404,959 | 232,193,584 |
| array10 | 66 | 10000 | encode | 11,507,708 | 47,994,917 |
| array10 | 66 | 10000 | decode | 4,505,333 | 13,801,375 |
| array10 | 66 | 10000 | roundtrip | 18,214,542 | 59,341,125 |
| array1000 | 4,892 | 300 | encode | 11,353,333 | 44,570,875 |
| array1000 | 4,892 | 300 | decode | 13,450,750 | 24,468,708 |
| array1000 | 4,892 | 300 | roundtrip | 37,890,167 | 103,519,083 |
| array100000 | 488,837 | 3 | encode | 19,651,625 | 62,754,000 |
| array100000 | 488,837 | 3 | decode | 12,890,334 | 35,057,375 |
| array100000 | 488,837 | 3 | roundtrip | 27,613,333 | 72,437,084 |

この実行では全18条件でujsonの中央値が小さかった。速度の結論はこのMac・版・設定・人工入力・実行時に限る。
全試行の整数生値は trials[]、その同じ生値を条件ごとに並べたものは series[] にある。
summary は便宜的な集計であり、台帳のassertionからは参照しない。
台帳は全252バッチ・48件の計時後の一致確認・6件の入力サイズを identity / tolerance=0 で参照する。
36件の中央値は series[].elapsed_ns[] を median で再計算し、displayedはrounding=0の整数文字列、tolerance=0.5とした。
7試行なので今回の中央値は実際の試行値の1つであり、数値を作り足していない。

## 限界・未測定

外部推論・AIの出力品質は測っていない。実業務の品質・精度、任意のJSONの互換性も評価していない。
任意精度整数、Decimal、日時、非有限数、無効JSON、重複キー、極端な深さ、循環参照、エラー処理は未測定。
1/8刻み以外の浮動小数点表現・丸めの網羅的評価はしていない。
ストリーミング、ファイル読み書き、文字コード変換、ピークメモリ、起動・import・導入時間、並列実行、別OS・別CPU・別Pythonは未測定。

OSのスケジューリング、他プロセス負荷、CPU周波数、温度、キャッシュは固定していない。
load averageの開始・終了値はenvironmentに記録した。各条件の最小・最大値もsummaryにある。
同一プロセス内の7バッチによるウォーム状態の比較であり、再起動をまたぐ分散や統計的有意差は評価していない。
小さい入力ではPythonループ・ラッパー・メモリ管理の割合が大きい。

## 再実行と一時領域

```sh
python3 measurements/ujson-simplejson-local-2026-11-18-req065-a1-replay.txt --output-dir /tmp/ujson-simplejson-rerun-new
```

通常のGIL版CPython 3.14・macOS arm64を対象とする。既存の出力先は拒否する。
初回と同じ固定URL・版・SHA256・取得サイズは replay.txt の WHEELS にある。
公開PyPIのメタデータで得たSHA256・サイズを、実際にダウンロードしたwheelのバイトと照合した。
URL・取得時刻・実際のSHA256とバイト数は dependencies.json に残した。追加依存やpipは使わない。

wheel・venv・測定ワーカーの作業領域は、作業コピー外の `TemporaryDirectory(dir='/tmp')` に作り、終了時に削除する。
ワーカーが成功した後でだけ、生成結果を指定した新規出力ディレクトリへ保存する。
入力生成と再実行コードはTXTで保存し、台帳の編集処理を含めない。
再実行すると同じ人工入力と検査条件を再現するが、処理時間は実行時の条件によって変わる。
READMEは今回の測定報告であるため、再実行コードは今回のREADMEを自動コピーしない。

## 保存物と台帳

- `*-raw.json`: 環境、設定、入力・出力hash、値と型の検証、全試行、ウォームアップ、生値の条件別配列、集計。
- `*-dict10-ujson-output.json` / `*-dict10-simplejson-output.json`: 小サイズ辞書の実出力。
- `*-array10-ujson-output.json` / `*-array10-simplejson-output.json`: 小サイズ配列の実出力。
- `*-dependencies.json`: 公開wheelの来歴と照合結果。
- `*-run-log.txt`: 成功した測定ワーカーの標準出力。
- `*-replay.txt`: 完全な入力生成・取得・CPU実測・再実行コード。
- `*-README.md`: 今回の測定範囲・結果・限界。

以上9ファイルを measurements/ と public/measurements/ に同じバイトで新規保存する。
台帳は topics.ujson-simplejson-local-hikaku の1項目だけを登録し、raw_sha256にpublic側の全9ファイルの実際のSHA256を入れる。
公開・commitは親の担当であり、この作業では実施していない。

## 公式資料

APIの確認先（2026-11-18確認）。公式サイトの速度数値は転載していない。

- [ujson公式リポジトリ](https://github.com/ultrajson/ultrajson): dumps / loads、ensure_ascii、escape_forward_slashes。
- [ujson公式型定義](https://github.com/ultrajson/ultrajson/blob/main/ujson-stubs/__init__.pyi): separatorsとstrの入出力。
- [simplejson公式リポジトリ](https://github.com/simplejson/simplejson): ローカルPython実装とC拡張。
- [simplejson公式ドキュメント](https://simplejson.readthedocs.io/en/latest/): dumps / loads、ensure_ascii、separators。
