Coverage for src / renaissance / syntax_tree / siblings.py: 0%

1from collections.abc import Sequence 

2from typing import Protocol, Self, runtime_checkable 

3 

4from renaissance.syntax_tree.syntax_node import SyntaxNode 

5from renaissance.syntax_tree.text_segment import TextSegment 

6 

7# TODO: Do we only want to wrap the AST sequence matches in AST pattern matching? 

8# or also the parser output? 

9 

10 

11@runtime_checkable 

12class Siblings[NodeType](TextSegment, Protocol): 

13 """Protocol for contiguous siblings, i.e., a range of syntax nodes. 

14 Siblings is a text segment. 

15 When the range of siblings is empty, the start and end offset of the text segment are the same. 

16 Yet, an offset within the text is available. 

17 

18 Read-only access is enforced "as much as possible" by 

19 exposing only @property getters in the protocol 

20 """ 

21 

22 @property 

23 def syntax_nodes(self) -> Sequence[SyntaxNode[NodeType]]: 

24 """The sequence of SyntaxNodes corresponding to these siblings.""" 

25 ... 

26 

27 @property 

28 def parent(self) -> Self: 

29 """The parent of these siblings. 

30 

31 The property 'parent' is not used to compare siblings. 

32 """ 

33 ... 

34 

35 @property 

36 def original_nodes(self) -> Sequence[NodeType]: 

37 """The sequence of original nodes of these siblings as produced by the parser. 

38 

39 The property 'original_nodes' is not used to compare siblings. 

40 """ 

41 ...