"""
core/blurt.py - Defines the Blurt class that provides voice actions using platform-specific drivers.
This is the main entry point for all class-based usage.
"""
import platform
from typing import Optional, Dict, List
from blurt.core.voice_config import VoiceConfig
from blurt.drivers.base_driver import BaseDriver
from blurt.drivers.driver_macos import MacOSDriver
from blurt.drivers.driver_linux import LinuxDriver
from blurt.drivers.driver_windows import WindowsDriver
from blurt.constants import DEFAULT_SOUND_FILE
[docs]
class Blurt:
"""
Blurt is a cross-platform voice utility class that lets you speak messages, beep, or play sounds.
It supports macOS, Linux, and Windows, and automatically chooses the correct driver.
"""
def __init__(self, config: Optional[Dict] = None):
"""
Initialize Blurt with optional config (rate, volume, voice, etc.)
Priority: user config > env config > default config
"""
self.config = VoiceConfig(config).as_dict()
self.driver = self._select_driver()
def _select_driver(self) -> BaseDriver:
"""
Select and initialize the correct platform-specific driver.
"""
system = platform.system()
if system == "Darwin":
return MacOSDriver(**self.config)
elif system == "Linux":
return LinuxDriver(**self.config)
elif system == "Windows":
return WindowsDriver(**self.config)
else:
raise RuntimeError(f"Unsupported platform: {system}")
[docs]
def say(self, message: str):
"""Speak a message aloud."""
self.driver.say(message)
[docs]
def beep(self):
"""Play a beep sound."""
self.driver.beep()
[docs]
def play_sound(self, path: Optional[str] = None):
"""
Play a sound file. Defaults to alert.mp3.
"""
if not path:
path = DEFAULT_SOUND_FILE
self.driver.play_sound(path)
[docs]
def list_voices(self) -> List[str]:
"""Return available voices on the system."""
return self.driver.list_voices()
[docs]
def set_rate(self, rate: int):
"""Set the speaking rate."""
self.driver.set_rate(rate)
[docs]
def set_volume(self, volume: float):
"""Set the speaking volume."""
self.driver.set_volume(volume)
[docs]
def set_voice(self, voice: str):
"""Set the system voice."""
self.driver.set_voice(voice)