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

1"""Pure session classification using the broker's trading-day calendar.""" 

2 

3import datetime as dt 

4from dataclasses import dataclass 

5from enum import StrEnum 

6from zoneinfo import ZoneInfo 

7 

8ET = ZoneInfo("America/New_York") 

9 

10 

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" 

19 

20 

21def trade_date(now: dt.datetime) -> dt.date: 

22 local = now.astimezone(ET) 

23 return local.date() + dt.timedelta(days=int(local.hour >= 20)) 

24 

25 

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 

32 

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