bayesline.api.equity.resolve_expressions

bayesline.api.equity.resolve_expressions#

bayesline.api.equity.resolve_expressions(expressions: Mapping[str, str], factors: Sequence[tuple[str, str]]) → list[tuple[str, str, str]]#

Validate exposure expressions and resolve their references.

Parameters#

expressionsMapping[str, str]

The expressions, keyed by the factor each defines, written factor_group.code. The factor group must be one of factors. Each expression is at most 1000 characters.

factorsSequence[tuple[str, str]]

The input factors as (factor_group, code).

Returns#

list[tuple[str, str, str]]

(factor_group, code, canonical_text) for each key, in key order. The canonical text writes every reference as factor_group.code.

Raises#

ValueError

If a key is not two identifiers joined by ., uses a reserved name or names an unknown factor group, if an expression is too long or not valid (see parse_expression), or if a reference is unknown or ambiguous or resolves to a factor group with a reserved name. The message starts with ``expression ‘<key>’: ``.