How to Track Session Windows with Gap Timeout in Python

import time

class SessionWindow:
    """Track sessions with a gap timeout (mock)."""
    
    def __init__(self, timeout_seconds=5):
        self.timeout = timeout_seconds
        self.session_start = None
        self.last_event_time = None
        self.event_count = 0
        self.events = []
    
    def add_event(self, event):
        now = time.time()
        
        if self.last_event_time is None:
            # First event starts a new session
            self.session_start = now
            self.last_event_time = now
            self.events = [event]
            self.event_count = 1
            return True
        
        gap = now - self.last_event_time
        if gap > self.timeout:
            # Gap exceeded timeout - start new session
            self.session_start = now
            self.events = [event]
            self.event_count = 1
        else:
            # Same session - append event
            self.events.append(event)
            self.event_count += 1
        
        self.last_event_time = now
        return True
    
    def get_session_length(self):
        if self.last_event_time is None:
            return 0
        return self.last_event_time - self.session_start
    
    def get_events(self):
        return self.events


if __name__ == "__main__":
    # Mock: simulate events with gaps
    window = SessionWindow(timeout_seconds=2)
    
    # First event
    window.add_event("click")
    time.sleep(1)
    
    # Within timeout
    window.add_event("scroll")
    time.sleep(1)
    
    # Still within timeout
    window.add_event("click")
    
    # Now exceed the timeout with a long gap
    time.sleep(3)  # 3 seconds > 2 second timeout
    
    # New session starts
    window.add_event("submit")
    
    print(f"Events in current session: {window.get_events()}")
    print(f"Event count: {window.event_count}")
    print(f"Session length (seconds): {window.get_session_length():.1f}")