Repolode
cle-b

cle-b/httpdbg

プログラムが送信するサーバー側のリクエストを含むHTTP(S)リクエストを記録し、ローカルのWeb UIで確認できるPythonデバッグツール。

スター
907
フォーク
28
未解決の Issue
5
最終コミット
5 日前

これは何?

httpdbgを使うと、Pythonプログラムが生成するHTTP(S)トラフィックを確認できます。pythonの代わりにpyhttpdbgコマンドでスクリプト、モジュール、テストスイート、対話型コンソールを実行すると、すべてのリクエストが記録され、localhost:4909のWebインターフェースに、リクエストを開始した関数ごとにまとめて表示されます。

接続の両側に対応しています。requests、urllib3、httpx、aiohttpからのクライアントリクエストはデフォルトで記録され、FlaskやFastAPIが処理するサーバー側のリクエストもトレースできます。pytestやunittestの実行中に行われたリクエストはテストごとにまとめられます。HTTP/1.0、HTTP/1.1、HTTP/2(後者はh2ライブラリ経由)に対応しています。

トレースは共有用に単一のHTMLファイルへエクスポートできます。また、-iオプションを使って追加のパッケージをリクエストの開始元として登録できます。

主な機能

  • 01requests、urllib3、httpx、aiohttpからのクライアントリクエストを記録します。
  • 02FlaskやFastAPIが処理するサーバー側のリクエストをトレースします。
  • 03pytestやunittestの実行時に、リクエストをテストごとにまとめます。
  • 04HTTP/1.0、HTTP/1.1、HTTP/2に対応しています。
  • 05トレースを単独で閲覧できるHTMLファイルにエクスポートします。

ユースケース

  • Pythonスクリプトの実行中に、どのAPI呼び出しが行われるかを調べる。
  • pipやその他のモジュールが送信するHTTPリクエストを確認する。
  • テストスイートが行うリクエストと、その発生元をデバッグする。
  • ローカルのFlaskまたはFastAPI開発サーバーへの受信リクエストを確認する。

クイックスタート

  1. 1

    PyPIからhttpdbgをインストールします

    pip install httpdbg
  2. 2

    httpdbgのもとでスクリプトを実行し、http://localhost:4909を開いてリクエストを確認します

    pyhttpdbg --script filename.py

使う前に知っておきたいこと

  • サーバーサイドのリクエスト記録機能は新しく、一部のフレームワークではまだ開発中です。
  • HTTP/2をサポートするにはh2ライブラリが必要です。

収録されている特集

トピック

よくある質問

httpdbg とは?
プログラムが送信するサーバー側のリクエストを含むHTTP(S)リクエストを記録し、ローカルのWeb UIで確認できるPythonデバッグツール。 httpdbgを使うと、Pythonプログラムが生成するHTTP(S)トラフィックを確認できます。pythonの代わりにpyhttpdbgコマンドでスクリプト、モジュール、テストスイート、対話型コンソールを実行すると、すべてのリクエストが記録され、localhost:4909のWebインターフェースに、リクエストを開始した関数ごとにまとめて表示されます。
httpdbg は無料で使えますか?ライセンスは?
httpdbg は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
httpdbg は今もメンテナンスされていますか?
活発にメンテナンス中。httpdbg の最終コミットは 2026年11月2日 です。
httpdbg は何に使えますか?
Pythonスクリプトの実行中に、どのAPI呼び出しが行われるかを調べる。 pipやその他のモジュールが送信するHTTPリクエストを確認する。 テストスイートが行うリクエストと、その発生元をデバッグする。 ローカルのFlaskまたはFastAPI開発サーバーへの受信リクエストを確認する。
httpdbg のインストール方法は?
PyPIからhttpdbgをインストールします: pip install httpdbg httpdbgのもとでスクリプトを実行し、http://localhost:4909を開いてリクエストを確認します: pyhttpdbg --script filename.py
httpdbg はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/cle-b/httpdbg

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト