Class PyThread

src/pystack/types.py:104–168

@dataclass
class PyThread:
    tid: int
    frame: Optional[PyFrame]
    native_frames: List[NativeFrame]
    holds_the_gil: int
    is_gc_collecting: int
    python_version: Optional[Tuple[int, int]]
    name: Optional[str] = None

    @property
    def frames(self) -> Iterable[PyFrame]:
        yield from filter(lambda frame: not frame.is_shim, self.all_frames)

    @property
    def first_frame(self) -> Optional[PyFrame]:
        return next(iter(self.frames), None)

    @property
    def all_frames(self) -> Iterable[PyFrame]:
        current_frame = self.frame
        while current_frame is not None:
            yield current_frame
            current_frame = current_frame.next

    @property
    def status(self) -> str:
        status = []
        gil_status = self.gil_status
        gc_status = self.gc_status
        if self.tid == 0:
            status.append("Thread terminated")
        if gil_status:
            status.append(gil_status)
        if gc_status:
            status.append(gc_status)
        return "[" + ",".join(status) + "]"

    @property
    def gc_status(self) -> str:
        if self.native_frames:
            gc_symbols = {"gc_collect", "collect", "collect.constrprop"}
            if any(
                gc_symbol in frame.symbol
                for gc_symbol in gc_symbols
                for frame in self.native_frames
            ):
                return "Garbage collecting"
            return ""

        if self.is_gc_collecting != -1:
            if self.is_gc_collecting == 1 and self.holds_the_gil:
                return "Garbage collecting"
            return ""

        return ""

    @property
    def gil_status(self) -> str: