Skip to content

vnfin v0.2.0

Latest
Latest

Choose a tag to compare

View all tags
@hungson175 hungson175 released this 18 Jun 11:20
v0.2.0
2fe50df

vnfin v0.2.0 — stability hardening + a new FX domain + AI-facing docs & skill.

Added

  • API stability gate: a public-API surface snapshot test + compatibility-aware comparator that fails CI on any accidental breaking change (renames, reorders, unit/currency-default shifts, new required params, return-type changes). SemVer + deprecation policy in docs/stability.md.
  • Upstream health monitoring (opt-in): scripts/healthcheck.py + private vnfin/_health.py — schema-drift + value-sanity per source, sanitized STATUS.md/JSON. Never in CI; rate-limit-aware.
  • FX domain (vnfin.fx): no-key daily/current rates vs VND (open.er-api → Vietcombank failover), canonical unit "VND per 1 base" + cross-rates, typed FXRate, two-layer unit guard.
  • AI documentation (docs/ai-usage.md + llms.txt) and an Anthropic-style skill (skills/vnfin/) so AI agents can use the library; a docs-contract test keeps them in sync with the code.

Install

pip install git+https://github.com/hungson175/vnfin.git

No API key required for the default path of any domain. Python ≥ 3.10. Apache-2.0.

Assets 2
Loading