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

def register_settings_routes — Register Settings screens, fragments, and configuration writes.

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,
) → None

Register 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

app
type: FastAPI

FastAPI application receiving the Settings routes.

load_state
type: _LoadSettingsState = load_settings_state

Function that loads the current configuration snapshot.

save_defaults
type: _SaveDefaults = save_default_models

Function that persists default models for the active profile.

save_profile_settings_fn
type: Callable[..., None] = save_profile_settings

Function that persists editable active-profile settings.

save_provider_connection_fn
type: Callable[..., None] = save_provider_connection

Function that persists an existing provider connection.

save_model_inference_fn
type: Callable[..., None] = save_model_inference

Function that persists a model's default inference parameters.