A productivity extension for Python developers using the Role Delegation pattern (e.g., Role[T]).

Navigate through your complex object hierarchies with ease. Stop fighting __getattr__ and start coding.

Features

Recursive Autocomplete: Automatically discovers attributes across nested Role proxies.
Intelligent Navigation: Ctrl + Click (or Cmd + Click) on delegated attributes (name, age, company) warps your cursor directly to the source declaration, bypassing the dynamic __getattr__ call.
Pylance Synergy: Intelligently detects native class attributes to avoid duplicate definition popups, providing a seamless "native-feel" experience.

Getting Started

Install the extension from the VS Code Marketplace.

Ensure your Python classes follow the standard Role pattern:

@dataclass
class Role(Generic[RoleTakerT]):
    _taker: RoleTakerT

    def __getattr__(self, attribute_name: str) -> Any:
         return getattr(self._taker, attribute_name)

 @dataclass
 class Person:
     name: str
     age: int

 @dataclass
 class Teacher(Role[Person])
     courses: List

 teacher = Teacher(_taker=Person("Ahmed", 20))
 # you can now access Person attributes as if it was inheritance, with hints from IDE and CTRL+Click working.
 teacher.name
 teacher.age

How it works

This extension performs static analysis of your class hierarchy to map Role relations. When you navigate to a definition, the extension intercepts the request. If the field is defined natively on the class, it defers to Pylance. If the field is delegated, it recursively resolves the composition chain and teleports you to the absolute origin of the attribute.