Metadata-Version: 2.5
Name: syvain-metrics-duckdb
Version: 0.0.358
Summary: DuckDB extension that attaches Syvain Metrics as a database
Requires-Python: >=3.10
Requires-Dist: duckdb==1.5.5
Description-Content-Type: text/markdown

# syvain-metrics-duckdb

DuckDB extension that attaches [Syvain Metrics](https://metrics.syvain.com/)
as a database, bundled per platform with a `load()` helper.

```python
import duckdb
import syvain_metrics_duckdb

con = duckdb.connect(config={"allow_unsigned_extensions": "true"})
syvain_metrics_duckdb.load(con)
con.execute("CREATE SECRET syvain (TYPE syvain_metrics, API_KEY 'ak_...')")
con.execute(
    "ATTACH 'metrics.syvain.com' AS m (TYPE syvain_metrics, CACHE_DIR '~/.syvain-metrics/duckdb-cache')"
)
print(con.sql("SELECT slug, status FROM m.experiments LIMIT 5"))
```

The wheel pins the exact DuckDB release the extension was built for. The
extension is not signed by DuckDB, so the connection has to allow unsigned
extensions before `load()`.

The SQL surface, selector rules, and cache behaviour are documented at
https://metrics.syvain.com/docs.
