Module pyspy 

py-spy integration for remote Python stack dumps and profiles.

See PS-* and PP-* invariants in introspect module doc.

Structs

PySpyDump

Request a py-spy stack dump from this process.

PySpyFrame

A single frame in a py-spy stack trace.

PySpyLocalVariable

A local variable captured in a py-spy frame.

PySpyOpts

Options controlling py-spy capture behavior.

PySpyProfile

Request a py-spy profile capture from this process.

PySpyProfileOpts

Public JSON-facing options for a py-spy profile capture.

PySpyProfileWorker

Short-lived child actor for profile capture. Separate from PySpyWorker (PP-5).

PySpyRunner

Runs py-spy against the current process.

PySpyStackTrace

A single thread’s stack trace from py-spy --json output.

PySpyWorker

Short-lived child actor that runs py-spy off the ProcAgent handler path. Spawned per-request; self-terminates after reply. Concurrent instances are permitted — py-spy attaches read-only via process_vm_readv and multiple concurrent dumps are safe.

RunPySpyDump

Internal message from ProcAgent to a spawned PySpyWorker. Carries the original caller’s reply port so the worker responds directly without routing back through ProcAgent.

RunPySpyProfile

Internal forwarded message for profile capture.

Enums

PySpyProfileResult

Wire result of a py-spy profile capture. The HTTP handler unwraps this to produce image/svg+xml or ApiError. Not a public JSON contract. See PP-2, PP-3.

PySpyResult

Result of a py-spy stack dump request.

Traits

PySpyDumpClient

The custom client trait for this message type.

PySpyDumpHandler

The custom handler trait for this message type.

PySpyProfileClient

The custom client trait for this message type.

PySpyProfileHandler

The custom handler trait for this message type.