Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Breakpoints in non-stdlib modules named `io.py` are always skipped

Open
#1,887 17 comments 0 reactions 1 assignee View on GitHub

@bschnurr is already working on this.

Since Apr 4, 2025.

Assessment

This issue has not been assessed yet.

Description

bug needs repro

Any breakpoint within a non-stdlib module named io.py will always be skipped.

e.g. consider the python package:

.
├── mypackage
│   ├── __init__.py
│   ├── io.py
│   └── main.py
└── pyproject.toml
# mypackage/io.py

def foo():
    return "hello from mypackage.io.foo"
# mypackage/main.py

from mypackage.io import foo


def main():
    return foo()


if __name__ == "__main__":
    main()

If you add a breakpoint inside mypackage.io.foo it will always be skipped, and you cannot step into that module.

Renaming the module to anything else fixes the issue.

PDB honour's breakpoints in that module (i.e. add breakpoint() in mypackage.io.foo and running python -m mypackage.main)

Dominant language
Python
Stars
2.5k
Forks
202
Avg merge
5d 1h
Merged PRs (30d)
1

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from microsoft/debugpy

All issues in microsoft/debugpy

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.