Function check_for_version_update

core/tasks.py:787–990

Check for new Dispatcharr versions on GitHub and create a notification if available. This task should be run periodically (e.g., daily) via Celery Beat. For dev builds (identified by __timestamp__), checks for stable releases only. For production builds, checks for stable releases.

()

@shared_task
def check_for_version_update():
    """
    Check for new Dispatcharr versions on GitHub and create a notification if available.
    This task should be run periodically (e.g., daily) via Celery Beat.

    For dev builds (identified by __timestamp__), checks for stable releases only.
    For production builds, checks for stable releases.

    Note: Dev builds are container images from the dev branch and don't have GitHub releases.
    This checks if a stable release is available so dev users know when to upgrade.
    """
    import requests
    from datetime import datetime, timezone
    from packaging import version as pkg_version
    from version import __version__, __timestamp__
    from core.models import SystemNotification
    from core.utils import dispatcharr_http_headers, send_websocket_notification

    try:
        is_dev_build = __timestamp__ is not None
        DISPATCHARR_HEADERS = dispatcharr_http_headers(content_type=None)

        if is_dev_build:
            # Check Docker Hub for newer dev builds
            docker_hub_url = "https://hub.docker.com/v2/repositories/dispatcharr/dispatcharr/tags/dev"

            response = requests.get(docker_hub_url, headers=DISPATCHARR_HEADERS, timeout=10)

            if response.status_code != 200:
                logger.warning(f"Failed to check Docker Hub for dev updates: HTTP {response.status_code}")
                return

            dev_tag_data = response.json()
            docker_last_updated = dev_tag_data.get("last_updated")

            if not docker_last_updated:
                logger.warning("No last_updated timestamp found in Docker Hub response")
                return

            # Parse timestamps for comparison
            local_dt = datetime.strptime(__timestamp__, "%Y%m%d%H%M%S").replace(tzinfo=timezone.utc)
            docker_dt = datetime.fromisoformat(docker_last_updated.replace('Z', '+00:00'))

            # Calculate difference in minutes
            diff_minutes = (docker_dt - local_dt).total_seconds() / 60

            # Threshold to account for build/push time differences
            THRESHOLD_MINUTES = 10

            if diff_minutes > THRESHOLD_MINUTES:
                logger.info(f"New dev build available on Docker Hub (updated {int(diff_minutes)} minutes after current build)")

                # Delete any old version update notifications (both dev and stable, in case user switched)
                deleted_count = SystemNotification.objects.filter(
                    notification_type='version_update'
                ).delete()[0]
                if deleted_count > 0:
                    logger.debug(f"Deleted {deleted_count} old dev build notification(s)")