chkit-py 0.1.0

ClickHouse schema and migration toolkit for Python (port of chkit TS)

chkit (Python)

A Python port of chkit — ClickHouse schema management and migration toolkit, written in strict, imperative Python.

Design

• Type safety first. Every public surface is annotated. The project is configured for mypy --strict and Pyright strict mode out of the box.
• Pydantic v2 models. Runtime validation, frozen, extra="forbid".
• Imperative core. Pure functions over data; minimal classes outside of Pydantic models and the CLI shell.
• No magic. No dynamic imports, no runtime introspection of user code beyond what Pydantic provides.

Layout

src/chkit/
  core/          Schema DSL, diff engine, planner, SQL rendering, validation
  clickhouse/    ClickHouse client wrapper
  cli/           Typer-based CLI (init, generate, migrate, status, check, drift)

Quickstart

pip install -e ".[dev]"
chkit --help
mypy
pytest

Status

Port-in-progress. Implements the core schema model, canonicalization, the diff/migration planner, validation, and a basic CLI. Parity tracker in the tests/ directory mirrors the TS test suite.