ooai_llm.tui.data

Testable data layer for the optional Textual TUI.

Purpose:

Keep model/catalog/benchmark data shaping independent of Textual so the interactive app can be tested without a terminal.

Design:

The TUI consumes preformatted row models, snapshot-level metrics, simple client-side filters, and a small refresh gate used to avoid accidental repeated provider/catalog calls.

Attributes

TUIViewName
TUICatalogScope
TUI_LOAD_VIEW_CHOICES
TUIRow

Classes

TUIConfig	Initial state for the optional Textual model explorer.
TUIComparisonRow	A model comparison row ready for display.
TUICatalogRow	A catalog row ready for display.
TUISuiteRow	A model suite row ready for display.
TUIBenchmarkRow	A benchmark endpoint row ready for display.
TUISnapshot	All data needed by the Textual app to render its main tables.
TUIRefreshDecision	Result of a TUI refresh-rate decision.
TUIRefreshGate	Tiny in-process cooldown for expensive TUI refresh actions.

Functions

format_money(→ str)	Format optional USD values for compact terminal display.
format_count(→ str)	Format optional token counts for compact terminal display.
build_tui_snapshot(→ TUISnapshot)	Load catalog, comparison, and suite rows for the TUI.
rows_for_view(→ list[TUIRow])	Return snapshot rows for one table-backed view.
normalize_tui_load_views(→ list[TUIViewName] | None)	Normalize repeatable or comma-separated TUI view names.
tui_row_search_text(→ str)	Return lowercase searchable text for any TUI display row.
filter_tui_rows(→ list[TUIRow])	Filter already-loaded TUI rows by free-text query and provider.
snapshot_providers(→ list[str])	Return sorted provider names visible in the snapshot.
snapshot_metrics(→ dict[str, str])	Return compact metrics for the dashboard cards.

Module Contents

ooai_llm.tui.data.TUIViewName

ooai_llm.tui.data.TUICatalogScope

ooai_llm.tui.data.TUI_LOAD_VIEW_CHOICES: tuple[TUIViewName, Ellipsis] = ('cheapest', 'coding', 'catalog', 'suites', 'benchmarks')

class ooai_llm.tui.data.TUIConfig(/, **data: Any)

Bases: pydantic.BaseModel

Initial state for the optional Textual model explorer.

source: Literal['auto', 'provider', 'litellm'] = 'litellm'

providers: list[str] | None = None

limit: int = 25

input_tokens: int = 10000

output_tokens: int = 2000

budget_usd: decimal.Decimal

show_benchmarks: bool = True

include_non_chat: bool = False

catalog_scope: TUICatalogScope = 'supported'

query: str = ''

refresh_cooldown_seconds: float = None

theme: ooai_llm.tui.themes.TUIThemeName = 'paper'

load_views: list[TUIViewName] | None = None

notes: list[str] = None

resolved_load_views() → tuple[TUIViewName, Ellipsis]

Return the table-backed views that should be loaded.

should_load_view(view: TUIViewName) → bool

Return whether a table-backed view should be fetched.

class ooai_llm.tui.data.TUIComparisonRow(/, **data: Any)

Bases: pydantic.BaseModel

A model comparison row ready for display.

provider: str

model: str

call_cost: str

calls_per_budget: str

price_per_1m: str

tokens: str

capabilities: str

release: str = 'n/a'

source: str = 'n/a'

class ooai_llm.tui.data.TUICatalogRow(/, **data: Any)

Bases: pydantic.BaseModel

A catalog row ready for display.

provider: str

model: str

release: str

price_per_1m: str

tokens: str

capabilities: str

source: str = 'n/a'

class ooai_llm.tui.data.TUISuiteRow(/, **data: Any)

Bases: pydantic.BaseModel

A model suite row ready for display.

key: str

role: str

provider: str

model: str

capabilities: str

class ooai_llm.tui.data.TUIBenchmarkRow(/, **data: Any)

Bases: pydantic.BaseModel

A benchmark endpoint row ready for display.

name: str

method: str

path: str

query: str

stability: str

description: str

ooai_llm.tui.data.TUIRow

class ooai_llm.tui.data.TUISnapshot(/, **data: Any)

Bases: pydantic.BaseModel

All data needed by the Textual app to render its main tables.

config: TUIConfig

cheapest: list[TUIComparisonRow] = None

coding: list[TUIComparisonRow] = None

catalog: list[TUICatalogRow] = None

suites: list[TUISuiteRow] = None

benchmarks: list[TUIBenchmarkRow] = None

notes: list[str] = None

class ooai_llm.tui.data.TUIRefreshDecision(/, **data: Any)

Bases: pydantic.BaseModel

Result of a TUI refresh-rate decision.

allowed: bool

message: str

remaining_seconds: float = 0

class ooai_llm.tui.data.TUIRefreshGate(*, cooldown_seconds: float = 2.0)

Tiny in-process cooldown for expensive TUI refresh actions.

cooldown_seconds

last_refresh_at: float | None = None

request(*, now: float, force: bool = False) → TUIRefreshDecision

Return whether a refresh may run and update state when allowed.

ooai_llm.tui.data.format_money(value: decimal.Decimal | None) → str

Format optional USD values for compact terminal display.

ooai_llm.tui.data.format_count(value: int | None) → str

Format optional token counts for compact terminal display.

ooai_llm.tui.data.build_tui_snapshot(config: TUIConfig | None = None) → TUISnapshot

Load catalog, comparison, and suite rows for the TUI.

The function is intentionally independent of Textual so tests and future non-interactive exporters can exercise the same data path.

ooai_llm.tui.data.rows_for_view(snapshot: TUISnapshot, view: TUIViewName) → list[TUIRow]

Return snapshot rows for one table-backed view.

ooai_llm.tui.data.normalize_tui_load_views(values: list[str] | None) → list[TUIViewName] | None

Normalize repeatable or comma-separated TUI view names.

ooai_llm.tui.data.tui_row_search_text(row: TUIRow) → str

Return lowercase searchable text for any TUI display row.

ooai_llm.tui.data.filter_tui_rows(rows: list[TUIRow], *, query: str = '', provider: str | None = None) → list[TUIRow]

Filter already-loaded TUI rows by free-text query and provider.

ooai_llm.tui.data.snapshot_providers(snapshot: TUISnapshot) → list[str]

Return sorted provider names visible in the snapshot.

ooai_llm.tui.data.snapshot_metrics(snapshot: TUISnapshot) → dict[str, str]

Return compact metrics for the dashboard cards.