Make clearer the distinction between "storage-mode" and "delta-mode" usage of *Settings objects

- Storage mode: for use in `self._settings`. All fields should be specified, i.e. should not be `NOT_GIVEN`.
- Delta mode: for use in `*UpdateSettingsFrame`.

In service of this, this commit:
- Adds a runtime check that all fields are specified in storage mode
- Updates all services to specify all fields in stored settings
- Updates all services to no longer check for `is_given` in stored settings (not necessary anymore)
- Updates relevant docstrings
- Renames `update` to `delta` in `*UpdateSettingsFrame`
- Updates community integrations guide
This commit is contained in:
Paul Kompfner
2026-02-24 10:52:05 -05:00
parent 57d25c564c
commit bcc2b4def4
145 changed files with 732 additions and 587 deletions

View File

@@ -260,9 +260,11 @@ class MySTTService(STTService):
_settings: MySTTSettings
def __init__(self, *, model: str, region: str, **kwargs):
def __init__(self, *, model: str, language: str, region: str, **kwargs):
super().__init__(**kwargs)
self._settings = MySTTSettings(model=model, region=region)
# Initial value must be provided for every field in self._settings
# before service is started
self._settings = MySTTSettings(model=model, language=language, region=region)
self._sync_model_name_to_metrics()
```
@@ -298,7 +300,7 @@ async def _update_settings(self, update: STTSettings) -> dict[str, Any]:
if "language" in changed:
await self._update_language()
else:
# TODO: handle changes to other settings soon!
# TODO: this should be temporary - handle changes to other settings soon!
self._warn_unhandled_updated_settings(changed.keys() - {"language"})
return changed