finos-platform-api-client 0.4.0

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

platform-api-client

A standalone Python client for the FinOS Platform API (import name finos.platform_api_client, distribution finos-platform-api-client). Extracted from finos-automation-sdk (FINOS-246) so the SDK — and any other consumer — can call the Platform API without pulling the whole automation SDK. Mirrors finos-ledger-api-client in shape.

from finos.platform_api_client import PlatformApiClient

async with PlatformApiClient(base_url, jwt) as client:
    users = await client.api.users.list_users()
    one = await client.api.users.get_user(user_id="usr_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.platform_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.