Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,11 @@ The debugger backend is a two-threaded system:
whether the Kodi runtime is detected). Both implement `is_abort_requested()`,
`on_server_started()`, `on_server_stopped()`, and `on_exception()`. The Kodi variant uses
`xbmc.Monitor` for abort detection and shows progress dialogs/notifications.
- `web_pdb/variables.py`: Builds Globals/Locals variable tree nodes and resolves child nodes by
path (`[kind, value]` key tokens). The frontend lazily requests children via
`GET /variables?scope=...&path=...`; `AsyncioServer` puts a `VariablesRequest` into the shared
`input_queue`, and `WebConsole.readline()` resolves it in the debugger thread (so property
getters run in the debugged thread) and returns the result via a `concurrent.futures.Future`.
- `web_pdb/buffer.py`: Thread-safe buffer (`ThreadSafeBuffer`) used for passing data between
threads with dirty-flag semantics.

Expand Down Expand Up @@ -146,15 +151,15 @@ is achieved via:

## Requirements

- **Python**: 3.6+
- **Python**: 3.10+
- **Core dependencies**: pure Python stdlib (no third-party runtime dependencies)
- **Development dependencies**: `ruff==0.15.12`, `selenium==4.10.0`
- **Development dependencies**: `ruff==0.17.3`, `selenium==4.52.0`
- **Package manager**: `uv`

## Important Notes

- This is in minimum maintenance mode; prioritize bug fixes and compatibility over new features.
- The project aims to support all modern Python versions (3.6+).
- The project aims to support all modern Python versions (3.10+).
- The `inspect`/`i` command is a custom extension; it lists object members, excluding `__` names.
- Post-mortem debugging is supported via `post_mortem()` and the `catch_post_mortem()` context
manager.
Expand Down
15 changes: 8 additions & 7 deletions .github/workflows/publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,10 +12,10 @@ jobs:
steps:
- uses: actions/checkout@v3

- name: Set up Node.js 16.17.0
uses: actions/setup-node@v3
- name: Set up Node.js 24
uses: actions/setup-node@v4
with:
node-version: "16.17.0"
node-version: "24"

- name: Install dependencies
run: |
Expand All @@ -39,7 +39,7 @@ jobs:
- uses: actions/checkout@v3

- name: Set up Python 3.14
uses: actions/setup-python@v2
uses: actions/setup-python@v5
with:
python-version: "3.14"

Expand All @@ -56,15 +56,16 @@ jobs:
runs-on: ubuntu-latest
strategy:
matrix:
python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "3.15"]

steps:
- uses: actions/checkout@v3

- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v2
uses: actions/setup-python@v5
with:
python-version: ${{ matrix.python-version }}
allow-prereleases: true

- name: Install dependencies
run: |
Expand All @@ -84,7 +85,7 @@ jobs:
- uses: actions/checkout@v3

- name: Set up Python 3.14
uses: actions/setup-python@v1
uses: actions/setup-python@v5
with:
python-version: "3.14"

Expand Down
13 changes: 7 additions & 6 deletions .github/workflows/tests.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,10 @@ jobs:
steps:
- uses: actions/checkout@v3

- name: Set up Node.js 16.17.0
uses: actions/setup-node@v3
- name: Set up Node.js 24
uses: actions/setup-node@v4
with:
node-version: 16.17.0
node-version: "24"

- name: Install dependencies
run: |
Expand All @@ -42,7 +42,7 @@ jobs:
- uses: actions/checkout@v3

- name: Set up Python 3.14
uses: actions/setup-python@v2
uses: actions/setup-python@v5
with:
python-version: "3.14"

Expand All @@ -59,15 +59,16 @@ jobs:
runs-on: ubuntu-latest
strategy:
matrix:
python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "3.15"]

steps:
- uses: actions/checkout@v3

- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v2
uses: actions/setup-python@v5
with:
python-version: ${{ matrix.python-version }}
allow-prereleases: true

- name: Install dependencies
run: |
Expand Down
6 changes: 6 additions & 0 deletions Changelog.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
Changelog
#########

v.2.1.0
=======

* **Globals** and **Locals** boxes show variables as expandable trees with object attributes,
properties and collection items.

v.2.0.1
=======

Expand Down
9 changes: 5 additions & 4 deletions Readme.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,9 @@ Features
- **Current file** box tracks current position in the file being executed.
Red line numbers indicate breakpoints, if any.
- **Globals** and **Locals** boxes show local and global variables in the current scope.
Special variables that start and end with double underscores ``__`` are excluded
(you can always view them using PDB commands).
Complex objects can be expanded to view their attributes, properties
and collection items. Special variables that start and end with double underscores ``__``
and methods are excluded (you can always view them using PDB commands).
- Command history that stores up to 10 last unique PDB commands (accessed by arrow UP/DOWN keys).

.. figure:: https://raw.githubusercontent.com/romanvm/python-web-pdb/master/web-pdb-light-mode.png
Expand Down Expand Up @@ -123,7 +124,7 @@ To simplify this you can use ``set_trace(port=-1)`` to select a random port betw
Compatibility
=============

- **Python**: 3.8+
- **Python**: 3.10+
- **Browsers**: All modern browsers should work

Implementation Details
Expand All @@ -141,7 +142,7 @@ MIT, see ``LICENSE.txt``.

The debugger icon made by `Freepik`_ from `www.flaticon.com`_ is licensed by `CC 3.0 BY`_.

.. _PDB: https://docs.python.org/3.8/library/pdb.html
.. _PDB: https://docs.python.org/3/library/pdb.html
.. _Bootstrap: http://getbootstrap.com
.. _Prism: http://prismjs.com/
.. _Freepik: http://www.freepik.com
Expand Down
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
2.0.1
2.1.0
4 changes: 0 additions & 4 deletions frontend/.eslintignore

This file was deleted.

Loading
Loading