仕様と根拠

入力の形

git ls-tree の --long(-l)は、各行を「モード、種類、オブジェクト名、サイズ、タブ、パス」の形で出力します。サイズはバイト単位で、右寄せで幅 7 に整えられます。サイズが付くのは blob(ファイル)だけで、commit(サブモジュール)や tree は「-」です。-r で再帰すると、ディレクトリの中のファイルも並びます。

抜き出し方

blob の行だけを読み取り、サイズの大きい順(同じなら、パスの文字順)に並べます。しきい値(KiB は 1,024 バイト)以上のものから、指定した件数だけを表にします。サイズは圧縮前の内容のバイト数です。

根拠にした仕様・資料

指摘の段階

• エラー: 仕様に反していて、正しく読めない・処理できない入力です。
• 警告: 読めるものの、仕様の推奨に反する・矛盾する・意図と違う結果になりやすい入力です。
• 情報: 誤りではありませんが、知っておくとよい扱い(読み飛ばした部分や解釈)です。

入力の扱い(送信しない仕組み)

処理はすべてお使いのブラウザの中で行います。処理の本体はこのサイトから配信する小さなスクリプト(/app.js)で、外部のサービスやライブラリを読み込みません。ページはブラウザに通信を禁止させる設定(Content-Security-Policy の connect-src)つきで配信しており、入力した内容がサーバーや第三者へ送られることはありません。ファイルを選んだ場合も、端末の中で読み込むだけです。

このツールでできないこと(制約)

• 1 つの時点のツリー(HEAD など)の一覧だけが対象です。過去のコミットに含まれていた巨大ファイルは、この一覧には出ません。
• パスにタブや日本語などの変わった文字があると、git が引用符つきで出力します。この道具は展開せず、そのままの文字で表示します。-z の出力(NUL 区切り)には対応していません。
• サイズは git に保存された内容の元のバイト数で、リポジトリのディスク使用量(圧縮後)とは違います。