haive.core.utils.debugkit.tracing.execution

Code Tracing and Inspection Utilities

Provides powerful tracing capabilities for understanding code execution flow, function calls, variable changes, and performance bottlenecks.

Classes

CallTracker	Track function calls and execution flow.
TracingUtilities	Enhanced tracing utilities with multiple backends.
VariableTracker	Track variable changes during execution.

Module Contents

class haive.core.utils.debugkit.tracing.execution.CallTracker

Track function calls and execution flow.

add_filter(pattern)

Add a filter pattern for calls to track.

Parameters:

pattern (str)

Return type:

None

clear()

Clear call history.

Return type:

None

disable()

Disable call tracking.

Return type:

None

enable()

Enable call tracking.

Return type:

None

get_stats()

Get call statistics.

Return type:

dict[str, Any]

remove_filter(pattern)

Remove a filter pattern.

Parameters:

pattern (str)

Return type:

None

should_track(function_name, filename)

Check if a call should be tracked based on filters.

Parameters:

• function_name (str)

• filename (str)

Return type:

bool

track_call(func)

Decorator to track function calls.

Parameters:

func (collections.abc.Callable)

Return type:

collections.abc.Callable

class haive.core.utils.debugkit.tracing.execution.TracingUtilities

Enhanced tracing utilities with multiple backends.

calls(func=None, filters=None)

Trace function calls.

Parameters:

• func (collections.abc.Callable | None)

• filters (list[str] | None)

Return type:

collections.abc.Callable

clear()

Clear all tracing data.

Return type:

None

hunt(condition='call', **kwargs)

Use hunter for advanced tracing if available.

Parameters:

condition (str)

Return type:

None

profile_calls(func)

Profile function calls with detailed timing.

Parameters:

func (collections.abc.Callable)

Return type:

collections.abc.Callable

report(filename=None)

Generate a comprehensive tracing report.

Parameters:

filename (str | None)

Return type:

str

snoop(func=None, **kwargs)

Trace function execution with pysnooper if available.

Parameters:

func (collections.abc.Callable | None)

Return type:

collections.abc.Callable

stack(limit=None)

Get formatted call stack.

Parameters:

limit (int | None)

Return type:

str

stats()

Get comprehensive tracing statistics.

Return type:

dict[str, Any]

trace_context(name='trace')

Context manager for tracing a block of code.

Parameters:

name (str)

vars(**kwargs)

Track variable changes.

Return type:

None

class haive.core.utils.debugkit.tracing.execution.VariableTracker

Track variable changes during execution.

clear()

Clear tracking history.

Return type:

None

disable()

Disable variable tracking.

Return type:

None

enable()

Enable variable tracking.

Return type:

None

get_history(var_name=None)

Get change history for a variable or all variables.

Parameters:

var_name (str | None)

Return type:

list[dict[str, Any]]

track(name, value)

Track a variable change.

Parameters:

• name (str)

• value (Any)

Return type:

None