# PyYAML と ruamel.yaml のローカルYAML読み込み実測

依頼 req-20261022-065 / 題材 pyyaml-ruamel-yaml-local-hikaku / 測定日 2026-11-19（Asia/Tokyo）。
実行開始・終了UTCは raw.json の started_utc / ended_utc に記録。

## 実測できるか

このMacのworkspace-write砂場で両方をCPU実行でき、同じ単純なYAMLの値・型の一致と読み込み時間を比較できた。
公開wheelをPyPIから取得する以外、測定自体に通信は不要。公開の速度表は実測に転用していない。
鍵・秘密鍵ファイル・ログイン・有料API・買い物は利用していない。権限拡張・公開・X投稿・git commitは実施していない。
public/measurements/ は保存先のみであり、配信・デプロイはしていない。

## 環境と設定

macOS 27.2.1 arm64 / CPython 3.14.10（GIL版）/ 論理CPU12。
PyYAML 6.0.3 と ruamel.yaml 0.19.1 の固定wheelを照合し、pipなしの一時venvへ展開した。
CPUで動くPython YAML処理だけを使用。GPU推論フレームワークやMetalを初期化するコードはない。
GPU・マイク・スピーカー・macOS say・Bluetoothは使っていない。Mac機種名とCPU製品名は取得・推定していない。

PyYAML は `yaml.safe_load(text)`（`yaml.SafeLoader`、Python実装）。LibYAML拡張はwheelに含まれるが、このAPIでは使用しない。
ruamel.yaml は `YAML(typ='safe', pure=True).load(text)`。Parserが `ruamel.yaml.parser.Parser` であることも実行時に確認した。
ruamelのYAMLインスタンスは1回だけ構築して再利用する。インスタンス構築時間は含めないが、各load呼び出し内の処理は含む。
両者の純Python safe読み込みを比較する設定であり、C拡張を使う最速設定やruamel既定のround-tripモードの比較ではない。

## 人工入力・期待値

replay.txt の corpus() が入力と期待値を別々の構築手順で生成する。外部の利用者データは使わない。
10 / 100 / 1,000レコードのトップレベル配列。各レコードも配列で、文字列、整数、文字列配列、整数配列を含む。
値の型は `list`・`str`・`int` だけで、辞書、真偽値、null、小数は含まない。
日本語、絵文字、アクセント文字、空文字、引用符、逆斜線、改行、タブを含む。
`yes`・`on`・日付風・先頭ゼロ付きの文字列も、常に二重引用符で囲み曖昧な型解決を避ける。
整数は符号付きの十進表現とし、8進・16進などは使わない。

同じ意味の入力をYAMLのブロック形式とフロー形式で生成し、計6条件とした。
フロー形式はJSON互換の記法だが、両者ともJSON APIではなくYAML APIで読む。
各条件で完全に同じPython strを両者に渡す。入力UTF-8 bytes・SHA256はcases[]にある。
全6入力をTXT、全6期待値をJSON、全12実際の出力をJSONで保存した。
TXTはYAML本文の保存容器であり、拡張子に依存するAPIは使っていない。

## 計時と一致確認

各条件・各ツール1バッチのwarmup後に7バッチ。条件の開始ツールと試行内の順序を交互にした。
合計84測定バッチ、集計に含めない12 warmupバッチを保存した。
同一条件では両ツールのバッチ内読み込み回数をそろえた。
`perf_counter_ns()`（mach_absolute_time）で整数nsを取得。各バッチ前に循環GCを回収し、計時中のみ停止する。
参照カウントによる結果解放は各読み込み直後に実行する。

含む: Pythonループ、API呼び出し、解析、割り当て、結果解放。
除く: wheel取得、venv、import、YAMLインスタンスの初期構築、入力生成、値確認、hash計算、ファイルI/O。
ファイル読み込み速度・単発の独立レイテンシーを測ったものではない。

計時前後に、全条件の両ツールについて期待値との一致と相手側の出力との一致を検証した。
単純な `==` だけで済ませず、配列の全要素を再帰的にたどり `type(...) is ...` と値の両方を確認した。
全12出力で計時前後とも一致。保存した出力JSONも期待値と別途照合した。
これはこの人工入力の一致であり、任意のYAMLの互換性を意味しない。

## 処理時間

7試行の「バッチ時間 ÷ バッチ内回数 ÷ 1,000,000」の中央値。単位はms/読み込み。
バッチで平均化した1回当たりの値であり、単発レイテンシーの中央値とは異なる。

| 入力 | UTF-8 bytes | バッチ内回数 | PyYAML 中央値 ms/読み込み | ruamel.yaml 中央値 ms/読み込み |
|---|---:|---:|---:|---:|
| block10 | 896 | 10 | 0.9409 | 1.4055 |
| block100 | 9,250 | 2 | 9.2436 | 13.5925 |
| block1000 | 95,667 | 1 | 99.7279 | 157.8375 |
| flow10 | 478 | 10 | 0.9565 | 1.4552 |
| flow100 | 5,052 | 2 | 11.3177 | 16.7440 |
| flow1000 | 53,669 | 1 | 132.9690 | 185.3274 |

今回の6条件ではPyYAMLの中央値が小さかった。このMac・版・入力・純Python設定での観測に限る。
開始/終了のload averageはraw.jsonのenvironmentに保存した。他プロセスの負荷やCPU周波数・温度は固定していない。
同一プロセスのウォーム状態での計測であり、統計的有意差・別マシンでの再現性は未評価。
全整数ns生値はtrials[]、同じ生値を条件別に並べたものはseries[]にある。
summaryは便宜的集計。台帳assertionはsummaryを参照せず、全84生値をidentity / rounding=0 / tolerance=0で参照する。
中央値12件はseries[].ms_per_load[]からmedianで再計算し、displayedは小数4桁、rounding=4 / tolerance=0.00005とした。
入力サイズ・各バッチ内回数・計時後の値/型一致もidentity / tolerance=0で参照する。一致の1は一致確認1件を表す。

## 範囲と限界

外部推論・AIの出力品質は測っていない。実業務の品質や任意YAMLへの完全準拠も評価していない。
YAML 1.1/1.2の曖昧な暗黙型解決、引用符なしのyes/on/日付/先頭ゼロ数値、重複キー、タグ、アンカー、エイリアス、
マージキー、コメント保持、辞書、複数文書、無効入力、悪意のある入力、巨大な深さ、書き出し、C拡張は未測定。
ピークメモリ、起動、import、導入、並列実行、ディスクI/O、他OS・CPU・Pythonの比較も未測定。
小さい入力の結果にはAPI・ループ・結果解放の時間も含まれる。

## 再実行と一時領域

```sh
python3 measurements/pyyaml-ruamel-yaml-local-2026-11-19-req065-a1-replay.txt --output-dir /tmp/pyyaml-ruamel-new-run
```

既存の出力先は拒否する。通常のGIL版CPython 3.14・macOS arm64を対象とする。
再実行コードは固定URL・版・SHA256・サイズの公開wheelをcurlで取得し照合する。秘密情報は読まない。
依存の来歴、取得UTC、実際のSHA256/サイズはdependencies.jsonにある。
venv・wheel・測定の入力と出力は作業コピー外の `TemporaryDirectory(dir='/tmp')` に置き、成功・失敗とも終了時に削除する。
成功した測定結果だけを新規output-dirへ保存する。今回のREADMEと台帳は再実行スクリプトでは更新しない。
時間は再実行時に変動する。入力生成・測定の完全なコードは許可形式のTXTに残した。

## 保存物

raw.json、dependencies.json、run-log.txt、replay.txt、README.mdに加え、各条件のinput.txt・expected.json・両ツールoutput.json。
全29ファイルをmeasurements/とpublic/measurements/に同じバイトで新規保存した。
台帳はtopics.pyyaml-ruamel-yaml-local-hikakuだけを追加し、public側全29ファイルの実SHA256をraw_sha256に登録する。
記事・topics.json・検査のコードと条件・blocked台帳は変更していない。

## 公式資料

2026-11-19確認。API設定の確認に使用し、速度データは転載していない。

- [PyYAML公式リポジトリ](https://github.com/yaml/pyyaml): safe_loadとLibYAML loaderの使い分け。
- [ruamel.yaml公式](https://yaml.dev/doc/ruamel.yaml/): パッケージ情報。
- [ruamel.yaml Basic Usage](https://yaml.dev/doc/ruamel.yaml/basicuse/): safe APIとpure=Trueの設定。
