Coverage for src / lexigram / contracts / web / controller.py: 100%

1"""Web framework controller protocol.""" 

2 

3from __future__ import annotations 

4 

5from typing import Any, Protocol, runtime_checkable 

6 

7 

8@runtime_checkable 

9class ControllerProtocol(Protocol): 

10 """Structural protocol for controller objects. 

11 

12 Defines the minimum surface expected of any controller: the ability 

13 to enumerate its declared routes. Type-check against this protocol 

14 instead of the concrete ``Controller`` base class where possible. 

15 """ 

16 

17 @classmethod 

18 def collect_routes(cls) -> list[dict[str, Any]]: 

19 """Return route-definition dictionaries declared on this controller.""" 

20 ... 

21 

22 

23__all__ = ["ControllerProtocol"]