Python Override Mark

Inline CodeLens indicators for overridden and implemented methods in Python.

Technical Overview

Cross-File Support: Works across your workspace.
Implementation Detection: Identifies methods that are implemented/overridden by parent/subclasses.
Optional Gutter Markers: Shows gutter icons for overrides and subclass implementations.
Hover Navigation: Shows hover details with navigation links for overrides and subclass implementations.
CodeLens Navigation:
- Overrides: Click the "Overrides Parent.method" CodeLens to navigate to the parent definition.
- Implementations: Click "Implemented in Child.method" to navigate to the subclass implementation.
- Multiple Implementations: If multiple subclasses implement a method, a dropdown allows you to choose which one to navigate to.
Deep Inheritance Support: Detects overrides across multiple levels of inheritance Bread -> Sandwich -> Burger

Inheritance CodeLens

Hover Navigation

Gutter Navigation

Inlay Hint Navigation

The Python extension for VS Code (ms-python.python) must be installed and active.

Setting	Description
`pythonOverrideMark.display.codeLens`	Enable CodeLens indicators and navigation for overrides and methods implemented in subclasses. Default is `true`
`pythonOverrideMark.display.gutterIcons`	Enable gutter icons for overrides and methods implemented in subclasses. Default is `false`
`pythonOverrideMark.display.hover`	Enable hover details and navigation links for overrides and methods implemented in subclasses. Default is `true`
`pythonOverrideMark.display.inlayHints`	Enable inline Inlay Hints for overrides and methods implemented in subclasses. Default is `false`
`pythonOverrideMark.performance.debounceDelay`	Delay in milliseconds before updating marks after typing. Default is 500
`pythonOverrideMark.performance.maxInheritanceDepth`	Maximum depth to search for parent classes. Default is 3. Set to 0 for unlimited

This extension uses the VS Code Python extension's Language Server Protocol (LSP) features to analyze your code:

Override Detection: It scans the active document for class definitions and resolves their parent classes (even across files). It then compares methods to identify overrides.
Implementation Detection: It finds references to the current class to identify subclasses. It then checks those subclasses for methods that implement or override methods in the parent.
Gutter Markers: Gutter icons are visual indicators. Direct gutter icon clicks are not supported by the VS Code API.
Hover Navigation: Hover details can include navigation links that use the same commands as CodeLens navigation.
Performance: Detection is debounced (default 500ms) and optimized to skip non-class symbols to ensure a smooth editing experience.

Toggle Settings: Add a setting to toggle "Parent -> Child" and "Child -> Parent" lens independently.
Localization: Support multiple languages for CodeLens text.

Contributions are welcome!

Feel free to open an issue for bugs or feature requests, or submit a pull request.