Nathanwoodburn.github.io/cache_helper.py

"""
Cache helper module for expensive API calls and configuration.
Provides centralized caching with TTL for external API calls.
"""

import datetime
import json
import os
from functools import lru_cache

import requests

# Cache storage for git data
_git_data_cache = {"data": None, "timestamp": 0}
_git_data_ttl = 300  # 5 minutes cache


def get_git_latest_activity():
    """
    Get latest git activity with caching (5 minute TTL).

    Returns:
        dict: Git activity data or default values
    """
    global _git_data_cache
    current_time = datetime.datetime.now(tz=datetime.UTC).timestamp()

    # Check if cache is valid
    if (
        _git_data_cache["data"]
        and (current_time - _git_data_cache["timestamp"]) < _git_data_ttl
    ):
        return _git_data_cache["data"]

    # Fetch new data
    git = requests.get(
        "https://git.woodburn.au/api/v1/users/nathanwoodburn/activities/feeds?only-performed-by=true&limit=1",
        headers={
            "Authorization": os.getenv("GIT_AUTH") or os.getenv("git_token") or ""
        },
        timeout=5,
    )
    git_data = git.json()
    if git_data and len(git_data) > 0:
        result = git_data[0]
        _git_data_cache = {"data": result, "timestamp": current_time}
        return result

    # Return cached or default
    if _git_data_cache["data"]:
        return _git_data_cache["data"]

    return {
        "repo": {
            "html_url": "https://nathan.woodburn.au",
            "name": "nathanwoodburn.github.io",
            "description": "Personal website",
        }
    }


# Cache storage for projects
_projects_cache = {"data": None, "timestamp": 0}
_projects_ttl = 7200  # 2 hours cache


def get_projects(limit=3):
    """
    Get projects list with caching (2 hour TTL).

    Args:
        limit (int): Number of projects to return

    Returns:
        list: List of project dictionaries
    """
    global _projects_cache
    current_time = datetime.datetime.now(tz=datetime.UTC).timestamp()

    # Check if cache is valid
    if (
        _projects_cache["data"]
        and (current_time - _projects_cache["timestamp"]) < _projects_ttl
    ):
        return _projects_cache["data"][:limit]

    # Fetch new data
    projects = []
    projectsreq = requests.get(
        "https://git.woodburn.au/api/v1/users/nathanwoodburn/repos", timeout=5
    )
    projects = projectsreq.json()

    # Check for pagination
    pageNum = 2
    while 'rel="next"' in projectsreq.headers.get("link", ""):
        projectsreq = requests.get(
            f"https://git.woodburn.au/api/v1/users/nathanwoodburn/repos?page={pageNum}",
            timeout=5,
        )
        projects += projectsreq.json()
        pageNum += 1
        # Safety limit
        if pageNum > 10:
            break

    # Process projects
    for project in projects:
        if project.get("avatar_url") in ("https://git.woodburn.au/", ""):
            project["avatar_url"] = "/favicon.png"
        project["name"] = project["name"].replace("_", " ").replace("-", " ")

    # Sort by last updated
    projects_sorted = sorted(
        projects, key=lambda x: x.get("updated_at", ""), reverse=True
    )

    # Remove duplicates by name
    seen_names = set()
    unique_projects = []
    for project in projects_sorted:
        if project["name"] not in seen_names:
            unique_projects.append(project)
            seen_names.add(project["name"])

    _projects_cache = {"data": unique_projects, "timestamp": current_time}
    return unique_projects[:limit]


# Cached wallet data loaders
@lru_cache(maxsize=1)
def get_wallet_tokens():
    """
    Get wallet tokens with caching.

    Returns:
        list: List of token dictionaries
    """
    with open(".well-known/wallets/.tokens") as file:
        return json.load(file)


@lru_cache(maxsize=1)
def get_coin_names():
    """
    Get coin names with caching.

    Returns:
        dict: Dictionary of coin names
    """
    with open(".well-known/wallets/.coins") as file:
        return json.load(file)


@lru_cache(maxsize=1)
def get_wallet_domains():
    """
    Get wallet domains with caching.

    Returns:
        dict: Dictionary of wallet domains
    """
    if os.path.isfile(".well-known/wallets/.domains"):
        with open(".well-known/wallets/.domains") as file:
            return json.load(file)