textual-debugger 0.0.2__tar.gz → 0.0.4__tar.gz

{textual_debugger-0.0.2/src/textual_debugger.egg-info → textual_debugger-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: textual-debugger
-Version: 0.0.2
+Version: 0.0.4
 Summary: A TUI Python debugger based on textual and debugpy
 Author-email: Al Danial <al.danial@gmail.com>
 License: textual-debugger is licensed to you under the MIT/X Consortium license:
@@ -53,6 +53,7 @@ Requires-Dist: fastapi>=0.115.0
 Requires-Dist: uvicorn>=0.30.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
 Requires-Dist: httpx; extra == "dev"
 Requires-Dist: matplotlib; extra == "dev"
@@ -62,7 +63,7 @@ Requires-Dist: ruff; extra == "dev"
 Requires-Dist: ipython; extra == "dev"
 Dynamic: license-file
 
-# `textual-debugger`
+# `textual-debugger` version 0.0.4 2026-05-10
 
 `textual-debugger` (the package) provides `tdb` (the command-line tool and module),
 a full-featured terminal-based Python debugger.
@@ -83,7 +84,7 @@ MIT License.  Copyright 2026 by Al Danial.
 
 - supports debugging of synchronous, asynchronous, multi-threaded, and multi-process Python code.
 It specifically supports modules
-    - `asyncio` (with a built-in async task inspector)
+    - `asyncio` (with a built-in async task inspector and task wait graph)
     - `threading` (with a thread inspector)
     - `multiprocessing` / `concurrent.futures` (with automatic child process attachment and a process inspector)
 
@@ -130,27 +131,46 @@ or (better):
 uv pip install textual-debugger
 ```
 
+or run it without installing:
+
+```
+uvx --from textual-debugger tdb
+```
+
 
 ## Quick Start
 
 ```bash
-# Debug a script (stops at first line by default)
+# show comprehensive documentation in a terminal-based Markdown viewer
+tdb --doc
+
+# debug a script (stops at first line by default)
 tdb my_script.py
 
-# Debug with arguments
+# debug with arguments
 tdb my_script.py arg1 arg2
 
-# Use a specific virtualenv
+# add breakpoints at lines 20 and 35 of `my_script.py` and line 14 of `module.py`
+tdb -k 20 -k 35 -k module.py:14 my_script.py arg1 arg2
+
+# use a specific virtualenv
 tdb --python /path/to/venv/bin/python my_script.py
 
-# Don't stop on entry; run until first breakpoint or exit
+# step into, or stop at tracebacks in library code
+tdb --no-just-my-code /path/to/venv/bin/python my_script.py
+
+# run until first breakpoint or exit
 tdb --no-stop-on-entry my_script.py
 
-> **Note:** Avoid `argparse` confusion by separating `tdb` switches from
-> the debuggee's switches by prefixing the debuggee with `--`.
+# run the debuggee in an external terminal
+tdb --terminal xterm my_script.py
 
-# `--` separates tdb's switches from the debuggee's switches
-tdb --python /path/to/venv/bin/python -- my_script.py -f 17 --max 23.3
+# attach to a remote Python program that has a debugpy server on port 5678
+tdb -r remotehost:5678 my_script.py
+
+> prevent `argparse` confusion by separating `tdb` switches from
+> the debuggee switches by prefixing the debuggee with `--`.
+tdb --python /path/to/venv/bin/python -- my_script.py -k 17 --max 23.3
 ```
 
 Or use the module entry point:
@@ -505,7 +525,7 @@ This example assumes the debuggee runs on 192.168.1.10 and listens on port 5678:
 
 ```bash
 # Attach from tdb:
-tdb -r 5678
+tdb -r 5678   # to localhost
 tdb -r 192.168.1.10:5678
 
 # With breakpoints:
@@ -643,18 +663,19 @@ Each is JSON with `event`, `data`, and `timestamp` fields.
 ## CLI Reference
 
 ```
-usage: tdb [-h] [-r [HOST:]PORT] [-k FILE:LINE] [--cwd CWD]
-           [--no-stop-on-entry] [--no-just-my-code] [--no-subprocess]
-           [--python PYTHON] [--keybindings {default,vim,emacs}]
+usage: tdb [-h] [-v/--version] [-r [HOST:]PORT] [--cwd CWD] [--no-stop-on-entry]
+           [--no-just-my-code] [--no-subprocess] [--python PYTHON]
+           [-d/--doc] [--doc-text] [--keybindings {default,vim,emacs}]
            [--terminal {xterm,konsole,gnome-terminal,ghostty,kitty,iterm2,warp,wezterm,terminator}]
-           [--server] [--headless] [--server-port PORT]
+           [--server] [--headless] [-k FILE:LINE|LINE] [--server-port SERVER_PORT]
            [program] [args ...]
+
 ```
 
 | Flag | Description |
 |------|-------------|
 | `-r`, `--remote-attach HOST:PORT` | Attach to a remote debugpy server |
-| `-k`, `--breakpoint FILE:LINE` | Set a breakpoint (may be repeated) |
+| `-k`, `--breakpoint FILE:LINE|LINE` | Set a breakpoint (may be repeated) |
 | `--no-stop-on-entry` | Do not pause at the first line (default: stop on entry) |
 | `--cwd DIR` | Working directory for the debuggee |
 | `--python PATH` | Python interpreter for the debuggee |

{textual_debugger-0.0.2 → textual_debugger-0.0.4}/README.md

@@ -1,4 +1,4 @@
-# `textual-debugger`
+# `textual-debugger` version 0.0.4 2026-05-10
 
 `textual-debugger` (the package) provides `tdb` (the command-line tool and module),
 a full-featured terminal-based Python debugger.
@@ -19,7 +19,7 @@ MIT License.  Copyright 2026 by Al Danial.
 
 - supports debugging of synchronous, asynchronous, multi-threaded, and multi-process Python code.
 It specifically supports modules
-    - `asyncio` (with a built-in async task inspector)
+    - `asyncio` (with a built-in async task inspector and task wait graph)
     - `threading` (with a thread inspector)
     - `multiprocessing` / `concurrent.futures` (with automatic child process attachment and a process inspector)
 
@@ -66,27 +66,46 @@ or (better):
 uv pip install textual-debugger
 ```
 
+or run it without installing:
+
+```
+uvx --from textual-debugger tdb
+```
+
 
 ## Quick Start
 
 ```bash
-# Debug a script (stops at first line by default)
+# show comprehensive documentation in a terminal-based Markdown viewer
+tdb --doc
+
+# debug a script (stops at first line by default)
 tdb my_script.py
 
-# Debug with arguments
+# debug with arguments
 tdb my_script.py arg1 arg2
 
-# Use a specific virtualenv
+# add breakpoints at lines 20 and 35 of `my_script.py` and line 14 of `module.py`
+tdb -k 20 -k 35 -k module.py:14 my_script.py arg1 arg2
+
+# use a specific virtualenv
 tdb --python /path/to/venv/bin/python my_script.py
 
-# Don't stop on entry; run until first breakpoint or exit
+# step into, or stop at tracebacks in library code
+tdb --no-just-my-code /path/to/venv/bin/python my_script.py
+
+# run until first breakpoint or exit
 tdb --no-stop-on-entry my_script.py
 
-> **Note:** Avoid `argparse` confusion by separating `tdb` switches from
-> the debuggee's switches by prefixing the debuggee with `--`.
+# run the debuggee in an external terminal
+tdb --terminal xterm my_script.py
 
-# `--` separates tdb's switches from the debuggee's switches
-tdb --python /path/to/venv/bin/python -- my_script.py -f 17 --max 23.3
+# attach to a remote Python program that has a debugpy server on port 5678
+tdb -r remotehost:5678 my_script.py
+
+> prevent `argparse` confusion by separating `tdb` switches from
+> the debuggee switches by prefixing the debuggee with `--`.
+tdb --python /path/to/venv/bin/python -- my_script.py -k 17 --max 23.3
 ```
 
 Or use the module entry point:
@@ -441,7 +460,7 @@ This example assumes the debuggee runs on 192.168.1.10 and listens on port 5678:
 
 ```bash
 # Attach from tdb:
-tdb -r 5678
+tdb -r 5678   # to localhost
 tdb -r 192.168.1.10:5678
 
 # With breakpoints:
@@ -579,18 +598,19 @@ Each is JSON with `event`, `data`, and `timestamp` fields.
 ## CLI Reference
 
 ```
-usage: tdb [-h] [-r [HOST:]PORT] [-k FILE:LINE] [--cwd CWD]
-           [--no-stop-on-entry] [--no-just-my-code] [--no-subprocess]
-           [--python PYTHON] [--keybindings {default,vim,emacs}]
+usage: tdb [-h] [-v/--version] [-r [HOST:]PORT] [--cwd CWD] [--no-stop-on-entry]
+           [--no-just-my-code] [--no-subprocess] [--python PYTHON]
+           [-d/--doc] [--doc-text] [--keybindings {default,vim,emacs}]
            [--terminal {xterm,konsole,gnome-terminal,ghostty,kitty,iterm2,warp,wezterm,terminator}]
-           [--server] [--headless] [--server-port PORT]
+           [--server] [--headless] [-k FILE:LINE|LINE] [--server-port SERVER_PORT]
            [program] [args ...]
+
 ```
 
 | Flag | Description |
 |------|-------------|
 | `-r`, `--remote-attach HOST:PORT` | Attach to a remote debugpy server |
-| `-k`, `--breakpoint FILE:LINE` | Set a breakpoint (may be repeated) |
+| `-k`, `--breakpoint FILE:LINE|LINE` | Set a breakpoint (may be repeated) |
 | `--no-stop-on-entry` | Do not pause at the first line (default: stop on entry) |
 | `--cwd DIR` | Working directory for the debuggee |
 | `--python PATH` | Python interpreter for the debuggee |

{textual_debugger-0.0.2 → textual_debugger-0.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
   [project]
   name = "textual-debugger"
-  version = "0.0.2"
+  dynamic = ["version"]
   description = "A TUI Python debugger based on textual and debugpy"
   readme = "README.md"
   requires-python = ">=3.10"
@@ -29,7 +29,7 @@
 
   # extras needed to run the examples and tests
   [project.optional-dependencies]
-  dev = ["pytest", "pytest-asyncio", "httpx",
+  dev = ["pytest", "pytest-cov", "pytest-asyncio", "httpx",
          "matplotlib",
          "pyyaml",
          "toml",
@@ -48,12 +48,37 @@
   requires = ["setuptools>=68.0"]
   build-backend = "setuptools.build_meta"
 
+  [tool.setuptools.dynamic]
+  version = {attr = "tdb.__version__"}
+
   [tool.setuptools.packages.find]
   where = ["src"]
 
+  [tool.setuptools.package-data]
+  tdb = ["README.md"]
+
   [tool.pytest.ini_options]
   testpaths = ["tests"]
   asyncio_mode = "auto"
+  addopts = "--cov=tdb --cov-report=term-missing"
   filterwarnings = [
       "ignore::DeprecationWarning",
   ]
+
+  [tool.coverage.run]
+  source = ["src/tdb"]
+  branch = true
+  omit = [
+      "*/tests/*",
+      "src/tdb/__main__.py",
+  ]
+
+  [tool.coverage.report]
+  exclude_lines = [
+      "pragma: no cover",
+      "raise NotImplementedError",
+      "if TYPE_CHECKING:",
+      "if __name__ == .__main__.:",
+  ]
+  show_missing = true
+  skip_covered = false