Function user_cards

Scripts/ButSystem.py:1254–1286

Return users with profile info, sorted online-first, plus counts.

(scope: str, exclude: Optional[str]=None)

def load_or_create_session_key() -> str:
    """load_or_create_session_key.

Internal helper function.

This docstring was added automatically to improve maintainability.

Returns:
    Varies.
"""
    if os.path.exists(SESSION_KEY_PATH):
        raw = open(SESSION_KEY_PATH, "rb").read().strip().decode("utf-8", errors="ignore")
        return raw or base64.urlsafe_b64encode(os.urandom(32)).decode()
    key = base64.urlsafe_b64encode(os.urandom(32)).decode()
    with open(SESSION_KEY_PATH, "wb") as f:
        f.write(key.encode("utf-8"))
    try:
        os.chmod(SESSION_KEY_PATH, 0o600)
    except Exception:
        pass
    return key

# ---------------------------
# Presence (online/offline) — heartbeat
# ---------------------------

PRESENCE = {}  # scope -> {username: last_seen_ts}
PRESENCE_LOCK = threading.Lock()
ONLINE_WINDOW = 45  # seconds

def current_scope() -> str:
    """Return a presence scope based on the host used to reach the app.

    This keeps 'online' accurate per generated link (local vs cloudflared vs tor),
    so users are only shown online if they're actually active on the same link.
    """
    try: