Class TrackedPopen

ci/util/pio_process_killer.py:284–410

Context manager wrapper for subprocess.Popen with automatic tracking. Usage: with TrackedPopen(["pio", "run"], cwd=build_dir) as proc: stdout, stderr = proc.communicate() # Process automatically unregistered on exit Or without context manager: proc =

class TrackedPopen:
    """Context manager wrapper for subprocess.Popen with automatic tracking.

    Usage:
        with TrackedPopen(["pio", "run"], cwd=build_dir) as proc:
            stdout, stderr = proc.communicate()
            # Process automatically unregistered on exit

    Or without context manager:
        proc = TrackedPopen(["pio", "run"], cwd=build_dir)
        proc.wait()
        proc.unregister()  # Must call manually when not using context manager
    """

    def __init__(
        self,
        args: list[str] | str,
        cwd: str | None = None,
        env: dict[str, str] | None = None,
        shell: bool = False,
        stdout: int | None = None,
        stderr: int | None = None,
        stdin: int | None = None,
        text: bool = False,
        **kwargs: Any,
    ) -> None:
        """Create and register a tracked subprocess.

        Args:
            args: Command to execute
            cwd: Working directory
            env: Environment variables
            shell: Use shell execution
            stdout: stdout handling (e.g., subprocess.PIPE)
            stderr: stderr handling
            stdin: stdin handling
            text: Text mode for I/O
            **kwargs: Additional arguments for subprocess.Popen
        """
        self._proc = subprocess.Popen(
            args,
            cwd=cwd,
            env=env,
            shell=shell,
            stdout=stdout,
            stderr=stderr,
            stdin=stdin,
            text=text,
            **kwargs,
        )
        register_pio_process(self._proc)

    @property
    def proc(self) -> subprocess.Popen[Any]:
        """Get the underlying Popen instance."""
        return self._proc

    @property