frames - Chirp

server.debug.frames

module

Traceback frame extraction and framework collapsing.

server.debug.frames

Name	Type	Default	Description
`type`		—
`qualified_name`		—
`element_type`		—
`description`		—
`source_file`		—
`line_number`		—
`is_autodoc`		—
`autodoc_element`		—
`_autodoc_template`		—
`_autodoc_url_path`		—
`_autodoc_page_type`		—
`title`		—
`doc_content_hash`		—

Symbols on this page

Extracted traceback frame with source context and locals.

Consecutive non-app frames collapsed into a summary.

True if the frame is from the application (not stdlib/site-packages).

Walk a traceback and extract frame info with source context and locals.

Collapse consecutive non-app (framework) frames into a summary.

Reduces traceback noise from middleware, ASGI adapters, etc. Returns a mix of frame dicts and collapsed-group…

FrameInfo

class

Extracted traceback frame with source context and locals.

CollapsedFrameGroup

class

Consecutive non-app frames collapsed into a summary.

_is_app_frame

function

def _is_app_frame(filename: str) -> bool

True if the frame is from the application (not stdlib/site-packages).

Parameters

Name	Type	Default	Description
`filename`	`str`	—

_extract_frames

function

def _extract_frames(tb: types.TracebackType | None) -> list[FrameInfo]

Walk a traceback and extract frame info with source context and locals.

Parameters

Name	Type	Default	Description
`tb`	`types.TracebackType \| None`	—

_collapse_framework_frames

function

def _collapse_framework_frames(frames: list[FrameInfo], min_collapse: int = 3) -> list[FrameInfo | CollapsedFrameGroup]

Collapse consecutive non-app (framework) frames into a summary.

Reduces traceback noise from middleware, ASGI adapters, etc. Returns a mix of frame dicts and collapsed-group dicts.

Parameters

Name	Type	Default	Description
`frames`	`list[FrameInfo]`	—
`min_collapse`	`int`	`3`