Skip to main content

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              # 漂移检测

命令与 import 名统一为 fineprint(0.8.4 起)。 LLM 端点经环境变量或项目根 .env 配置(FINEPRINT_LLM_BASE_URL / FINEPRINT_LLM_API_KEY / FINEPRINT_LLM_MODEL),兼容 OpenAI 风格 API; graph / trace / drift 零 LLM 即可用。

无 catalog 也能跑(列 schema 由 yml 声明 + 编译 SQL 拓扑推断补全);能执行 dbt docs generate 时仍建议补上,实测列集更可靠。

Roadmap(暂未随本发行版打包):重复指标治理 fineprint govern(指纹扫描 + LLM 仲裁)、dbt exposures 集成(指标候选预填 + 看板消费方标注)、非 dbt SQL 管道。

License: Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fineprint-0.8.6.tar.gz (81.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fineprint-0.8.6-py3-none-any.whl (90.8 kB view details)

Uploaded Python 3

File details

Details for the file fineprint-0.8.6.tar.gz.

File metadata

  • Download URL: fineprint-0.8.6.tar.gz
  • Upload date:
  • Size: 81.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.5

File hashes

Hashes for fineprint-0.8.6.tar.gz
Algorithm Hash digest
SHA256 9b0031d64268d074f9da2fe85ea2cb42b82cf8300c118bb9324297fa176cef7f
MD5 08e972b5854d5e47ce5d8c593337b713
BLAKE2b-256 c9fca2ac3bf12a03ed385e8e5e5c1388ec0a11b5e8172e86203582e5490a1717

See more details on using hashes here.

File details

Details for the file fineprint-0.8.6-py3-none-any.whl.

File metadata

  • Download URL: fineprint-0.8.6-py3-none-any.whl
  • Upload date:
  • Size: 90.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.5

File hashes

Hashes for fineprint-0.8.6-py3-none-any.whl
Algorithm Hash digest
SHA256 a530086e28c6bc525e019ce0d7eaa3fe1fb6a7d056a1375fde33616c9d5f7e75
MD5 9d73a92767cf4c8fd9ea03b221824fe4
BLAKE2b-256 eedd49ad6455161b9110f1f1a9f95bbdd62bf35e6d8faedfd400e659f0b0c47a

See more details on using hashes here.

Release history Release notifications | RSS feed

0.9.8

2 files

0.9.7

2 files

0.9.6

2 files

0.9.5

2 files

0.9.4

2 files

0.9.3

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.10

2 files

0.8.9

2 files

0.8.8

2 files

0.8.7

2 files

This release

0.8.6 This release

2 files

0.8.5

2 files

0.8.4

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page