tests: add Python 3.9 compatibility

Add support for running integration tests on Python 3.9 through 3.14+
with minimal changes using modern Python features.

Changes:
- event.py: Add __future__ annotations import to enable modern type
  hint syntax (int | None) on Python 3.9, with fallback for @OverRide
  decorator (Python 3.12+)
- test_config_hotreload.py: Handle both builtin TimeoutError (Python
  3.11+) and concurrent.futures.TimeoutError (Python 3.9-3.10)
- test_path_rmdir.py: Reverse event order for Python < 3.10 due to
  different shutil.rmtree deletion ordering

This avoids using deprecated Union/Optional types while maintaining
backward compatibility.

Tested: 102 tests pass on Python 3.9.25

Assisted-by: Claude Code (claude-sonnet-4-5@20250929)

Author: Molter73

tests/event.py

@@ -1,8 +1,16 @@
+from __future__ import annotations
+
 import os
 from re import Pattern
 import string
 from enum import Enum
-from typing import Any, override
+from typing import Any
+
+try:
+    from typing import override
+except ImportError:
+    def override(func):
+        return func
 
 from internalapi.sensor.collector_pb2 import ProcessSignal
 from internalapi.sensor.sfa_pb2 import FileActivity

tests/test_config_hotreload.py

@@ -1,5 +1,6 @@
 import os
 from time import sleep
+from concurrent.futures import TimeoutError as FuturesTimeoutError
 
 from event import Event, EventType, Process
 
@@ -175,7 +176,7 @@ def test_no_paths_then_add(fact, fact_config, monitored_dir, server):
     e = Event(process=p, event_type=EventType.OPEN,
               file=fut, host_path=fut)
 
-    with pytest.raises(TimeoutError):
+    with pytest.raises((TimeoutError, FuturesTimeoutError)):
         server.wait_events([e])
 
     # Add paths back
@@ -216,7 +217,7 @@ def test_paths_then_remove(fact, fact_config, monitored_dir, server):
         f.write('This should be ignored')
     sleep(1)
 
-    with pytest.raises(TimeoutError):
+    with pytest.raises((TimeoutError, FuturesTimeoutError)):
         server.wait_events([e])
 
 

tests/test_path_rmdir.py

@@ -1,5 +1,6 @@
 import os
 import shutil
+import sys
 
 import pytest
 
@@ -17,7 +18,8 @@ def get_inode_removed_count(fact_config):
     Returns:
         The current value of host_scanner_scan{label="InodeRemoved"} metric.
     """
-    value = get_metric_value(fact_config, "host_scanner_scan", {"label": "InodeRemoved"})
+    value = get_metric_value(fact_config, "host_scanner_scan", {
+                             "label": "InodeRemoved"})
     return int(value) if value is not None else 0
 
 
@@ -31,8 +33,10 @@ def get_kernel_rmdir_processed(fact_config):
     Returns:
         The difference between Total and Ignored kernel_path_rmdir_events.
     """
-    total_str = get_metric_value(fact_config, "kernel_path_rmdir_events", {"label": "Total"})
-    ignored_str = get_metric_value(fact_config, "kernel_path_rmdir_events", {"label": "Ignored"})
+    total_str = get_metric_value(
+        fact_config, "kernel_path_rmdir_events", {"label": "Total"})
+    ignored_str = get_metric_value(
+        fact_config, "kernel_path_rmdir_events", {"label": "Ignored"})
 
     total = int(total_str) if total_str is not None else 0
     ignored = int(ignored_str) if ignored_str is not None else 0
@@ -80,7 +84,7 @@ def test_rmdir_empty(monitored_dir, server, fact_config, dirname):
 
     # File creation should be tracked
     e1 = Event(process=process, event_type=EventType.CREATION,
-              file=test_file, host_path=test_file)
+               file=test_file, host_path=test_file)
 
     server.wait_events([e1])
 
@@ -89,7 +93,7 @@ def test_rmdir_empty(monitored_dir, server, fact_config, dirname):
 
     # File deletion should be tracked
     e2 = Event(process=process, event_type=EventType.UNLINK,
-              file=test_file, host_path=test_file)
+               file=test_file, host_path=test_file)
 
     server.wait_events([e2])
 
@@ -183,6 +187,10 @@ def test_rmdir_recursive(monitored_dir, server, fact_config):
               file=file3, host_path=file3),
     ]
 
+    # Behavior of shutil.rmtree changed between python versions
+    if sys.version_info < (3, 10):
+        unlink_events.reverse()
+
     server.wait_events(unlink_events)
 
     # Check that all inodes and kernel events were tracked
@@ -244,7 +252,7 @@ def test_rmdir_ignored(monitored_dir, ignored_dir, server, fact_config):
 
     # Monitored file creation should generate an event
     e1 = Event(process=process, event_type=EventType.CREATION,
-              file=monitored_file, host_path=monitored_file)
+               file=monitored_file, host_path=monitored_file)
 
     server.wait_events([e1])
 
@@ -301,7 +309,7 @@ def test_rmdir_with_parent_inode(monitored_dir, server, fact_config):
 
     # Verify file creation is tracked
     e1 = Event(process=process, event_type=EventType.CREATION,
-              file=test_file, host_path=test_file)
+               file=test_file, host_path=test_file)
     server.wait_events([e1])
 
     # Create another file at the root level (parent directory)
@@ -310,7 +318,7 @@ def test_rmdir_with_parent_inode(monitored_dir, server, fact_config):
         f.write('root content')
 
     e2 = Event(process=process, event_type=EventType.CREATION,
-              file=root_file, host_path=root_file)
+               file=root_file, host_path=root_file)
     server.wait_events([e2])
 
     # Remove the subdirectory and its contents
@@ -344,14 +352,14 @@ def test_rmdir_with_parent_inode(monitored_dir, server, fact_config):
         f.write('new content')
 
     e4 = Event(process=process, event_type=EventType.CREATION,
-              file=new_file, host_path=new_file)
+               file=new_file, host_path=new_file)
     server.wait_events([e4])
 
     # Remove the new file to clean up
     os.remove(new_file)
 
     e5 = Event(process=process, event_type=EventType.UNLINK,
-              file=new_file, host_path=new_file)
+               file=new_file, host_path=new_file)
     server.wait_events([e5])
 
     # Final metric check: should be 3 total inodes (test_file, subdir, new_file)