From 77152b1cd4ce7e365b19a7d926b74fd81305ef7e Mon Sep 17 00:00:00 2001 From: TiM Date: Thu, 2 Jul 2026 11:12:52 +1200 Subject: [PATCH] docs: refine cold-start claim with import-timing numbers - Replace the imprecise "8-20 s cold start" claim with concrete import timings (~1.5 s for snowflake-connector-python vs ~0.3 s for this client) - Attribute the slowdown to the C extension inflating cold starts, rather than implying an unqualified multi-second startup penalty - Keep AGENTS.md and README.md wording in sync (same claim, two surfaces) --- AGENTS.md | 7 ++++--- README.md | 7 ++++--- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 43dcd80..09ea728 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,9 +9,10 @@ Code (via `CLAUDE.md`), Codex CLI, and humans. [SQL API v2](https://docs.snowflake.com/en/developer-guide/sql-api/index) (the `POST /api/v2/statements` REST endpoint). It exists as a small, fast alternative to the official `snowflake-connector-python`, which is ~75 MB installed (150 MB -with pandas/pyarrow), has an 8-20 s cold start, and ships a C extension that slows -container builds. This client is pure Python over `httpx`, so it is small and -quick to cold-start, which matters in serverless / Lambda environments. +with pandas/pyarrow) and ships a C extension that slows container builds and +inflates cold starts (its import alone is ~1.5 s versus ~0.3 s for this client). +This client is pure Python over `httpx`, so it is small and quick to cold-start, +which matters in serverless / Lambda environments. It offers both **synchronous and asynchronous** clients, keypair (JWT) auth, type coercion, multi-partition result handling, a CLI, and optional pandas / typed-row diff --git a/README.md b/README.md index 3d70d31..f979a15 100644 --- a/README.md +++ b/README.md @@ -8,9 +8,10 @@ A lightweight, pure-Python client for [Snowflake's SQL API v2](https://docs.snow ## Why The official [`snowflake-connector-python`](https://pypi.org/project/snowflake-connector-python/) -is ~75 MB installed (150 MB with pandas/pyarrow), has an 8-20 s cold start, and -ships a compiled extension that slows container builds. For serverless and AWS -Lambda workloads that only need to run SQL, that is a lot of weight. +is ~75 MB installed (150 MB with pandas/pyarrow) and ships a compiled extension +that slows container builds and inflates cold starts (its import alone is ~1.5 s +versus ~0.3 s for this client). For serverless and AWS Lambda workloads that only +need to run SQL, that is a lot of weight. `snowflake-sql-api` talks to Snowflake's SQL API over plain HTTP (`httpx`), so it stays small and cold-starts quickly. Core dependencies: `httpx`, `PyJWT`,