relational_error_parsing_function

​

Overview

​

Function Signature

def relational_error_parsing_function(
    entrypoint,
    flag: str = ""
) -> Tuple[str, str, str]

​

Parameters

​

Returns

​

Behavior

1. Executes the command specified in entrypoint
2. Captures any errors that occur during execution
3. Parses the error traceback to identify involved files
4. If -r flag is provided:
   • Builds a dependency graph of file relationships
   • Recursively finds all files connected to error files through imports
5. Packages all relevant file contents using run_mock_repopack()

​

Example Usage

​

Basic Error Parsing

from relational import relational_error_parsing_function

# Execute a Python script and capture error context
traceback, error_info, context = relational_error_parsing_function(
    ['python3', 'app.py']
)

print(f"Error: {error_info}")
print(f"Context includes: {len(context)} characters")

​

Recursive Dependency Collection

# Gather all related files through import relationships
traceback, error_info, context = relational_error_parsing_function(
    ['python3', 'main.py'],
    flag='-r'
)

# Context now includes all files imported by error files
# and their dependencies recursively

​

Notes

• Returns empty strings ("", "", "") if no error occurs
• Uses subprocess.CalledProcessError to capture command failures
• File paths are resolved relative to the current working directory
• The -r flag is useful for understanding complex error contexts across multiple modules