DHV

Introduction

DHV is a terminal-based tool for diving into Python code, giving easy visual access to bytecode disassembly and the abstract syntax tree. If you're curious about what's "under the hood" when it comes to your Python source, this tool should help satisfy some of that curiosity.

Important

Python's dis module is a bit of a moving target; because of this and to try and keep the code as clean as possible DHV only works with Python 3.13 or later.

Installing

pipx

The package can be installed using pipx:

$ pipx install dhv

uv

The package can be install using uv:

uv tool install --python 3.13 dhv

Using DHV

Once you've installed DHV using one of the above methods, you can run the application using the dhv command.

The best way to get to know DHV is to read the help screen, once in the main application you can see this by pressing F1.

Getting help

If you need help, or have any ideas, please feel free to raise an issue or start a discussion.

TODO

See the TODO tag in issues to see what I'm planning.