Repository navigation
PyREPL: auto-complete module attributes in import statements #140870
Description
Feature or enhancement
Proposal:
Support for auto-completion of import statements can be separated between
- Modules suggestions (Readline completion of module names in import statements #69605): done by @tomasr8 🎉
- Attributes suggestions: more complex, since we cannot reliably know which attributes to suggest if their module is not imported yet.
As discussed on Discourse, automatically importing modules when pressing TAB would be too intrusive and unsafe, considering import-time side effects.
A solution that seems acceptable to most people, though, is to prompt the user to press TAB again to import the module and see its contents.
Has this already been discussed elsewhere?
I have already discussed this feature proposal on Discourse
Links to previous discussion of this feature:
https://discuss.python.org/t/looking-for-feedback-on-adding-import-autocomplete-to-pyrepl/82281
Linked PRs
- gh-140870: PyREPL auto-complete module attributes in import statements #140871
- gh-140870: Full coverage for _pyrepl._module_completer #143244
- [3.14] gh-140870: Full coverage for _pyrepl._module_completer (GH-143244) #143260
- gh-140870: Add PyREPL's module attributes import completion feature to What's New #156782
- [3.15] gh-140870: Add PyREPL's module attributes import completion feature to What's New 3.15 (GH-156782) #156945
Activity
pythongh-140870 PyREPL: add import completion for attributes
pythongh-140870 PyREPL: add import completion for attributes
gh-140870: Full coverage for _pyrepl._module_completer (#143244)
pythongh-140870: Full coverage for _pyrepl._module_completer (pythonG…
[3.14] gh-140870: Full coverage for _pyrepl._module_completer (GH-143244
pythongh-140870: Full coverage for _pyrepl._module_completer (python#…
loic-simon commentedon Apr 5, 2026
@tomasr8 @ambv Hey, we're now 1 month from the 3.15 feature freeze, do you think #140871 could make it? 🙏
Please tell me if there's anything more I can do!
pythongh-140870 PyREPL: add import completion for attributes
gh-140870: PyREPL auto-complete module attributes in import statements (
tomasr8 commentedon Apr 5, 2026
Looks like Pablo beat me to it 😆 I'm really sorry I but I've had very limited time in the last couple of months due to family.. Thanks a lot @loic-simon for getting it across the finish line, it's great to finally have it merged! :)
pablogsal commentedon Apr 5, 2026
Thanks a lot for your contribution @loic-simon 🚀
tomasr8 commentedon Apr 5, 2026
Also, now that #130473 is merged as well, it'd be nice to get the same colored completion for import attributes as well. I'm having a look but at a minimum I think we'll need to:
colorize_matchesfrom FancyCompleter and reuse it for importsloic-simon commentedon Apr 5, 2026
Oh yes, that would be great! Don't hesitate to ping me for any review/help 👌
pythongh-140870: PyREPL auto-complete module attributes in import sta…
loic-simon commentedon Jun 2, 2026
Hey, should this change be included in the What's New?
Since there is already a "default interactive shell" section with fancycompleter changes, I guess it would make sense?
loic-simon commentedon Jul 18, 2026
Gentle ping @pablogsal (as you merged this) and @hugovk (as What's New editor), happy to draft a PR if needed, I'm not sure what the process is :)
Add pythongh-140870 (PyREPL import attributes completion) to What's New
gh-140870: Add PyREPL's module attributes import completion feature t…
[3.15] gh-140870: Add PyREPL's module attributes import completion fe…
pythongh-140870: Add PyREPL's module attributes import completion fea…