cadrumo.entrypoints.tui.home module

Projection-only production Home surface for the operator workbench.

The screen renders one already-composed HomeProjectionV1. It neither reads application state nor invokes an action: its host receives semantic row selections and owns any later destination or action hand-off.

class HomeTarget(kind, identity)[source]

Bases: object

A selected Home row identified independently of its rendered position.

Parameters:
kind: HomeTargetKind
identity: str
class HomeTargetSelected(target)[source]

Bases: Message

Ask the host to handle an admitted semantic Home selection.

Parameters:

target (HomeTarget)

time
bubble: ClassVar[bool]
handler_name: ClassVar[str]

Name of the default message handler.

no_dispatch: ClassVar[bool]
verbose: ClassVar[bool]
class HomeBackRequested[source]

Bases: Message

Ask the host to return without making a business call.

time
bubble: ClassVar[bool]
handler_name: ClassVar[str]

Name of the default message handler.

no_dispatch: ClassVar[bool]
verbose: ClassVar[bool]
home_address(modelo, filing_year, period_token)[source]

Format the shared non-sensitive natural address for a Home row.

Return type:

str

Parameters:
home_action_identity(item)[source]

Return a stable Home action identity independent of row order.

Return type:

str

Parameters:

item (HomeNextAction)

home_declaration_identity(item)[source]

Return the canonical declaration-resumption identity.

Return type:

str

Parameters:

item (HomeDeclarationResume)

home_agenda_identity(item)[source]

Return the natural address used to restore an agenda row.

Return type:

str

Parameters:

item (HomeAgendaEntry)

home_target_action_id(target)[source]

Return the action a next-action row names, read back from its identity.

Return type:

str | None

Parameters:

target (HomeTarget)

home_target_work_unit_id(target)[source]

Return the work unit a resumable-declaration row names.

Return type:

str | None

Parameters:

target (HomeTarget)

home_target_agenda_address(target)[source]

Return the Modelo, filing year and period an agenda row names.

Return type:

tuple[str, str, str] | None

Parameters:

target (HomeTarget)

class HomeScreen(projection, *, restore_target=None)[source]

Bases: AccountChromeScreen

The selected responsive due-driven layout over one immutable projection.

Parameters:
WIDE_MINIMUM: ClassVar[int]
BINDINGS: ClassVar

A list of key bindings.

CSS: ClassVar[str]

Inline CSS, useful for quick scripts. Rules here take priority over CSS_PATH.

Note

This CSS applies to the whole app.

property home_targets: tuple[HomeTarget, ...]

The domain identities this rendering offered, in mounted order.

property projection: HomeProjectionV1

Return the unchanged injected application projection.

compose()[source]

Called by Textual to create child widgets.

This method is called when a widget is mounted or by setting recompose=True when calling [refresh()][textual.widget.Widget.refresh].

Note that you don’t typically need to explicitly call this method.

Return type:

Iterable[Widget]

Example

def compose(self) -> ComposeResult:
    yield Header()
    yield Label("Press the button below:")
    yield Button()
    yield Footer()
on_resize(event)[source]

Swap geometry at the measured breakpoint without changing rows.

Return type:

None

Parameters:

event (Resize)

on_mount()[source]

Populate display-only lists from the immutable projection.

Return type:

None

on_data_table_row_highlighted(event)[source]

Track a semantic target, never a row number.

Return type:

None

Parameters:

event (RowHighlighted)

on_data_table_row_selected(event)[source]

Notify the host of a selection without dispatching a business action.

Return type:

None

Parameters:

event (RowSelected)

action_back()[source]

Return control to the host without dismissing the application.

Return type:

None

can_focus: bool

Widget may receive focus.

can_focus_children: bool

Widget’s children may receive focus.