finos-ledger-api-client 0.4.0

FinOS Ledger API client — the OpenAPI-generated Ledger API client + a dynamic tag.operation façade and typed error taxonomy (Spec 037 / FINOS-246)

ledger-api-client

A standalone Python client for the FinOS Ledger API (import name finos.ledger_api_client). Extracted from finos-automation-sdk (Spec 037 / FINOS-246) so both the SDK and apps/platform-api can call the Ledger API without pulling the whole automation SDK.

from finos.ledger_api_client import LedgerApiClient

async with LedgerApiClient(base_url, jwt) as client:
    ledgers = await client.api.ledgers.list_ledgers()
    one = await client.api.ledgers.get_ledger(ledger_id="led_1")

• client.api.<tag>.<op>(...) — operations are reflected by tag from the OpenAPI-generated client under _generated/, so nothing is hand-written and nothing needs re-writing when the client is regenerated.
• Each call returns the parsed 2xx body or raises a typed error (finos.ledger_api_client.errors): 401→AuthenticationError, 403→AuthorizationError, 404→NotFoundError, 409→ConflictError, 422→ValidationError, 5xx/other→ServerError.
• Both base_url and jwt are always required (no env fallback). The client never mints and never talks to an auth provider.

Standalone by design: depends only on httpx + attrs + python-dateutil — no finos.shared, no fastapi — so finos-automation-sdk stays pip-installable on Windmill.

See AGENTS.md for the full package guide and regeneration steps.