abx-plugins

name	abx-plugins
description	Use this when working on ArchiveBox plugin hooks, config schemas, hook ordering, browser helpers, required binaries, and plugin tests.

abx-plugins

Purpose

abx-plugins contains standalone hook scripts and config schemas used by ArchiveBox and abx-dl.

Shared Rules

• Keep this repo on branch main.
• Use uv and uv run for Python commands.
• Do not use system python, direct .venv/bin/python, or pip commands.
• Use real hook scripts, real installs, real browsers, real subprocesses, real files, and real URLs or pytest-httpserver.
• Do not mock, monkeypatch, fake, simulate, skip, xfail, or weaken tests.
• Verify JSONL records, exit codes, config hydration, output files, and filesystem side effects.
• Read README.md for the full plugin contract, hook lifecycle, config schema, and test surface.

Development Setup

set -euo pipefail
uv sync --inexact
uv run --no-sync --no-sources python - <<'PY'
from pathlib import Path

import abx_plugins

package = Path(abx_plugins.__file__).resolve().parent
plugins = {path.name for path in (package / "plugins").iterdir() if path.is_dir()}
assert {"base", "chrome", "hashes", "title", "wget"} <= plugins
PY