abaquant.marketdata.financials.line_item_resolver

Import path: abaquant.marketdata.financials.line_item_resolver

Domain: Provider-neutral market-data facades, normalized records, caching, and analytics.

Purpose

Canonical financial-line-item resolution across provider-specific labels.

When to use it

This module participates in the financial-statement pipeline: provider response, normalization, cache/repository coordination, canonical line-item resolution, and analytical input construction.

Public objects

• function: find_label — Resolve a provider label by case-insensitive exact matching.

• function: latest_value — Return the first finite value from provider-order statement columns.

• function: resolve_line_items — Build canonical latest-value items with original-label provenance.

• function: history_for_item — Return finite values ordered oldest-to-newest where dates are parseable.

Detailed reference

Canonical financial-line-item resolution across provider-specific labels.

abaquant.marketdata.financials.line_item_resolver.find_label(frame, candidates)

Resolve a provider label by case-insensitive exact matching.

Parameters:

• frame (DataFrame)

• candidates (tuple[str, ...])

Return type:

str | None

abaquant.marketdata.financials.line_item_resolver.latest_value(frame, label)

Return the first finite value from provider-order statement columns.

Parameters:

• frame (DataFrame)

• label (str | None)

Return type:

tuple[float | None, str | None]

abaquant.marketdata.financials.line_item_resolver.resolve_line_items(income, balance, cash_flow)

Build canonical latest-value items with original-label provenance.

Parameters:

• income (DataFrame)

• balance (DataFrame)

• cash_flow (DataFrame)

Return type:

dict[str, FinancialLineItem]

abaquant.marketdata.financials.line_item_resolver.history_for_item(frame, candidates)

Return finite values ordered oldest-to-newest where dates are parseable.

Parameters:

• frame (DataFrame)

• candidates (tuple[str, ...])

Return type:

tuple[float, …]