Skip to content

log_data

log_data

Discovery and incremental reading of new-execute bootstrap logs.

LogFile(path: Path, rank: int, modified: int) dataclass

One ranked bootstrap log relevant to a stored run.

discover(directory: Path, run: RunKey, executions: tuple[str, ...] = ()) -> tuple[LogFile, ...] classmethod

Return this run's new-execute log files in machine-rank order.

LogUpdate(reset: bool, lines: tuple[tuple[int, str], ...], partial: tuple[int, str] | None, modified: int, size: int, total_lines: int) dataclass

Complete and partial lines observed during one log read.

LogReader(path: Path, limit: int)

Read an exact, bounded tail once and then follow appended lines.

read() -> LogUpdate

Read the latest tail or the bytes appended since the previous call.