Metadata-Version: 2.3
Name: dhv
Version: 0.4.0
Summary: A tool to dive into Python code
Project-URL: Homepage, https://github.com/davep/dhv
Project-URL: Repository, https://github.com/davep/dhv
Project-URL: Documentation, https://github.com/davep/dhv
Project-URL: Source, https://github.com/davep/dhv
Project-URL: Issues, https://github.com/davep/dhv/issues
Project-URL: Discussions, https://github.com/davep/dhv/discussions
Author-email: Dave Pearson <davep@davep.org>
License: GNU General Public License v3 or later (GPLv3+)
Keywords: bytecode,chui,disassembler,disassembly,documentation,python,terminal,tui
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Documentation
Classifier: Topic :: Education
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Disassemblers
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.13
Requires-Dist: textual-enhanced>=0.13.0
Requires-Dist: textual-fspicker>=0.4.1
Requires-Dist: textual[syntax]>=3.7.0
Requires-Dist: xdg-base-dirs>=6.0.2
Description-Content-Type: text/markdown

# DHV

![DHV](https://raw.githubusercontent.com/davep/dhv/refs/heads/main/.images/dhv.gif)

## Introduction

DHV is a terminal-based tool for diving into Python code, the emphasis for
now being on [bytecode disassembly](https://docs.python.org/3/library/dis.html).

> [!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`](https://pypa.github.io/pipx/):

```sh
$ pipx install dhv
```

### uv

The package can be install using [`uv`](https://docs.astral.sh/uv/getting-started/installation/):

```sh
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 <kbd>F1</kbd>.

## Getting help

If you need help, or have any ideas, please feel free to [raise an
issue](https://github.com/davep/dhv/issues) or [start a
discussion](https://github.com/davep/dhv/discussions).

## TODO

See [the TODO tag in
issues](https://github.com/davep/dhv/issues?q=is%3Aissue+is%3Aopen+label%3ATODO)
to see what I'm planning.

[//]: # (README.md ends here)
