fineprint
Read the fine print of your metrics. A decompiler for your dashboards.
从 dbt 项目的编译产物(manifest / catalog / compiled SQL)逆向合成每个指标的 完整技术口径——零数据库连接。读懂指标的小字条款,给看板的反编译器。
Reverse-engineers the full technical caliber of every metric from your dbt artifacts (manifest / catalog / compiled SQL) — zero database connection.
- 字段级血缘图 column-level lineage:跨模型、进 CTE/子查询/UNION/PIVOT, 条件与聚合语义一并入图。
- 口径卡 caliber cards:确定性公式组合器(发布权威)× LLM 解读(解释与 叙述)双通道互证,每个事实带机器证据;组合器不可证时 LLM 兜底并标注原因。 在 5 个公开真实项目(34,499 列)上组合器覆盖 99.7%,残余全部具名。
- 口径漂移检测 caliber drift:图快照逐语义点比对,SQL 改动落到受影响 指标与条件粒度。
pip install fineprint
fineprint init --project <dbt 项目目录> # 生成 fineprint.yml 模板
fineprint graph --project DIR # 建血缘图(需先 dbt compile + docs generate)
fineprint synth --project DIR # 合成口径卡(需配置 LLM 端点)
fineprint drift --project DIR # 漂移检测
Python API(0.9 起,最小公开面 minimal public surface since 0.9):
import fineprint
fineprint.build_graph("path/to/dbt_project") # 血缘图(零 LLM)
print(fineprint.trace("path/to/dbt_project", "dm.gmv")) # 口径树(零 LLM)
batch = fineprint.cards("path/to/dbt_project") # 已发布口径卡批次(schema_version 冻结)
命令与 import 名统一为 fineprint(0.8.4 起;老项目迁移 = 四个改名:
CLI/import、metriclens.yml→fineprint.yml、.metriclens/→.fineprint/、
METRICLENS_*→FINEPRINT_*,CLI 检测到残留会给出具体改名命令)。
CLI 与卡片双语(zh|en):
fineprint.yml 的 language 或 FINEPRINT_LANG 环境变量控制。
LLM 端点经环境变量或项目根 .env 配置(FINEPRINT_LLM_BASE_URL /
FINEPRINT_LLM_API_KEY / FINEPRINT_LLM_MODEL,调优项 _CONCURRENCY /
_TIMEOUT / _RETRIES),兼容 OpenAI 风格 API;
graph / trace / drift 零 LLM 即可用。
无 catalog 也能跑(列 schema 由 yml 声明 + 编译 SQL 拓扑推断补全);能执行
dbt docs generate 时仍建议补上,实测列集更可靠。
Roadmap(不随本发行版打包):2.0 = 重复指标治理 fineprint govern(指纹扫描 +
LLM 仲裁)与 dbt exposures 集成(指标候选预填 + 看板消费方标注);另有非 dbt SQL 管道。
License: Apache-2.0
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fineprint-0.9.0.tar.gz.
File metadata
- Download URL: fineprint-0.9.0.tar.gz
- Upload date:
- Size: 99.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a4a5aac693b050933094dad4dfb7e924a1bab48f0f135f91752a1646005c41fc
|
|
| MD5 |
7a4a97afe021c95cd299fd9056b4cea5
|
|
| BLAKE2b-256 |
6aca18797a56c73445d4befe719595cdc7a9b19175253ef3543df7d6144037d2
|
File details
Details for the file fineprint-0.9.0-py3-none-any.whl.
File metadata
- Download URL: fineprint-0.9.0-py3-none-any.whl
- Upload date:
- Size: 111.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bbec110b631203b00400ff500430449c6fa494f190f2911a5440541f3baf88b6
|
|
| MD5 |
619abf9c140b9f32e4ea51ff2d3b6a25
|
|
| BLAKE2b-256 |
2e18c3fb479c1ab9633322af37a41bb4566a4e79e239d19195bc7c82a39c1291
|
