from pathlib import Path
import os
from typing import Optional


def read_env_or_file(name: str, default: Optional[str] = None) -> Optional[str]:
    file_path = os.getenv(f"{name}_FILE")
    if file_path:
        return Path(file_path).read_text(encoding="utf-8").strip()

    value = os.getenv(name)
    if value is not None:
        return value

    return default