valbridge 1.2.0

Runtime client for valbridge-generated validators with type-safe schema lookup

Runtime client for valbridge-generated Python validators with type-safe schema lookup.

---

Installation

pip install valbridge
# or
uv add valbridge

Quick start

from valbridge import create_valbridge
from _valbridge import schemas

valbridge = create_valbridge(schemas)

# Full namespace:id lookup
user_validator = valbridge("user:Profile")

# Validate data (Pydantic under the hood)
user_validator.validate_python({"name": "Alice", "email": "[e-mail]"})

Default namespace

valbridge = create_valbridge(schemas, default_namespace="user")

# Shorthand for "user:Profile"
profile = valbridge("Profile")

# Full key for other namespaces
config = valbridge("settings:AppConfig")

Key behaviors

• Runtime lookup -- only entries with a runtime validator appear in the schemas object
• Type safety -- invalid keys raise clear errors pointing to valbridge generate
• Pydantic integration -- generated validators are native Pydantic BaseModel classes

Related packages

Package	Purpose
valbridge-core	Core IR and JSON Schema parser
valbridge-pydantic	Pydantic adapter for code generation
valbridge-cli	CLI to generate validators
@vectorfyco/valbridge	TypeScript equivalent

Learn more

• GitHub repository
• Full documentation