bookclerk_plugin_sdk.sparse_workerd.smoke
Out-of-tree workerd plugin smoke: ensure → materialize → describe + health.
Spawns the pinned Cloudflare workerd with a materialized Cap'n Proto config
and POSTs describe (plus a POST /invoke health call for storefront,
remoteLibrary, metadata, covers, metadataFiles, notifier and ai guests) to the HTTP bridge. Does not require the Rust
bookclerk-workerd binary.
def run_smoke(plugin_dir: Path) -> str
Smoke a workerd plugin without the Rust bookclerk-workerd binary.
Args
plugin_dir: Path to aruntime = "workerd"plugin root.
Returns
Multi-line status including plugin id and JSON describe/health detail.
Raises
FileNotFoundError: Ifplugin.tomlis missing.ValueError: If the manifest is invalid or not a workerd plugin.TimeoutError: If the bridge health endpoint never becomes ready.RuntimeError: If the describe/health bridge call fails.
Examples
>>> # print(run_smoke(Path("./my-workerd-plugin")))
Generated from packages/plugin-sdk-python at main · View as Markdown