yera.ui.fastapi_routes.settings
Serve full Settings pages and validated HTMX configuration updates.
Read routes load a coherent settings snapshot and render either complete shell pages or contextual fragments. Write routes parse submitted fields through the rendering form boundary, apply configuration changes through injected save functions, and return validation or conflict responses without exposing secret values.
Symbols
register_settings_routes
register_settings_routes(
app: FastAPI,
load_state: _LoadSettingsState = load_settings_state,
save_defaults: _SaveDefaults = save_default_models,
save_profile_settings_fn: Callable[..., None] = save_profile_settings,
save_provider_connection_fn: Callable[..., None] = save_provider_connection,
save_model_inference_fn: Callable[..., None] = save_model_inference,
) → NoneRegister Settings screens, fragments, and configuration writes.
The route family covers appearance, active-profile settings, default
models, provider connections, and model inference defaults. Read routes
distinguish valid, unconfigured, and invalid configuration states. Write
routes return field-level validation responses, 409 conflict responses, or
an HX-Redirect after successful persistence.
Save functions are injected so route handling remains separate from configuration storage and can be exercised against real state boundaries.
Parameters
FastAPI application receiving the Settings routes.
Function that loads the current configuration snapshot.
Function that persists default models for the active profile.
Function that persists editable active-profile settings.
Function that persists an existing provider connection.
Function that persists a model's default inference parameters.