ツール公開 データ取得日

PyPI の人気500パッケージのうち、最新版に attestation が付いているのは約4割。上位ほど高いが、50位刻みでは階段にならない

PyPI の月間ダウンロード上位500パッケージのうち、最新版の配布ファイルに attestation の provenance 欄が1件でも付いているのは211件(42.2%)だった。半数には届かないが、約4割は確認の手段がある。付いていないことは危険を意味せず、付いていることも安全の保証ではない。

この記事で確かめたのは、Python のライブラリを選ぶ人や依存を監査する人は、人気のパッケージについて「公式リポジトリの CI から出た配布物か」を attestation で確かめられるのか。上位500のうち最新版に付いているのはどれだけで、上位ほど多いのかだ。帯別では 1〜100位が59.0%、101〜300位が40.5%、301〜500位が35.5%と上位ほど高い。ただし50位刻みで見ると順位ごとの階段にはならない。

attestation(PEP 740)は、配布ファイルを「どの公開元(たとえば特定の GitHub リポジトリの CI)が公開したか」の証明として PyPI に載せる仕組みだ。PyPI は、attestation があるファイルに provenance 欄(証明へのリンク)を付けて返す。この記事で数えたのはこの欄の有無で、リンク先の中身の全件検証ではない。リンク先は標本2件(packaging と yarl の wheel)だけ開き、どちらも公開元は GitHub で、リポジトリは pypa/packaging と aio-libs/yarl だった。

PyPI が提供を始めたのは2024年11月14日(公式ブログの日付)。GitHub Actions から Trusted Publishing で pypa/gh-action-pypi-publish を使って公開する場合は、attestation が既定で生成・公開される。他の Trusted Publisher 環境への対応は計画中で、手動での生成もできるが推奨されていない、と同ブログにある。数えたのは2026年10月6日に自分で PyPI の API から取得した値で、1時点の全数だ。

付いているのは約4割。上位ほど高い

対象は、hugovk/top-pypi-packages の先頭500件(最終更新 2026年10月1日。順位は一覧の並び)の各パッケージの最新版。最新版は PyPI の JSON API が示す版(info.version)で、標本ではなく全数を数えた。

「付いている」は、最新版のファイルのうち provenance 欄が空でないものが1件以上あることを指す。この記事の割合はすべてこの「1件でもあり」の定義だ。

帯 パッケージ数 1件でもあり 割合 うち全ファイルにあり 一部のファイルのみ なし
1〜100位 100 59 59.0% 58 1 41
101〜300位 200 81 40.5% 81 0 119
301〜500位 200 71 35.5% 70 1 129
全体 500 211 42.2% 209 2 289

付いていないのは289件(57.8%)で、6割弱にあたる。依存を監査する側から見ると、attestation で出どころを確かめる手段が使える範囲は、人気上位500でも約4割までということになる。

編集部は調べる前に「付いているのは上位500のうち少数派(1〜3割程度)で、上位100位以内の方が割合は高い」と予想していた。前半は一部しか当たらなかった。半数に満たないという意味の少数派ではあるが、全体は42.2%で、最も低い301〜500位でも35.5%と、「1〜3割」の範囲を上回る。後半は帯別では支持された(59.0%、40.5%、35.5%)。

50位刻みで見ると、順位ごとには並ばない

帯別では上位ほど高いが、「順位が上がるほど増える」とまでは言えない。50位刻みの「1件でもあり」(各50件中)は次のとおり並ぶ。

順位 1〜50 51〜100 101〜150 151〜200 201〜250 251〜300 301〜350 351〜400 401〜450 451〜500
件数 32 27 20 14 23 24 17 19 20 15

151〜200位の14件が、201〜300位の23件・24件より少ない。上位ほど高いと言えるのは、1〜100位がほかの帯より明らかに高いという粗さの範囲までだ。

「全ファイルにあり」と「1件でも」を分ける理由になる例が2件ある。sqlalchemy(87位、最新版 2.1.3)は72ファイル中64件に provenance 欄があり、ない8件は win_arm64 の wheel 7件と sdist だった。argon2-cffi-bindings(364位)は41ファイル中40件にある。理由はデータにないため、推測しない。ファイル数はパッケージごとに大きく違うので、ファイル単位の割合ではなくパッケージ単位で数えた。

月間ダウンロード数で重み付けした参考値もある。top500 の合計ダウンロード数のうち「1件でもあり」のパッケージが占める割合は50.7%(1〜100位59.8%、101〜300位38.8%、301〜500位35.6%)で、件数ベースの42.2%より高い。個々のパッケージの偏りで変わる値で、件数ベースの結果の補足にとどまる。

最新版が2024年11月14日より前のままの50件を分けて見る

最新版の公開が2024年11月14日より前の50件(1〜100位が3件、101〜300位が23件、301〜500位が24件)を分けて数えた。このうち provenance 欄があるのは1件(blinker)で、最新版は2024年11月8日の公開、2ファイルとも付いている。提供開始日より前の日付でも付いている例があり、原因は確認していない。そのため「付けようがない」とは書かず、「2024年11月14日より前に公開された最新版」と書く。

残る450件(最新版の公開が同日以後)を分母にすると、割合は次のとおり上がる。分母が帯ごとに違う別の集計で、上の表とは混ぜない。

帯 パッケージ数(分母) 1件でもあり 割合
1〜100位 97 59 60.8%
101〜300位 177 80 45.2%
301〜500位 176 71 40.3%
全体 450 210 46.7%

全体の42.2%と46.7%の差は、古い版のままの50件(うち付いているのは1件)で説明できる範囲だ。帯の順序は変わらず、上位ほど高いという結果も同じだった。

最新版の公開年(ファイルの upload-time の最大の年。パッケージの開始年ではない)で500件を分けると、次のとおりになる。

最新版の公開年 パッケージ数 1件でもあり
2019〜2023年 31 0
2024年 22 2
2025年 70 30
2026年 377 179

2019〜2023年公開の最新版31件には1件もない。2025年は70件中30件(42.9%)、2026年は377件中179件(47.5%)だった。最新版が新しいほど割合は高いが、これは最新版の公開年と provenance 欄の有無の対応にとどまる。更新の頻度や、付けるかどうかの方針については、このデータだけでは言えない。

この数字の読み方と、確かめていないこと

  • 意味の限界。 attestation が示すのは、特定の公開元(たとえば特定のリポジトリの CI)から公開されたという主張だ。PyPI の docs は、Trusted Publishing と attestation が、公開ワークフローを誰が動かせるかの管理のような基本的な安全対策の代わりにならないと書いている。PEP 740 は検証の義務化も定めておらず、index 自体への信頼を増減させるものでもない。この記事の割合は安全性の指標ではなく、付いていないことは危険や未対応を意味しない。
  • 付いていない理由。 Trusted Publishing を使っていないのか、GitHub Actions 以外から公開しているのか、単に設定していないのかは、今回のデータにない。各リポジトリの公開ワークフローは見ていない。
  • 順位とダウンロード数。 順位は hugovk/top-pypi-packages の30日ダウンロード数(ClickHouse 由来)による。ミラーや CI の繰り返しのダウンロードを含みうる。人気は利用者数と同じではない。30日の開始日・終了日は確認していない。取得は2026年10月6日の1時点で、最新版は日々変わりうる。
  • 最新版と配布名の数え方。 yanked の版は除き、PyPI が示す版を使った。事前リリースしかない7件(opentelemetry-* で、最新版は 0.66b0 など)もその版を最新版として数えた。polars と polars-runtime-32 のように関連する配布名は別々に数えている。
  • 範囲。 上位500件の最新版の全数で、全パッケージの結果ではない。過去の時点との比較はしていない。

出典

取得日は2026年10月6日。