IPython Session Inspector

A utility tool that provides comprehensive namespace management and variable inspection capabilities for IPython sessions.

Capabilities

Initialize Custom Namespace

Create an IPython session with a predefined set of variables that should be available immediately upon session start.

• Starting an IPython session with custom variables x=10, y=20, and name="test" makes these variables immediately accessible @test
• Starting a session with an empty custom namespace results in only IPython's built-in variables being present @test

List Variables by Type

Inspect and filter the current namespace to show only variables of specific types.

• Listing all integer variables in a namespace containing a=5, b="hello", and c=3.14 returns only a and excludes b and c @test
• Listing all string variables in a namespace containing x=10, y="world", and z="python" returns only y and z @test

Clear Namespace Selectively

Remove variables from the current namespace based on specific criteria without restarting the session.

• Clearing all user-defined variables from a namespace while preserving IPython built-ins leaves only the built-in variables @test
• After defining variables a=1, b=2, c=3 and clearing only variables matching pattern a and b, only c remains @test

Generate Variable Report

Create a detailed report of all variables in the current namespace including their types, values, and memory information.

• Generating a report for a namespace with count=42 and message="hello" includes variable names, types (int, str), and values @test
• Generating a report for an empty user namespace (after clearing all user variables) shows only IPython internal variables @test

Implementation

@generates

API

"""IPython Session Inspector - Namespace management utilities"""

def create_session_with_namespace(variables: dict) -> None:
    """
    Create an IPython session with a custom initial namespace.

    Args:
        variables: Dictionary of variable names to values to initialize in the session
    """
    pass

def list_variables_by_type(type_name: str) -> list:
    """
    List all variables in the current namespace of a specific type.

    Args:
        type_name: The type to filter by (e.g., 'int', 'str', 'list')

    Returns:
        List of variable names matching the specified type
    """
    pass

def clear_namespace(keep_pattern: str = None) -> None:
    """
    Clear variables from the current namespace.

    Args:
        keep_pattern: Optional pattern of variable names to keep (e.g., 'a|b' keeps variables a and b)
                     If None, clears all user-defined variables
    """
    pass

def generate_variable_report() -> dict:
    """
    Generate a detailed report of all variables in the current namespace.

    Returns:
        Dictionary with variable names as keys and dictionaries containing 'type' and 'value' as values
    """
    pass

Dependencies { .dependencies }

IPython { .dependency }

Provides interactive computing and namespace management capabilities.

@satisfied-by