Pace bulk watchlist refresh requests

app_support.py

@@ -16,7 +16,7 @@ from uuid import uuid4
 PROJECT_ROOT = Path(__file__).resolve().parent
 ANI_CLI = os.environ.get("ANI_CLI_BIN") or shutil.which("ani-cli") or "ani-cli"
 APP_NAME = "ani-cli-web"
-VERSION = "0.31.1"
+VERSION = "0.32.0"
 ALLANIME_BASE = "allanime.day"
 ALLANIME_API = f"https://api.{ALLANIME_BASE}"
 ALLANIME_REFERER = "https://allmanga.to"
@@ -45,6 +45,9 @@ WORKER_SHUTDOWN_TIMEOUT_SECONDS = 10
 WATCHLIST_AUTO_REFRESH_DEFAULT_MINUTES = 60
 WATCHLIST_AUTO_REFRESH_MIN_MINUTES = 1
 WATCHLIST_AUTO_REFRESH_MAX_MINUTES = 7 * 24 * 60
+WATCHLIST_REFRESH_DELAY_DEFAULT_SECONDS = 5
+WATCHLIST_REFRESH_DELAY_MIN_SECONDS = 0
+WATCHLIST_REFRESH_DELAY_MAX_SECONDS = 300
 
 
 def env_flag(name, default=False):
@@ -119,6 +122,7 @@ DEFAULT_CONFIG = {
     "quality": os.environ.get("ANI_CLI_QUALITY", "best"),
     "watchlist_auto_refresh_enabled": False,
     "watchlist_auto_refresh_minutes": WATCHLIST_AUTO_REFRESH_DEFAULT_MINUTES,
+    "watchlist_refresh_delay_seconds": WATCHLIST_REFRESH_DELAY_DEFAULT_SECONDS,
 }
 
 
@@ -261,6 +265,7 @@ def normalize_config(data):
     download_dir = str(config.get("download_dir") or DEFAULT_CONFIG["download_dir"])
     auto_refresh_enabled = config.get("watchlist_auto_refresh_enabled")
     auto_refresh_minutes = config.get("watchlist_auto_refresh_minutes")
+    refresh_delay_seconds = config.get("watchlist_refresh_delay_seconds")
 
     if isinstance(auto_refresh_enabled, str):
         auto_refresh_enabled = auto_refresh_enabled.strip().lower() in {"1", "true", "yes", "on"}
@@ -275,12 +280,21 @@ def normalize_config(data):
         WATCHLIST_AUTO_REFRESH_MIN_MINUTES,
         min(WATCHLIST_AUTO_REFRESH_MAX_MINUTES, auto_refresh_minutes),
     )
+    try:
+        refresh_delay_seconds = int(str(refresh_delay_seconds).strip() or WATCHLIST_REFRESH_DELAY_DEFAULT_SECONDS)
+    except (TypeError, ValueError):
+        refresh_delay_seconds = WATCHLIST_REFRESH_DELAY_DEFAULT_SECONDS
+    refresh_delay_seconds = max(
+        WATCHLIST_REFRESH_DELAY_MIN_SECONDS,
+        min(WATCHLIST_REFRESH_DELAY_MAX_SECONDS, refresh_delay_seconds),
+    )
 
     config["mode"] = mode if mode in MODE_CHOICES else "sub"
     config["quality"] = quality if quality in QUALITY_CHOICES else "best"
     config["download_dir"] = str(Path(download_dir).expanduser())
     config["watchlist_auto_refresh_enabled"] = auto_refresh_enabled
     config["watchlist_auto_refresh_minutes"] = auto_refresh_minutes
+    config["watchlist_refresh_delay_seconds"] = refresh_delay_seconds
     return config