Skip to content

Welcome to the httpdbg's documentation!

httpdbg is a tool for tracing HTTP requests in your Python code for debugging purposes.

httpdbg web interface

httpdbg is easy to use

Simplicity is the keyword of httpdbg. It requires:

  • no external dependency
  • no setup
  • no super user right
  • no code modification

All what you have to do is to install httpdbg in your virtual environment:

pip install httpdbg

Then, replace the python command with pyhttpdbg to execute your code.

The screenshot above was obtained simply by running some tests like this:

pyhttpdbg -m pytest -v examples/

httpdbg is not ...

httpdbg isn’t just another proxy. It can:

  • Trace HTTP requests made by your client.
  • Trace HTTP requests received by your server.
  • Trace HTTP requests inside your Jupyter notebook.
  • Link HTTP requests directly to the relevant Python code.
  • Group HTTP requests by client call, endpoint, method, test function, and more.

httpdbg is not a monitoring tool. It should not be used in production code, but only for debugging purposes.

httpdbg supports the major HTTP packages

Theorically, all pure python HTTP requests are fully traceable by httpdbg.

These HTTP clients have special integrations that provide even more detailed information:

These HTTP servers also have special integrations for enhanced insights:

Some test frameworks are also supported to provide additional information:

Some extensions are available for different famous Python tools: