Add cooperative pause and resume for caption jobs

This commit is contained in:
Sleeps
2026-10-07 12:24:55 +01:00
parent 82a8e94d37
commit bc7f7bb880
+57
View File
@@ -28,6 +28,9 @@ class CaptionJobManager:
self._state_lock = threading.Lock()
self._thread: threading.Thread | None = None
self._gpu_busy = False
self._pause_requested = threading.Event()
self._resume_event = threading.Event()
self._resume_event.set()
self._state: dict[str, Any] = {
"running": False,
"stage": "idle",
@@ -39,6 +42,8 @@ class CaptionJobManager:
"failed": 0,
"retained": 0,
"percent": 0.0,
"paused": False,
"pause_requested": False,
}
@property
@@ -61,6 +66,49 @@ class CaptionJobManager:
with self._state_lock:
return deepcopy(self._state)
def pause(self) -> dict[str, Any]:
with self._state_lock:
if not self._state.get("running"):
raise RuntimeError("No captioning job is running.")
if self._state.get("stage") in {"sync", "syncing", "synced"}:
raise RuntimeError("Captioning has finished; the search index is rebuilding.")
self._pause_requested.set()
self._resume_event.clear()
self._state["pause_requested"] = True
return self.status()
def resume(self) -> dict[str, Any]:
with self._state_lock:
if not self._state.get("running"):
raise RuntimeError("No captioning job is running.")
if not self._pause_requested.is_set() and not self._state.get("paused"):
raise RuntimeError("Captioning is not paused.")
self._pause_requested.clear()
self._resume_event.set()
self._state["pause_requested"] = False
self._state["paused"] = False
if self._state.get("stage") == "paused":
self._state["stage"] = "captioning"
return self.status()
def _wait_if_paused(self) -> None:
if not self._pause_requested.is_set():
return
with self._state_lock:
self._state["paused"] = True
self._state["pause_requested"] = True
self._state["stage"] = "paused"
while self._pause_requested.is_set():
self._resume_event.wait(timeout=0.5)
with self._state_lock:
self._state["paused"] = False
self._state["pause_requested"] = False
if self._state.get("running"):
self._state["stage"] = "captioning"
def start(self, library_ids: list[str], *, force: bool = False) -> dict[str, Any]:
library_ids = [str(value).strip() for value in library_ids if str(value).strip()]
if not library_ids:
@@ -70,6 +118,9 @@ class CaptionJobManager:
if self._state.get("running"):
raise RuntimeError("A captioning job is already running.")
self._pause_requested.clear()
self._resume_event.set()
init_db(settings.db_path)
args = SimpleNamespace(
force=force,
@@ -114,6 +165,8 @@ class CaptionJobManager:
"failed": 0,
"retained": 0,
"percent": 0.0 if rows else 100.0,
"paused": False,
"pause_requested": False,
}
if not rows:
@@ -240,6 +293,7 @@ class CaptionJobManager:
progress=general_progress,
total_frames=frames_total,
frame_source=frame_source,
before_frame=self._wait_if_paused,
)
if specialist_rows:
@@ -263,11 +317,14 @@ class CaptionJobManager:
completed_offset=general_done,
total_frames=frames_total,
frame_source=frame_source,
before_frame=self._wait_if_paused,
)
completed = general_done + specialist_done
failed = missing + general_failed + specialist_failed
self._wait_if_paused()
self._progress(
{
"stage": "syncing",