Unref - RuffのパーサーでPythonのデッドコードを検出

Show HN: Unref – A Python dead code finder built on Ruff's parser

Unref - RuffのパーサーでPythonのデッドコードを検出

Unrefは、Ruffの高速なパーサーを基盤に構築されたPython向けのデッドコード検出ツールです。参照されていない関数やクラス、変数といった不要なコードを静的に解析して洗い出し、コードベースの整理とメンテナンスを支援します。Python 3.15の新構文にも対応し、CIでの自動チェックやPRごとの検出結果の比較も可能。長年蓄積された使われないコードの特定に手間取っていた開発者にとって、コード品質の維持とリファクタリングを効率化する頼もしい味方です。

参照されないコードを見つけ出す——Unrefは、Ruffのパーサーの速さを活かして、Pythonコードベースに潜む不要なコードをすばやく炙り出します。
  1. selcuka

    クールなプロジェクトですね。現段階では、見逃すデッドコードよりも誤検出の方が重要だと思います。例えば、Djangoの設定をすべて未使用変数としてマークします。おそらくDjangoプロジェクトでは設定が直接インポートされないのが普通だからでしょう。例えば:

    from django.conf import settings

    ...

    if settings.DEBUG:

    ...

    現在、unrefはDEBUGが使われていないと判断します。

    同様に、asgi.py(またはwsgi.py)の`application`変数はASGI/WSGIサーバーの実行ファイルに引数として渡されますが、これも未使用とマークされます。

  2. tomtom1337

    Unrefが使うデッドコードの定義は何ですか?私はアプリとライブラリを区別しています。アプリでは、エントリポイントから呼び出せないコードはすべてデッドになり得ると思いますが、ライブラリの場合、定義はパブリックAPIから呼び出せないコードすべてでしょうか?

    使われている定義をドキュメントやGitHubのREADMEに載せてもらえると嬉しいです。

  3. athoscouto

    私も内部的に似たようなことをやろうとしていました。Pythonから始めて、それからruffに移りました。ただ、私の目標はもう少し広いです。依存関係グラフを使ってプロジェクトの変更部分を検出し、イメージビルドやテスト実行を選択的にトリガーしたいのです。

    結果はまだ芳しくなく、特にテスト側がひどいです。これまでの主な学びは、きちんと整理されたコードベース(依存関係グラフ)が正しく動作するために不可欠だということです。

    これを効果的に取り組んでいるオープンソースツールをもっと見つけられなかったのが不思議です。

この日のほかの記事

2026-11-18