ローカル実測/YAML処理

PyYAMLとruamel.yamlのYAML読み込みを比較

この記事の料金・仕様は時点で各社の公式ページを確認したものです。

二つの箱の間を細い線が行き来する、YAMLの読み込みを表す抽象イラスト

文字列・整数・配列だけの同じYAMLを二つの部品に読ませ、値の一致と時間を並べました。書き方と入力の大きさで、差がどう動くかも見ます。

結論

とにかく読み込みの時間を短くしたい人は
PyYAMLが向いています。手元の測定では、六つの入力のすべてで、PyYAMLの中央値が短く終わりました。
読んだYAMLを書き戻す作業もある人は
ruamel.yamlも候補に入ります。公式ドキュメントでは、既定のモードが round-trip という往復のモードです。測った時間は別の設定の数字なので、その設定でも測り直してください。
信頼できない入力を読む人は
PyYAMLなら yaml.safe_load を使います。READMEがその使い方を案内しています。

896バイトの同じYAMLを読むと、PyYAMLの中央値は0.9409 ms、ruamel.yamlは1.4055 msでした。

意外だったのは書き方です。同じ中身を角かっこで詰めた形式のほうが、バイト数は少ないのに、どちらの部品でも遅くなりました。

値と型は、測った六つの入力のすべてで、どちらの部品も期待どおりに読み込みました。差がついたのは時間のほうです。

読み込んだ値の一致:全12の出力が期待どおりでした

六つの入力を二つの部品で読んだ12の出力は、どれも期待値と値も型も一致しました。

確かめ方は、配列の全要素を最後までたどり、型と値の両方を比べる方法です。

値が同じに見えても、文字列と整数が入れ替わっていると困ります。そこで型まで照合しました。

照合は時間を計る前と後の両方で行い、期待値は入力とは別の手順で作りました。さらに、二つの部品の出力どうしも突き合わせています。

項目PyYAMLruamel.yaml
読み込みの呼び方yaml.safe_load(text)YAML(typ='safe', pure=True).load(text)
期待値との一致(六入力)すべて一致すべて一致
相手の出力との一致一致一致

単純な型のYAML:文字列・整数・配列だけを二つの書き方で用意した

入力は自作で、中身は文字列・整数・配列だけです。

レコードの数は10・100・1000の三段階です。それぞれを、ブロック形式とフロー形式の二つで書きました。

ブロック形式は、字下げで入れ子を表す、ふつうのYAMLの書き方です。フロー形式は、角かっこで詰める書き方で、JSONによく似ています。

中身には、日本語、絵文字、空の文字列、引用符、改行、タブを入れました。

yes・on・日付に見える文字列は、すべて二重引用符で囲み、型の解釈が揺れないようにしています。

処理時間:六つの条件すべてでPyYAMLの中央値が短い

同じ入力を何度も読み、1回あたりの平均時間を7バッチ分並べて、中央値を取りました。単位はミリ秒(ms)です。

入力UTF-8のバイト数1バッチの読み込み回数PyYAML(中央値)ruamel.yaml(中央値)
ブロック形式・10レコード89610回0.9409 ms1.4055 ms
ブロック形式・100レコード92502回9.2436 ms13.5925 ms
ブロック形式・1000レコード956671回99.7279 ms157.8375 ms
フロー形式・10レコード47810回0.9565 ms1.4552 ms
フロー形式・100レコード50522回11.3177 ms16.7440 ms
フロー形式・1000レコード536691回132.9690 ms185.3274 ms

入力が大きいほど、1回あたりの時間は伸びます。95667バイトのブロック形式では、PyYAMLが99.7279 ms、ruamel.yamlが157.8375 msでした。

大きい入力は時間がかかるため、1バッチの読み込み回数を減らしています。回数は二つの部品で同じです。

短く書いたフロー形式は、速くならなかった

同じ中身を詰めて書いたフロー形式は、バイト数が少ないのに、10・100・1000レコードのどれでも、どちらの部品も時間が長くなりました。

100レコードで見ると、PyYAMLはブロック形式の9.2436 msに対し、フロー形式は11.3177 msです。ruamel.yamlも13.5925 msから16.7440 msへ延びました。

入力は9250バイトから5052バイトへ減っています。

バイト数だけでは、読み込みの時間は見積もれません。

ここが落とし穴:この時間は、ruamel.yamlの既定の設定ではありません

表の時間は、どちらもPythonだけで動く safe 読み込みの数字です。

ruamel.yaml公式のドキュメントでは、既定のモードが round-trip(読んだ内容を書き戻す往復)です。

測ったのは YAML(typ='safe', pure=True) で、既定のモードとは別の設定です。

PyYAMLにも、LibYAML(C言語で書かれた高速な部品)を使う CLoader という別の読み込み口があります。測ったのは yaml.safe_load のPython実装です。

速さを重く見る人は、本番に近い設定で測り直してください。

出典: PyYAML 公式のREADME、ruamel.yaml 公式のドキュメント(2026年11月19日確認)

選び方:読み込みの速さならPyYAML、書き戻しまで考えるならruamel.yaml

測った範囲では、読み込みを速くしたい人はPyYAMLが有利です。読んだ内容を書き戻す作業も考えるなら、既定が round-trip の ruamel.yaml も候補に入ります。

選ぶ理由は三つです。

  1. 時間は、896バイトの入力でPyYAMLが0.9409 ms、ruamel.yamlが1.4055 ms。95667バイトの入力でも99.7279 ms対157.8375 msです。
  2. 値と型は、六つの入力のすべてで両方とも期待どおりでした。差がつくのは時間です。
  3. 設定は、どちらもPythonだけで動く safe 読み込みで測っています。使う設定が変われば、順番も変わりえます。

PyYAML公式のREADMEは、信頼できない入力を読むときに yaml.safe_load を使うよう案内しています。

二つの部品の要点を、一枚にまとめます。

二つの部品の一言まとめ

PyYAML

Pythonで書かれた機能そろいの枠組みです。手元の測定では全ての入力で中央値が短く、safe読み込みの案内もあります。

ruamel.yaml

Python用のYAML読み込み・書き出しパッケージです。既定は round-trip モードで、測ったのは別の safe 設定です。

この記事の時間

どちらもPythonだけで動く safe 読み込みで測った数字です。C言語の高速な部品を使う設定とは別です。

出典: 各社の公式ページ(2026年11月19日確認)
項目PyYAMLruamel.yaml
測った処理時間六つの入力すべてで中央値が短い六つの入力すべてで中央値が長い
読み込んだ値の一致期待値と一致期待値と一致
測った設定yaml.safe_load(Python実装)YAML(typ='safe', pure=True)
向く人読み込みの時間を短くしたい人読んだ内容を書き戻す作業も考える人
向かない人書き戻しを重く見る人(ruamel.yamlも比べる)safe 読み込みの時間だけで選ぶ人
次に確かめることCLoader を使う設定で測り直す既定の round-trip モードで測り直す

自分の使い方から選ぶ順番は、この流れ図でたどれます。

PyYAMLとruamel.yamlの選び方

  1. 1. 読み込みの時間を最優先にしますか?
    はい → PyYAMLを選びます。手元の測定では六つの入力すべてで中央値が短くなりました。いいえ → 次は質問2です。
  2. 2. 読んだ内容を書き戻す作業もありますか?
    はい → ruamel.yamlも候補に入れ、既定の round-trip モードで測り直します。いいえ → 次は質問3です。
  3. 3. 信頼できない入力を読みますか?
    はい → PyYAMLなら yaml.safe_load を使います。READMEが案内している読み方です。いいえ → どちらでも足ります。使い慣れたほうから始めて構いません。
出典: 各社の公式ページ(2026年11月19日確認)

測定と比較の範囲

測定は2026年11月19日に、このMac1台のCPUだけで行いました。

項目内容
OS・CPUmacOS 27.2.1・arm64・論理CPU12(Mac機種名とCPU製品名は記録していません)
PythonCPython 3.14.10(GIL版)
PyYAML6.0.3
ruamel.yaml0.19.1
実行場所一時の仮想環境・CPUのみ・Metalなし
試行各入力・各部品で、準備の1バッチのあとに7バッチ。順序は交互。計84の測定バッチ
時計perf_counter_ns(整数のナノ秒)。循環GCは計時中だけ停止
含むものPythonのループ、読み込み、メモリの割り当て、結果の解放
含まないもの導入、import、YAMLインスタンスの初期構築、入力生成、検証、ファイル入出力

中央値は、バッチの時間を回数で割った1回あたりの平均を、7バッチ分並べて取っています。単発の読み込みの遅れを測ったものではありません。

入力は自作の文字列・整数・配列だけで、辞書・真偽値・null・小数・複数文書は入っていません。引用符なしの yes や on、アンカー、コメント、重複キー、無効な入力も対象外です。

書き出し、C拡張、ピークメモリ、起動やimportの時間、並列実行、ほかのOSやCPUとの比較も対象外です。

ほかのプロセスの負荷やCPU周波数は固定していません。統計的な有意差の検定も行っていないため、順位はこのMacと条件での観測です。

生データと再実行用のコードは、次のとおり公開しています。

出典

公式ページ(すべて2026年11月19日に確認)

自前の計測(2026年11月19日実施)

  • macOS 27.2.1・arm64・CPython 3.14.10・PyYAML 6.0.3・ruamel.yaml 0.19.1 の一時環境で、上の生データを取りました。

変更履歴

日付内容
2026-11-19初版

このサイトで測った元データ

更新履歴

  1. 初版。同じ自作のYAMLで測った値の一致と、読み込みの処理時間を掲載した

    一次ソース

関連記事