RuntimeContract
yosoi.runtime_contracts.RuntimeContract
class RuntimeContract(NativeAuthoringModel):
Author a Contract schema for extraction and validation in Rust.
The schema defines grouping, fields, cardinalities, and value types. Unsupported conversions remain explicit validation issues rather than inferred Python conversions.
Attributes: contract_schema: Public schema validated when the native Contract is constructed.
Source: python/yosoi/runtime_contracts.py:1015
Members below are declared on this class. Inherited Pydantic methods and generated constructor signatures are not expanded.
Fields and class attributes
Section titled “Fields and class attributes”contract_schema: ContractSchema
Methods
Section titled “Methods”model_post_init
Section titled “model_post_init”def model_post_init(self, context: object) -> None:
Construct the native Contract from the validated Pydantic schema.
Args: context: Pydantic initialization context; unused by this bridge.
Raises: ContractError: Rust rejects the authored schema.
Source: python/yosoi/runtime_contracts.py:1030
@classmethod
def new(cls, schema: ContractSchema) -> RuntimeContract:
Construct a runtime Contract using the supplied public schema.
Args: schema: Contract identity, grouping, fields, and validation declarations.
Returns: Contract whose native handle has accepted the schema.
Raises: ContractError: Rust rejects the authored schema.
Source: python/yosoi/runtime_contracts.py:1042
identity
Section titled “identity”def identity(self) -> ContractIdentity:
Return the Rust-generated identity of this authored Contract schema.
Source: python/yosoi/runtime_contracts.py:1056
extract
Section titled “extract”def extract(self, located: LocateOutcome, *, limits: ExtractionLimits | None=None) -> RuntimeExtracted:
Group located findings into unvalidated runtime candidates.
Args: located: Locator result carrying findings, provenance, and completeness. limits: Optional extraction budgets; None uses Rust defaults.
Returns: Candidates, no-match, indeterminate evidence, locator failure, or a typed extraction rejection. Call validate() to obtain accepted field values.
Source: python/yosoi/runtime_contracts.py:1060
locate
Section titled “locate”def locate(self, document: Document | BoundDocument | ParsedDocument, plan: Plan) -> RuntimeExtracted:
Locate document evidence and extract candidates using this Contract.
Args: document: Offline, parsed, or bound document providing locator evaluation. plan: Discovery plan used to locate findings before extraction.
Returns: Unvalidated extraction result retaining locator completeness or failure. Validation is a separate operation on the returned result.