Metadata-Version: 2.4
Name: provisa-duckdb-ext
Version: 0.1.1
Summary: Pinned, per-platform DuckDB extension binaries for the Provisa embedded tier (PyPI-delivered, offline).
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: duckdb==1.5.5

# provisa-duckdb-ext

Pinned, per-platform DuckDB extension binaries for the [Provisa](https://github.com/kenstott/provisa)
embedded tier, delivered via PyPI.

## Why this package exists

The extensions the embedded DuckDB engine loads (`sqlite_scanner`, `iceberg`, `delta`,
`postgres_scanner`, …) are not statically linked into the `duckdb` PyPI wheel — DuckDB fetches them
from `extensions.duckdb.org` at runtime. Behind an enterprise firewall where only PyPI/Maven/npm/NuGet
are proxied (Artifactory), that host is unreachable and the embedded tier breaks.

This package embeds the pinned, per-platform `.duckdb_extension` binaries as ordinary wheel data so
acquisition flows through PyPI instead. One universal wheel carries every platform. Provisa's
`provisa.federation.duckdb_extensions.stage_bundled_extensions` copies the running platform's blobs
into a writable directory on first run and points `PROVISA_DUCKDB_EXT_DIR` at it.

Extensions are locked to the exact DuckDB build they were mirrored from, so an incompatible `duckdb`
version can never silently load a mismatched extension.

This package is a dependency of Provisa's embedded tier — install `provisa` directly rather than this
package on its own.
