Struct ContainmentContext 

pub struct ContainmentContext { /* private fields */ }

Tracks containment context during graph generation.

Maintains a stack of currently open containers based on line ranges, enabling determination of parent-child relationships for nested entities.

Example

use codeprysm_core::parser::ContainmentContext;

let mut ctx = ContainmentContext::new();

// Processing a class definition at lines 10-50
ctx.push_container("file.py:MyClass".to_string(), "Container".to_string(), 10, 50, "MyClass".to_string());

// Inside the class, push a method at lines 15-25
ctx.update(15);
ctx.push_container("file.py:MyClass:method".to_string(), "Callable".to_string(), 15, 25, "method".to_string());

// Get the containment path
assert_eq!(ctx.get_containment_path(), vec!["MyClass", "method"]);

// After the method ends, update pops it
ctx.update(30);
assert_eq!(ctx.get_containment_path(), vec!["MyClass"]);

Implementations

impl ContainmentContext

pub fn new() -> Self

Create a new empty containment context.

pub fn update(&mut self, current_line: usize)

Update the stack by popping containers that have ended.

Call this before processing each new entity to ensure the stack reflects the current position in the source file.

pub fn push_container( &mut self, node_id: String, node_type: String, start_line: usize, end_line: usize, entity_name: String, )

Push a new container onto the stack.

Only Container and Callable types can contain other entities.

pub fn get_current_parent_id(&self) -> Option<&str>

Get the node ID of the current innermost container.

Returns None if at file level (no active containers).

pub fn get_containment_path(&self) -> Vec<&str>

Get the full containment path as a list of entity names.

Returns the path from outermost to innermost container.

pub fn is_container_active(&self, node_id: &str) -> bool

Check if a container is currently active (on the stack).

pub fn depth(&self) -> usize

Get the current stack depth.

pub fn is_empty(&self) -> bool

Check if the stack is empty (at file level).

pub fn clear(&mut self)

Clear the containment stack (typically called between files).

pub fn stack(&self) -> &[ContainmentEntry]

Get a reference to the current stack.

Trait Implementations

impl Debug for ContainmentContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ContainmentContext

fn default() -> ContainmentContext

Returns the “default value” for a type.

impl Display for ContainmentContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.