Module manager 

The plugin manager: a static JSON registry index of plugin packages, checksum-verified downloads, side-by-side versioned installs, and dre.lock.

Index location: DRE_REGISTRY_URL, default DEFAULT_REGISTRY. It may be an https:// URL, a file:// URL or a plain path. Format: docs/registry.md.

Structs

Artifact

Index

IndexPackage

A plugin package: one executable per platform, serving every plugin in provides.

IndexVersion

Release

One published (non-draft) release of a GitHub repository whose tag is a version.

Enums

Synced

What sync did for one package.

Constants

DEFAULT_HTTP_TIMEOUT

Seconds a download may receive nothing, by default.

DEFAULT_REGISTRY

INDEX_SCHEMA

The index’s current schema. Schema 1 listed single plugins (kind and name); each still reads as a package of that one plugin.

Functions

explain_undeclared

Name the package to declare for each undeclared-plugin error, from DRE’s registry, or say that the registry has no such plugin. The registry is fetched now, so a newly published package is known without a new dre. Unreachable: unchanged.

fetch

Download url (or read a local path or file:// URL). Downloads give up on a connection after 30s and on a response that sends nothing for http_timeout (no total limit, so a slow but healthy download finishes), and are tried 3 times on connection errors, timeouts, 429 (honouring Retry-After) and 5xx.

github_api

The GitHub API DRE talks to: DRE_GITHUB_API_URL (GitHub Enterprise, tests), else GitHub’s.

github_releases

repo’s releases from the GitHub API (DRE_GITHUB_API_URL, GITHUB_TOKEN), skipping drafts and tags that aren’t versions, newest first by version_order. Every page is read: a repository that also releases its plugins (duckdb-v1.0.0) can list many of those first.

http_timeout

How long a download may receive nothing: DRE_HTTP_TIMEOUT, else the project’s flags: http_timeout, else 60 seconds.

install

Download, verify and install one version into <dir>/<package>/<version>/. Returns its lock entry.

install_linked

Install into dir through the shared cache: download there once, then link into dir.

platform

This machine’s platform key in the index: <os>-<arch>, e.g. macos-aarch64.

prefer_stable

The highest of items whose version matches req. When none does, a pre-release counts if its release would match, so * finds 0.0.1-alpha when a plugin has no stable release yet (semver on its own only matches a pre-release that req names explicitly).

registry_url

set_project_http_timeout

flags: http_timeout from the project being run (set once, when it loads).

sync

Make every declared package available, installing what’s missing (unless install is false, in which case missing packages are errors). Honours dre.lock pins, writes new pins.

version_order

Which version is newer: semver precedence, except that numbers inside a pre-release identifier compare as numbers. Semver compares alpha-10 and alpha-9 as text, which puts 0.0.1-alpha-10 before 0.0.1-alpha-9; DRE’s own pre-releases are named 0.0.1-alpha-<n>.