mirror of
https://github.com/denizsafak/abogen.git
synced 2026-07-18 13:40:27 +02:00
Artem Akymenko
5816feb6da
Add voices field to TTSBackendMetadata so each backend's supported voice list is part of its metadata rather than external constants. - Add voices: tuple[str, ...] = () to TTSBackendMetadata - Create _KOKORO_METADATA / _SUPERTONIC_METADATA as single source of truth for both metadata property and registry registration - Update KokoroBackend.get_available_voices() to use self.metadata.voices - Update SupertonicBackend.get_available_voices() to use self.metadata.voices - Add tests for voices field, metadata voice content, and unified instance identity
90 lines
1.9 KiB
Python
90 lines
1.9 KiB
Python
"""
|
|
TTS Backend Interface
|
|
|
|
This module defines the protocol for TTS backends and the
|
|
metadata model that describes a backend implementation.
|
|
"""
|
|
|
|
from dataclasses import dataclass
|
|
from typing import Protocol, List, Dict, Any
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class TTSBackendMetadata:
|
|
"""
|
|
Immutable metadata describing a TTS backend implementation.
|
|
|
|
Attributes:
|
|
id: Unique backend identifier (e.g. ``"kokoro"``, ``"supertonic"``).
|
|
name: Human-readable display name.
|
|
description: Short description of the backend.
|
|
voices: Tuple of supported voice identifiers.
|
|
"""
|
|
|
|
id: str
|
|
name: str
|
|
description: str
|
|
voices: tuple[str, ...] = ()
|
|
|
|
|
|
class TTSBackend(Protocol):
|
|
"""
|
|
Protocol for TTS backends.
|
|
|
|
All TTS backends must implement this interface to be compatible
|
|
with the application.
|
|
"""
|
|
|
|
@property
|
|
def metadata(self) -> TTSBackendMetadata:
|
|
...
|
|
|
|
def __init__(self, **kwargs) -> None:
|
|
"""
|
|
Initialize the TTS backend.
|
|
|
|
Args:
|
|
**kwargs: Backend-specific configuration parameters
|
|
"""
|
|
...
|
|
|
|
def synthesize(self, text: str, **kwargs) -> bytes:
|
|
"""
|
|
Synthesize speech from text.
|
|
|
|
Args:
|
|
text: Text to synthesize
|
|
**kwargs: Additional parameters for synthesis
|
|
|
|
Returns:
|
|
Audio data as bytes
|
|
"""
|
|
...
|
|
|
|
def get_available_voices(self) -> List[str]:
|
|
"""
|
|
Get list of available voices.
|
|
|
|
Returns:
|
|
List of voice identifiers
|
|
"""
|
|
...
|
|
|
|
def get_supported_formats(self) -> List[str]:
|
|
"""
|
|
Get list of supported audio formats.
|
|
|
|
Returns:
|
|
List of supported audio formats
|
|
"""
|
|
...
|
|
|
|
def get_info(self) -> Dict[str, Any]:
|
|
"""
|
|
Get backend information.
|
|
|
|
Returns:
|
|
Dictionary with backend information
|
|
"""
|
|
...
|