Skip to main content

Module platform

Module platform 

Source
Expand description

DuckDB build platform validation.

DuckDB community extensions must build for a standard set of platforms. Extensions that cannot support a platform must declare it in extension.excluded_platforms. This module validates those declarations.

§Reference

The list below is derived from config/distribution_matrix.json in duckdb/extension-ci-tools, which is the file the community-extensions build actually reads. scripts/check-platform-table.py re-derives it and fails CI when the two diverge, because a stale list is worse than none: it rejects platforms that exist and accepts ones that do not.

Constants§

DUCKDB_CI_PLATFORMS
The platforms the community-extension CI actually builds.
DUCKDB_OPT_IN_PLATFORMS
The DUCKDB_CI_PLATFORMS that are opt-in: the community CI does not build them unless an extension asks for them.
DUCKDB_PLATFORMS
Every platform identifier validate_platform recognises.
DUCKDB_PLATFORM_GROUPS
The group names distribution_matrix.json organises its architectures under, which appear in real excluded_platforms fields.
DUCKDB_RETIRED_PLATFORMS
Platforms DuckDB no longer builds, which validate_excluded_platforms nevertheless accepts.

Functions§

is_opt_in_platform
Returns true if platform is only built when an extension opts into it.
validate_excluded_platforms
Validates a list of excluded platform identifiers.
validate_platform
Validates that a platform identifier is a known DuckDB build target.