tubedude / finance-elixir / a73ef080f003b3b4df000f5c34a7d57cd7b505b6-PR-29

100%

master: 100%

Pull #29

github

Validate options per function; accept Decimal in Returns

Options:
- Four compiled schemas (dated rate, rate, dated value, value): each function
  validates only the options it uses, so an inapplicable option — :basis on
  periodic irr, :guess on xnpv or a Bonds metric — raises instead of being
  silently ignored. npv validates options before rejecting empty data.
- :precision is 0..15 in the Returns and amortization schemas too, and
  Finance.option includes {:basis, _}.

Behavior:
- xnfv returns {:error, :undefined} when forward compounding overflows.
- The Returns cash-flow metrics coerce amounts via Shared.to_amount, so
  Decimal and Money inputs work there like they do in CashFlow.

Tests: Decimal/Money value-transparency property; cross-basis contracts
(irr == xirr, xnfv/xnpv ratio, batch with basis + Brent together); a 30/360
Feb-29 no-EOM pin; fractional bond years.

Docs: restore the 1.6.1 CHANGELOG heading; README pins ~> 1.7 and gains
DayCount, xnfv/conventional?, and :undefined in the error table; ExDoc gets
source_ref and module groups; the first xirr doctest shows a simple 20% rate.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AVibXT2w1dEdVtMHqffFKn

65 of 65 new or added lines in 6 files covered. (100.0%)

495 of 495 relevant lines covered (100.0%)

65873.47 hits per line