Skip to content

Python navigation bar

BetterPy enriches the Python navigation bar with module-path context, making it easier to understand where the current file sits inside a package.

How to use

Open a Python file and show the IDE navigation bar. The enhanced model contributes Python-aware path elements for packages, modules, classes, and functions.

Example

For a file such as:

shop/orders/service.py

with a caret inside:

class CheckoutService:
    def submit(self):
        ...

the navigation bar can expose the project/package path and the Python structure around the caret, so jumping to nearby modules or enclosing declarations takes fewer clicks.

What it supports

  • Python package and module path display.
  • Navigation bar entries for Python source structure.
  • Standard navigation-bar selection and keyboard interaction.
  • Projects with nested source roots and package directories.

What it deliberately avoids

  • Changing file contents or import paths.
  • Replacing PyCharm's project view.
  • Inventing entries for unresolved or non-Python files.

Notes

  • The feature is passive once enabled; use the IDE navigation bar as usual.
  • The feature is gated by the Python navigation bar setting under Settings | BetterPy | IDE Customization | Navigation.