No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-20 06:05:14 +00:00
.forgejo/workflows Open an issue when CI fails on main 2026-11-18 22:25:00 +01:00
index.json chore: rebuild marketplace index 2026-11-20 06:05:14 +00:00
README.md docs: third-party features are listed by splent feature:release, not by pull request 2026-11-09 00:29:20 +01:00
registry.toml docs: third-party features are listed by splent feature:release, not by pull request 2026-11-09 00:29:20 +01:00

splent_index

The published SPLENT marketplace index.

index.json is a regenerable cache derived from the real sources of truth. Each feature's auto-generated [tool.splent.contract] is read from pyproject.toml at its latest released tag, and the SPL lines (UVL variability models) come from the marketplace at https://marketplace.splent.io, each at the DOI it publishes. Nothing here is edited by hand. If the index is ever stale or wrong, it is simply rebuilt.

How it works

  • Publishing a feature means releasing it. splent feature:release tags the repo, and this index picks the tag up on the next build. Nothing is uploaded. The contract is always read from the released tag.
  • Publishing an SPL goes through the marketplace. splent spl:publish sends the model to the marketplace, which publishes it on UVLHub and records its DOI. This index picks the line up from the marketplace's public /api/v1/spls on the next build.
  • The build is one CLI command. CI runs splent marketplace:index --registry registry.toml --output index.json on every push to main, every 6 hours and on demand, then commits index.json back. A push that only changes index.json does not trigger it again.
  • Third-party features are listed by their release. Sign in once with splent login and release with splent feature:release. The release tells the marketplace where the repository is, and the next build reads its contract at the latest tag. The build merges those listings, from the marketplace's public /api/v1/features, with registry.toml, which only names the official splent-io org. A listed repository that cannot be read is reported as a problem and never stops the build.

Consuming the index

The marketplace web app reads this file by default. The splent CLI (feature:search, feature:info) reads the workspace copy that splent marketplace:index writes, and this file only when SPLENT_INDEX_URL points at it. Point a workspace at the published copy like this.

SPLENT_INDEX_URL=https://git.splent.io/splent-io/splent_index/raw/branch/main/index.json

Or build a copy from your workspace with splent marketplace:index --local.