archivebox.progressmonitor.views

Module Contents

Functions

progress_endpoint

Return the canonical same-origin progress endpoint for monitor embeds.

_live_progress_plugin_names

_hook_details

_process_label

live_progress_view

Read-only live progress; keep the server-side request below 100 ms.

API

archivebox.progressmonitor.views.progress_endpoint(scope: Literal[crawl, snapshot] | None = None, object_id: object | None = None) → str[source]

Return the canonical same-origin progress endpoint for monitor embeds.

archivebox.progressmonitor.views._live_progress_plugin_names() → tuple[frozenset[str], frozenset[str]][source]
archivebox.progressmonitor.views._hook_details(hook_name: str, plugin: str = 'setup') → tuple[str, str, str, str][source]
archivebox.progressmonitor.views._process_label(cmd: list | None) → tuple[str, str, str, str][source]
archivebox.progressmonitor.views.live_progress_view(request, *, authorized_snapshot=None)[source]

Read-only live progress; keep the server-side request below 100 ms.

Every caller, including snapshot replay, must use bounded DB reads and cached metadata only. Never walk, stat, open, or reconcile archive/persona files here, probe Supervisor, or perform network/subprocess work. Captures publish their state to the DB; file existence and freshness belong to the separate output/image request. Do not scan history or rebuild inventories in this one-second polling path; expensive totals belong off the request.