Coverage for src/copytrading_engine/execution/domain/sessions.py: 100%
25 statements
« prev ^ index » next coverage.py v7.16.2, created at 2026-11-16 16:55 +0000
« prev ^ index » next coverage.py v7.16.2, created at 2026-11-16 16:55 +0000
1"""Pure session classification using the broker's trading-day calendar."""
3import datetime as dt
4from dataclasses import dataclass
5from enum import StrEnum
6from zoneinfo import ZoneInfo
8ET = ZoneInfo("America/New_York")
11class Session(StrEnum):
12 CLOSED = "closed"
13 REGULAR = "regular"
14 EXTENDED = "extended"
15 OVERNIGHT = "overnight"
16 # Crypto trades every hour of every day; no stock session, extended hours, or overnight rule
17 # applies to it (ADR-0014).
18 AROUND_THE_CLOCK = "around_the_clock"
21def trade_date(now: dt.datetime) -> dt.date:
22 local = now.astimezone(ET)
23 return local.date() + dt.timedelta(days=int(local.hour >= 20))
26@dataclass(frozen=True)
27class SessionSchedule:
28 regular_open: dt.time
29 regular_close: dt.time
30 extended_open: dt.time
31 extended_close: dt.time
33 def at(self, now: dt.datetime, *, extended: bool, overnight: bool) -> Session:
34 time = now.astimezone(ET).time().replace(tzinfo=None)
35 if time >= dt.time(20) or time < dt.time(4):
36 return Session.OVERNIGHT if overnight and extended else Session.CLOSED
37 if self.regular_open <= time < self.regular_close:
38 return Session.REGULAR
39 if extended and self.extended_open <= time < self.extended_close:
40 return Session.EXTENDED
41 return Session.CLOSED