Skip to content

Speakr is a personal, self-hosted web application designed for transcribing audio recordings

Python
2.5 KB
Raw Blame
"""Factory for configuring file storage backends from environment variables."""

from __future__ import annotations

from dataclasses import dataclass
from typing import Optional

from .local import LocalStorageBackend
from .s3 import S3StorageBackend


@dataclass
class StorageSettings:
    backend: str
    local_root: str
    key_prefix: str
    staging_dir: str
    presign_ttl_seconds: int
    presign_public_ttl_seconds: int
    s3_bucket_name: Optional[str] = None
    s3_region: Optional[str] = None
    s3_endpoint_url: Optional[str] = None
    s3_access_key_id: Optional[str] = None
    s3_secret_access_key: Optional[str] = None
    s3_session_token: Optional[str] = None
    s3_use_path_style: bool = False
    s3_verify_ssl: bool = True


def load_storage_settings_from_env() -> StorageSettings:
    # Kept for backward compatibility of the factory API, but values now come
    # from app_config to avoid duplicated env parsing / drift.
    from src.config import app_config

    return StorageSettings(
        backend=(app_config.FILE_STORAGE_BACKEND or 'local').strip().lower() or 'local',
        local_root=app_config.UPLOAD_FOLDER,
        key_prefix=(app_config.FILE_STORAGE_KEY_PREFIX or 'recordings').strip().strip('/').replace('\\', '/'),
        staging_dir=app_config.FILE_STORAGE_STAGING_DIR,
        presign_ttl_seconds=int(app_config.S3_PRESIGN_TTL_SECONDS),
        presign_public_ttl_seconds=int(app_config.S3_PRESIGN_PUBLIC_TTL_SECONDS),
        s3_bucket_name=app_config.S3_BUCKET_NAME,
        s3_region=app_config.S3_REGION,
        s3_endpoint_url=app_config.S3_ENDPOINT_URL,
        s3_access_key_id=app_config.S3_ACCESS_KEY_ID,
        s3_secret_access_key=app_config.S3_SECRET_ACCESS_KEY,
        s3_session_token=app_config.S3_SESSION_TOKEN,
        s3_use_path_style=bool(app_config.S3_USE_PATH_STYLE),
        s3_verify_ssl=bool(app_config.S3_VERIFY_SSL),
    )


def build_local_backend(settings: StorageSettings) -> LocalStorageBackend:
    return LocalStorageBackend(settings.local_root)


def build_s3_backend(settings: StorageSettings) -> Optional[S3StorageBackend]:
    if not settings.s3_bucket_name:
        return None
    return S3StorageBackend(
        bucket=settings.s3_bucket_name,
        region=settings.s3_region,
        endpoint_url=settings.s3_endpoint_url,
        access_key_id=settings.s3_access_key_id,
        secret_access_key=settings.s3_secret_access_key,
        session_token=settings.s3_session_token,
        use_path_style=settings.s3_use_path_style,
        verify_ssl=settings.s3_verify_ssl,
    )