WClickHouse 1.0 llega a PyPI con más de 50 ejemplos y soporte completo para Python 3.9‑3.14
La suite Wisrovi publica WClickHouse, una capa Python que integra WKafka y WPipe para pipelines analíticos end‑to‑end sobre ClickHouse.
WClickHouse 1.0 salió hoy en PyPI después de una campaña de 20 días de publicaciones bajo la etiqueta WClickHouse Open Source. La librería cierra el círculo de la suite Wisrovi, que ya incluía WKafka (cliente Kafka) y WPipe (orquestador con checkpoints). Ahora los desarrolladores pueden conectar un flujo de eventos Kafka directamente a ClickHouse usando una API declarativa.
from wkafka import WKafka
from wpipe import Pipeline, step
from wclickhouse import WClickHouse
db = WClickHouse(AnalyticsEvent, db_config, use_buffer=True)
@step(name="persist_to_clickhouse")
def persist_step(ctx):
db.insert(AnalyticsEvent(**ctx["event_payload"]))
return {"status": "persisted"}
El fragmento anterior muestra el patrón recomendado: un WKafka consume eventos, WPipe los pasa a través de un step y WClickHouse los escribe en la tabla columnares. La arquitectura se describe como sinergia: WKafka → WPipe → WClickHouse.
La distribución incluye 51 ejemplos reales que cubren casos de CRUD, inserciones en bloque, operaciones asíncronas y uso de motores específicos de ClickHouse. Cada ejemplo está testeado contra instancias reales y reporta más del 95 % de cobertura de pruebas. El proyecto se apoya en Pydantic v2, Apache Arrow y la propia API de ClickHouse, lo que permite validar esquemas y serializar datos de forma eficiente.
WClickHouse está empaquetado para Python 3.9‑3.14 y declara compatibilidad con Apache Arrow 12 y Pydantic v2. El paquete se publica en PyPI y el código fuente está disponible en el repositorio de GitHub. La licencia es Apache 2.0, lo que facilita su adopción en entornos corporativos sin restricciones de uso.
Esta liberación responde a varios problemas típicos del stack de datos: la fragmentación de librerías, tutoriales insuficientes y la ausencia de patrones end‑to‑end que combinen streaming y almacenes columnares. Al ofrecer una única capa de abstracción, Wisrovi pretende reducir la fricción operativa y acelerar la puesta en producción de pipelines analíticos.
Queda por ver cómo la comunidad adoptará la suite completa y si los usuarios extenderán los ejemplos a casos más complejos como replicación multi‑zona o integración con sistemas de metadatos. La disponibilidad de pruebas automáticas y la licencia permisiva son buenos indicadores de una adopción sostenida.
