Skip to content

trading_agent.terminal.widgets.desk_card

The side panel's Desk card: the desk's name, state, waiting triggers, exchanges and session.

Typical usage example:

card = DeskCard() card.show(desk_summary)

DeskCard 

DeskCard(collapsed=False)

Bases: SideCard

The Desk card.

Creates the card.

Parameters:

Name Type Description Default
collapsed bool

Whether it starts folded.

 False
Source code in src/trading_agent/terminal/widgets/desk_card.py 
19
20
21
22
23
24
25
def __init__(self, collapsed: bool = False):
    """Creates the card.

    Args:
        collapsed (bool): Whether it starts folded.
    """
    super().__init__('desk', 'Desk', collapsed=collapsed)

show 

show(desk, mode)

Shows the desk's state.

Parameters:

Name Type Description Default
desk dict[str, Any] | None

The desk summary, or None while loading.

 required
mode str

"dry_run" or "live".

 required
Source code in src/trading_agent/terminal/widgets/desk_card.py 
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
def show(self, desk: dict[str, Any] | None, mode: str) -> None:
    """Shows the desk's state.

    Args:
        desk (dict[str, Any] | None): The desk summary, or None while loading.
        mode (str): "dry_run" or "live".
    """
    if desk is None:
        self.show_body(self.note('Loading…'))
        return
    self.show_aside('LIVE' if mode == 'live' else 'DRY RUN')
    state = str(desk.get('state', ''))
    if desk.get('paused'):
        state += ', paused'
    state_value = Content(state)
    if desk.get('state') != 'idle':
        state_value = Content.from_markup(
            '[$warning]$state[/]', state=state
        )
    self.show_body(
        self.rows(
            [
                (
                    'Name',
                    desk.get('name', ''),
                ),
                (
                    'State',
                    state_value,
                ),
                (
                    'Waiting triggers',
                    str(desk.get('queued', 0)),
                ),
                (
                    'Exchanges',
                    str(desk.get('exchanges', 0)),
                ),
                (
                    'Session',
                    str(desk.get('session_id') or '—'),
                ),
            ]
        )
    )