infra

from corio import infra

infra is the release/build orchestration layer used by corio projects.

Core objects:

Project: package metadata + runtime release context
Repository: git operations (fetch, tagging, push flow)
Stack: container build/deploy definitions (development and production variants)
Releaser: version increment, package build/upload, docs deploy flow
infrastructure.api.Api: FastAPI surface for release/build/recreate operations

Install:

pip install "corio[infra]" --upgrade

Typical Usage

from corio import infra

project = infra.Project("corio")
project.releaser.run(build=False, release=True, cache=True)

API Usage

infra.Api exposes release/build/recreate endpoints and is used by infra wrapper repos:

from corio import infra

infra.Api.launch()

Docs Release Expectations

Docs release expects:

docs/ content in repo root
tool.corio.metadata.docs.nav in pyproject.toml

ReleaseDocumentation builds MkDocs configuration dynamically from project metadata, so nav structure in pyproject is part of the release contract.

Release Flow (high-level)

releaser.run(...) orchestrates:

version increment + git/tag flow
optional container build/push
package build/upload
docs deploy