Core Components

Core Components

Position

The Position class is the foundation for tracking node locations:

from tree_interval import Position

# Basic position
pos = Position(start=0, end=100)

# With line numbers
pos.lineno = 1
pos.end_lineno = 5

# With column offsets
pos.col_offset = 4
pos.end_col_offset = 24

# Access metrics
print(f"Size: {pos.end - pos.start}")  # 100
print(f"Span: {pos.lineno}-{pos.end_lineno}")  # 1-5

Leaf

Leaf nodes form the tree structure:

from tree_interval import Leaf, Position

# Create hierarchy
root = Leaf(Position(0, 100), info="Root")
child = Leaf(Position(10, 50), info="Child")
root.add_child(child)

# Navigation
parent = child.parent  # Get parent
siblings = child.siblings  # Get siblings
children = root.children  # Get children

### Navigation Methods

The `Leaf` class provides methods for navigating between nodes:

```python
# Get parent node
parent = node.parent  # Returns parent node or None

# Get next sibling
next_sibling = node.next  # Returns next sibling or None

# Get previous sibling
prev_sibling = node.previous  # Returns previous sibling or None

# Example usage
if node.parent:
    print(f"Parent info: {node.parent.info}")
    
if node.next:
    print(f"Next sibling: {node.next.info}")
    
if node.previous:
    print(f"Previous sibling: {node.previous.info}")

Search

func_node = root.find(lambda n: n.info.get("type") == "FunctionDef")
parent = child.find_parent(lambda n: n.info.get("type") == "Module")

Future

The Future class provides dynamic attribute handling with contextual error reporting:

from tree_interval import Future
from inspect import stack

class Nested:
    def __init__(self) -> None:
        self.__dict__ = {}
        
    def __getattr__(self, name: str):
        return Future(name, 
                     frame=stack()[1].frame,
                     instance=self,
                     new_return=type(self)())

# Usage
obj = Nested()
obj.a.b.c = 42  # Creates chain dynamically
print(obj.a.b.c)  # 42
print(obj.x.y.z)  # Raises detailed error with context
"""
AttributeError: Attribute x not found in obj
    print(obj.x.y.z)
    ~~~~~~^^^^▲^^^^~
"""

Key Features:

• Automatic attribute chain creation
• Context-aware error reporting
• Stack trace analysis
• Smart attribute access handling