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`,