feat: Weather Assistant - conversational AI chat with function calling, screen reader support, and global weather coverage

pyproject.toml

@@ -51,6 +51,9 @@ build = [
     "pyinstaller>=6.0.0",
     "pillow>=10.0.0",
 ]
+screenreader = [
+    "prismatoid>=0.7.0",
+]
 
 [project.scripts]
 accessiweather = "accessiweather.main:main"
@@ -169,4 +172,3 @@ line-ending = "auto"
 
 [tool.ruff.lint.mccabe]
 max-complexity = 15
-

src/accessiweather/screen_reader.py

@@ -0,0 +1,51 @@
+"""
+Thin wrapper around prismatoid for screen reader announcements.
+
+Provides graceful fallback when prismatoid is not installed.
+"""
+
+import logging
+
+logger = logging.getLogger(__name__)
+
+try:
+    import prism
+
+    PRISM_AVAILABLE = True
+except ImportError:
+    PRISM_AVAILABLE = False
+    logger.debug("prismatoid not installed; screen reader support disabled")
+
+
+class ScreenReaderAnnouncer:
+    """Announces text via screen reader using prismatoid, with graceful fallback."""
+
+    def __init__(self) -> None:
+        """Initialize the announcer, acquiring a screen reader backend if possible."""
+        self._backend = None
+        if PRISM_AVAILABLE:
+            try:
+                ctx = prism.Context()
+                self._backend = ctx.acquire_best()
+                logger.info("Screen reader backend acquired: %s", self._backend)
+            except Exception:
+                logger.warning("Failed to acquire screen reader backend", exc_info=True)
+                self._backend = None
+        else:
+            logger.debug("prismatoid not available; announcer will be a no-op")
+
+    def announce(self, text: str) -> None:
+        """Speak text via screen reader. No-op if unavailable."""
+        if self._backend is not None:
+            try:
+                self._backend.speak(text, interrupt=False)
+            except Exception:
+                logger.warning("Failed to announce text", exc_info=True)
+
+    def is_available(self) -> bool:
+        """Return whether a screen reader backend was successfully acquired."""
+        return self._backend is not None
+
+    def shutdown(self) -> None:
+        """Clean up resources."""
+        self._backend = None

src/accessiweather/ui/dialogs/__init__.py

@@ -10,6 +10,7 @@
 from .soundpack_manager_dialog import show_soundpack_manager_dialog
 from .soundpack_wizard_dialog import SoundPackWizardDialog
 from .uv_index_dialog import show_uv_index_dialog
+from .weather_assistant_dialog import show_weather_assistant_dialog
 from .weather_history_dialog import show_weather_history_dialog
 
 __all__ = [
@@ -22,6 +23,7 @@
     "show_settings_dialog",
     "show_soundpack_manager_dialog",
     "show_uv_index_dialog",
+    "show_weather_assistant_dialog",
     "show_weather_history_dialog",
     "SoundPackWizardDialog",
 ]