sheafcommons 0.1.0a1

Stable qualified names and immutable metadata contracts for SheafLab packages.

sheafcommons

sheafcommons contains small, dependency-free contracts for values that need to cross package boundaries without becoming ad-hoc strings or mutable dicts. The first release provides qualified names and immutable metadata with explicit merge conflict handling.

from sheafcommons import Metadata, QualifiedName

asset = QualifiedName.parse("vision:camera/front")
labels = Metadata.from_mapping({"owner": "capture", "tier": "primary"})
merged = labels.merge(Metadata.from_mapping({"format": "rgb"}))

assert str(asset) == "vision:camera/front"
assert merged["format"] == "rgb"

QualifiedName keeps a namespace separate from its local identifier. Metadata preserves sorted, immutable entries and rejects conflicting values by default, making ownership changes visible at composition boundaries.