feat: modernize Python codebase to 3.13+ minimum

- Set minimum Python version to 3.13, remove Python 2 compatibility
- Remove legacy imports: future, six, builtins, __future__, configparser,
  importlib-metadata, pep8, mock, unittest-parametrize
- Add modern type hints throughout (PEP 604 union syntax, PEP 585 generics)
- Replace .format() with f-strings, use super() without args
- Replace pytz with datetime.timezone, distutils.strtobool with inline impl
- Use conditional import for cec hardware dependency
- Clean up uv.lock (6 packages removed)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: vpetersson

.python-version

@@ -1 +1 @@
-3.11
+3.13

anthias_app/consumers.py

@@ -7,7 +7,7 @@
 
 
 class ViewerConsumer(WebSocketConsumer):
-    def connect(self):
+    def connect(self) -> None:
         from channels.layers import get_channel_layer
 
         self.accept()
@@ -20,7 +20,7 @@ def connect(self):
             )
         logger.info('Viewer WebSocket connected')
 
-    def disconnect(self, close_code):
+    def disconnect(self, close_code: int) -> None:
         from channels.layers import get_channel_layer
 
         channel_layer = get_channel_layer()
@@ -32,15 +32,15 @@ def disconnect(self, close_code):
             )
         logger.info('Viewer WebSocket disconnected')
 
-    def viewer_command(self, event):
+    def viewer_command(self, event: dict) -> None:
         self.send(text_data=json.dumps({
             'command': event['command'],
             'data': event.get('data'),
         }))
 
 
 class UIConsumer(WebSocketConsumer):
-    def connect(self):
+    def connect(self) -> None:
         from channels.layers import get_channel_layer
 
         self.accept()
@@ -52,7 +52,7 @@ def connect(self):
                 'ui', self.channel_name
             )
 
-    def disconnect(self, close_code):
+    def disconnect(self, close_code: int) -> None:
         from channels.layers import get_channel_layer
 
         channel_layer = get_channel_layer()
@@ -63,5 +63,5 @@ def disconnect(self, close_code):
                 'ui', self.channel_name
             )
 
-    def ui_update(self, event):
+    def ui_update(self, event: dict) -> None:
         self.send(text_data=json.dumps(event.get('data', {})))

anthias_app/helpers.py

@@ -11,7 +11,7 @@
 from settings import settings
 
 
-def template(request, template_name, context):
+def template(request, template_name: str, context: dict):
     """
     This is a helper function that is used to render a template
     with some global context. This is used to avoid having to
@@ -33,11 +33,11 @@ def template(request, template_name, context):
     return render(request, template_name, context)
 
 
-def prepare_default_asset(**kwargs):
+def prepare_default_asset(**kwargs) -> dict | None:
     if kwargs['mimetype'] not in ['image', 'video', 'webpage']:
         return
 
-    asset_id = 'default_{}'.format(uuid.uuid4().hex)
+    asset_id = f'default_{uuid.uuid4().hex}'
     duration = (
         int(get_video_duration(kwargs['uri']).total_seconds())
         if 'video' == kwargs['mimetype']
@@ -60,7 +60,7 @@ def prepare_default_asset(**kwargs):
     }
 
 
-def add_default_assets():
+def add_default_assets() -> None:
     settings.load()
 
     datetime_now = timezone.now()
@@ -75,7 +75,7 @@ def add_default_assets():
         '.screenly/default_assets.yml',
     )
 
-    with open(default_assets_yaml, 'r') as yaml_file:
+    with open(default_assets_yaml) as yaml_file:
         default_assets = yaml.safe_load(yaml_file).get('assets')
 
         for default_asset in default_assets:
@@ -92,7 +92,7 @@ def add_default_assets():
                 Asset.objects.create(**asset)
 
 
-def remove_default_assets():
+def remove_default_assets() -> None:
     settings.load()
 
     for asset in Asset.objects.all():

anthias_app/messaging.py

@@ -3,7 +3,9 @@
 logger = logging.getLogger(__name__)
 
 
-def send_to_viewer(command, data=None):
+def send_to_viewer(
+    command: str, data: str | None = None,
+) -> None:
     try:
         from asgiref.sync import async_to_sync
         from channels.layers import get_channel_layer
@@ -22,7 +24,7 @@ def send_to_viewer(command, data=None):
         logger.exception('Failed to send to viewer')
 
 
-def send_to_ui(data):
+def send_to_ui(data: dict) -> None:
     try:
         from asgiref.sync import async_to_sync
         from channels.layers import get_channel_layer

anthias_app/tasks.py

@@ -19,19 +19,19 @@
 _scheduler_lock = threading.Lock()
 
 
-def get_display_power_value():
+def get_display_power_value() -> str | bool | None:
     return _display_power
 
 
-def _update_display_power():
+def _update_display_power() -> None:
     global _display_power
     try:
         _display_power = diagnostics.get_display_power()
     except Exception:
         logger.exception('Failed to get display power')
 
 
-def cleanup():
+def cleanup() -> None:
     try:
         asset_dir = path.join(getenv('HOME', ''), 'screenly_assets')
         if path.isdir(asset_dir):
@@ -40,7 +40,7 @@ def cleanup():
         logger.exception('Cleanup failed')
 
 
-def reboot_anthias():
+def reboot_anthias() -> None:
     if is_balena_app():
         for attempt in Retrying(
             stop=stop_after_attempt(5),
@@ -54,7 +54,7 @@ def reboot_anthias():
         call(['reboot'])
 
 
-def shutdown_anthias():
+def shutdown_anthias() -> None:
     if is_balena_app():
         for attempt in Retrying(
             stop=stop_after_attempt(5),
@@ -68,7 +68,9 @@ def shutdown_anthias():
         call(['shutdown', '-h', 'now'])
 
 
-def _run_periodic(func, interval_seconds, name):
+def _run_periodic(
+    func, interval_seconds: int, name: str,
+) -> threading.Thread:
     def loop():
         while True:
             try:
@@ -82,7 +84,7 @@ def loop():
     return t
 
 
-def start_background_scheduler():
+def start_background_scheduler() -> None:
     global _scheduler_started
     with _scheduler_lock:
         if _scheduler_started:

anthias_app/views_ui.py

@@ -93,7 +93,7 @@ def system_info_data(request):
 
     git_branch = diagnostics.get_git_branch()
     git_short_hash = diagnostics.get_git_short_hash()
-    anthias_version = '{}@{}'.format(git_branch, git_short_hash)
+    anthias_version = f'{git_branch}@{git_short_hash}'
 
     ip_addresses = []
     import ipaddress
@@ -103,9 +103,9 @@ def system_info_data(request):
         for ip in node_ip.split():
             ip_obj = ipaddress.ip_address(ip)
             if isinstance(ip_obj, ipaddress.IPv6Address):
-                ip_addresses.append('http://[{}]'.format(ip))
+                ip_addresses.append(f'http://[{ip}]')
             else:
-                ip_addresses.append('http://{}'.format(ip))
+                ip_addresses.append(f'http://{ip}')
 
     info = {
         'loadavg': diagnostics.get_load_avg()['15 min'],

api/views/mixins.py

@@ -1,3 +1,4 @@
+import threading
 import uuid
 from base64 import b64encode
 from inspect import cleandoc
@@ -18,7 +19,6 @@
     RebootViewSerializerMixin,
     ShutdownViewSerializerMixin,
 )
-import threading
 
 from anthias_app.messaging import send_to_viewer
 from anthias_app.tasks import get_display_power_value, reboot_anthias, shutdown_anthias

bin/wait.py

@@ -1,7 +1,4 @@
-from __future__ import print_function, unicode_literals
-
 import time
-from builtins import range
 
 import sh
 

conftest.py

@@ -1,4 +1,6 @@
 import os
 
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'anthias_django.settings')
+os.environ.setdefault(
+    'DJANGO_SETTINGS_MODULE', 'anthias_django.settings'
+)
 os.environ.setdefault('ENVIRONMENT', 'test')

host_agent.py

@@ -1,7 +1,4 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-
-from __future__ import unicode_literals
 
 __author__ = 'Nash Kaminski'
 __license__ = 'Dual License: GPLv2 and Commercial License'