sonnet-core

Framework-agnostic core library for Petrarca Labs backend services.

sonnet-core is the foundation layer beneath sonnet-server. It holds pure data-layer and logic building blocks that carry no web/server framework dependency (no FastAPI, uvicorn, Alembic, Typer, or Jinja2). It may depend on data-modeling libraries (Pydantic, SQLAlchemy, SQLModel) and pure utilities (jsonschema, arrow, loguru).

Layering

sonnet-core    (this package -- pure data/logic)
   ^
sonnet-server  (web/server framework)
   ^
sonnet-auth / sonnet-graph / sonnet-storage

Contents

• ids -- compact, time-sortable id generation (generate_id, to_base36).
• models -- Pydantic/SQLModel model building and conversion (create_model, ModelBuilder, to_response_model, update_model_fields).
• schema -- JSON Schema validation helpers (validate_instance, validate_schema, ValidationResult).
• enums -- constraint-free enum columns (str_enum_column).
• versioning -- version-string ordering (pick_latest).