Skip to content

Commit 3835531

Browse files
committed
Update debugger documentation
1 parent e445bdc commit 3835531

File tree

1 file changed

+8
-15
lines changed

1 file changed

+8
-15
lines changed

docs/user/Tooling.md

Lines changed: 8 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,25 +5,18 @@ link_title: Tooling Support for Python
55
permalink: /reference-manual/python/Tooling/
66
---
77
# Tooling Support for Python
8-
9-
GraalVM's Python runtime is incomplete and cannot launch the standard Python debugger `pdb`.
10-
However, it can run the tools that GraalVM provides.
11-
The `graalpy --help:tools` command will give you more information about tools currently supported on Python.
8+
GraalVM Python runtime can run many standard Python tools as well as tools from the GraalVM ecosystem.
9+
The `graalpy --help:tools` command will give you more information about GraalVM tools currently supported on Python.
1210

1311
## Debugger
12+
The built-in `breakpoint()` function will use `pdb` by default.
1413

15-
To enable debugging, pass the `--inspect` option to the `graalpy` launcher.
16-
For example:
17-
```shell
18-
graalpy --inspect -c "breakpoint(); import os; os.exit()"
19-
Debugger listening on port 9229.
20-
To start debugging, open the following URL in Chrome:
21-
chrome-devtools://devtools/bundled/js_app.html?ws=127.0.1.1:9229/76fcb6dd-35267eb09c3
22-
```
14+
### PDB
15+
The standard python debugger `pdb` is supported on GraalVM. Refer to the offical [PDB documentation](https://docs.python.org/3/library/pdb.html) for usage.
2316

24-
The standard Python built-in `breakpoint()` will work using the [GraalVM's Chrome Inspector](https://github.com/oracle/graal/blob/master/docs/tools/chrome-debugger.md) implementation.
25-
You can inspect variables, set watch expressions, interactively evaluate code snippets, etc.
26-
However, this only works if you pass `--inspect` or some other inspect option. Otherwise, `pdb` is triggered as on CPython (and does not currently work).
17+
### Chrome Inspector
18+
To enable [GraalVM's Chrome Inspector](https://github.com/oracle/graal/blob/master/docs/tools/chrome-debugger.md) debugger, pass the `--inspect` option to the `graalpy` launcher.
19+
The built-in `breakpoint()` function will work using the Chrome Inspector implementation when `--inspect` is passed.
2720

2821
## Code Coverage
2922

0 commit comments

Comments
 (0)