Add runtime statistics via engine.stats

2026-06-03 09:48:33 +02:00
parent 0faa01d89b
commit b044ca43f8
7 changed files with 116 additions and 5 deletions
@@ -6,6 +6,26 @@ All notable changes to this project will be documented in this file.

 ---

+## [1.1.0] - 2026-06-03
+
+### Added
+- `Stats` and `TableStats` frozen dataclasses — snapshot of runtime cache statistics (hit/miss/refetch counts, per-table row count, columns, last refresh timestamp)
+- `StatsCollector` — internal thread-safe counter; increments on every cache hit, miss, and re-fetch
+- `engine.stats` property — returns a `Stats` snapshot at any point in time
+- `Stats` and `TableStats` exported from the public API
+
+### Changed
+- `pyproject.toml` — bumped version to `1.1.0`
+
+---
+
+## [1.0.0] - 2026-06-03
+
+### Changed
+- `pyproject.toml` — bumped version to `1.0.0`
+
+---
+
 ## [0.4.0] - 2026-06-03

 ### Added