bookclerk_workerd::pin

Development These docs follow the development version and change with every merge.

Last updated View as Markdown

Pinned Cloudflare workerd release metadata shared with bookclerk-dev.

Source of truth: ../workerd-pin.json (do not edit this file by hand). Bumped by scripts/bump-workerd-pin.py (CI: .github/workflows/workerd-pin-bump.yml) with a 7-day publish cooldown for supply-chain safety. Regenerated by scripts/sync-workerd-pin.py.

Item Kind Summary
WorkerdAsset struct GitHub release asset name + sha256 (hex) of the .gz payload.
asset_for_target function Look up the pinned download asset for a std::env::consts OS/arch pair.
host_asset function Resolve the release asset for the compiling host OS/arch.
download_url function Build the GitHub release download URL for a pinned artifact name.
pyodide_bundle_url function Download URL of the pinned Pyodide bundle.
binary_name function On-disk binary name after extracting the gzipped release asset.
BUNDLED_WORKERD_COMPAT_DATE constant Newest compatibility date this Bookclerk build claims to understand.
WORKERD_RELEASE_TAG constant GitHub release tag (includes leading v).
WORKERD_VERSION_STAMP constant Filename written beside the binary so ensure can skip re-downloads.
PYODIDE_BUNDLE_FILE constant Pyodide runtime bundle file the pinned workerd loads for Python isolates.
PYODIDE_BUNDLE_SHA256_HEX constant Expected SHA-256 hex digest of PYODIDE_BUNDLE_FILE.
PYODIDE_BUNDLE_DIR constant Directory beside the workerd binary that holds PYODIDE_BUNDLE_FILE; workerd reads it through --pyodide-bundle-disk-cache-dir.

Structs

WorkerdAsset

pub struct WorkerdAsset {
    pub artifact: &'static str,
    pub sha256_hex: &'static str,
}

GitHub release asset name + sha256 (hex) of the .gz payload.

Fields

  • artifact: Cloudflare release asset filename (for example workerd-linux-64.gz).
  • sha256_hex: Expected SHA-256 hex digest of the gzipped download bytes.

Implements: Clone, Copy, Debug, Eq, PartialEq

Functions

asset_for_target

pub fn asset_for_target(os: &str, arch: &str) -> Option<WorkerdAsset>

Look up the pinned download asset for a std::env::consts OS/arch pair.

Arguments

  • os - Host OS string (linux, macos, or windows).
  • arch - Host CPU string (x86_64 or aarch64).

Returns

WorkerdAsset when the pin JSON lists that target; otherwise None.

host_asset

pub fn host_asset() -> Option<WorkerdAsset>

Resolve the release asset for the compiling host OS/arch.

download_url

pub fn download_url(artifact: &str) -> String

Build the GitHub release download URL for a pinned artifact name.

Arguments

Returns

Absolute https://github.com/cloudflare/workerd/releases/download/... URL.

pyodide_bundle_url

pub fn pyodide_bundle_url() -> String

Download URL of the pinned Pyodide bundle.

binary_name

pub fn binary_name() -> &'static str

On-disk binary name after extracting the gzipped release asset.

Constants

BUNDLED_WORKERD_COMPAT_DATE

pub const BUNDLED_WORKERD_COMPAT_DATE: &str = "2026-11-13";

Newest compatibility date this Bookclerk build claims to understand.

WORKERD_RELEASE_TAG

pub const WORKERD_RELEASE_TAG: &str = "v1.20261113.1";

GitHub release tag (includes leading v).

WORKERD_VERSION_STAMP

pub const WORKERD_VERSION_STAMP: &str = "workerd.version";

Filename written beside the binary so ensure can skip re-downloads.

PYODIDE_BUNDLE_FILE

pub const PYODIDE_BUNDLE_FILE: &str = "pyodide_0.28.2_2025-01-16_20.capnp.bin";

Pyodide runtime bundle file the pinned workerd loads for Python isolates.

PYODIDE_BUNDLE_SHA256_HEX

pub const PYODIDE_BUNDLE_SHA256_HEX: &str = "330d40e5bb3762cd54890d09122e173fca689ec420a98a1dd475215724e3df7d";

Expected SHA-256 hex digest of PYODIDE_BUNDLE_FILE.

PYODIDE_BUNDLE_DIR

pub const PYODIDE_BUNDLE_DIR: &str = "pyodide-bundles";

Directory beside the workerd binary that holds PYODIDE_BUNDLE_FILE; workerd reads it through --pyodide-bundle-disk-cache-dir.

Generated from crates/bookclerk-workerd at main · View as Markdown