Pace bulk watchlist refresh requests

test_app.py

@@ -1074,6 +1074,7 @@ class ConfigSnapshotTests(unittest.TestCase):
             "download_dir": "/tmp/example",
             "watchlist_auto_refresh_enabled": False,
             "watchlist_auto_refresh_minutes": 60,
+            "watchlist_refresh_delay_seconds": 5,
         }
         try:
             snapshot = APP.get_config_snapshot()
@@ -1086,16 +1087,19 @@ class ConfigSnapshotTests(unittest.TestCase):
         config = APP.normalize_config({})
         self.assertFalse(config["watchlist_auto_refresh_enabled"])
         self.assertEqual(config["watchlist_auto_refresh_minutes"], 60)
+        self.assertEqual(config["watchlist_refresh_delay_seconds"], 5)
 
     def test_normalize_config_parses_watchlist_schedule_fields(self):
         config = APP.normalize_config(
             {
                 "watchlist_auto_refresh_enabled": "true",
                 "watchlist_auto_refresh_minutes": "15",
+                "watchlist_refresh_delay_seconds": "7",
             }
         )
         self.assertTrue(config["watchlist_auto_refresh_enabled"])
         self.assertEqual(config["watchlist_auto_refresh_minutes"], 15)
+        self.assertEqual(config["watchlist_refresh_delay_seconds"], 7)
 
 
 class WatchlistAutoRefreshSchedulerTests(unittest.TestCase):
@@ -1112,6 +1116,28 @@ class WatchlistAutoRefreshSchedulerTests(unittest.TestCase):
         self.assertEqual(scheduler.tick(now_monotonic=700.0), 600)
         start.assert_called_once_with(source="scheduled")
 
+    def test_refresh_job_waits_between_series_using_configured_delay(self):
+        class FakeStore:
+            def all_show_ids(self):
+                return ["show-a", "show-b", "show-c"]
+
+            def refresh(self, show_id, include_thumbnail=True):
+                return {"title": show_id, "status": "updated"}
+
+        service = APP.WatchlistRefreshJobs(
+            FakeStore(),
+            config_getter=lambda: {"watchlist_refresh_delay_seconds": 5},
+            start_worker=False,
+        )
+        job = service.start()["job"]
+        job = service._next_pending()
+
+        with mock.patch.object(service.stop_event, "wait", return_value=False) as wait_mock:
+            service._run_job(job)
+
+        self.assertEqual(wait_mock.call_count, 2)
+        wait_mock.assert_called_with(5)
+
     def test_tick_resets_timer_when_schedule_changes(self):
         config = {
             "watchlist_auto_refresh_enabled": True,
@@ -1196,6 +1222,7 @@ class StartupBehaviorTests(unittest.TestCase):
                 "download_dir": "/tmp/old",
                 "watchlist_auto_refresh_enabled": False,
                 "watchlist_auto_refresh_minutes": 60,
+                "watchlist_refresh_delay_seconds": 5,
             }
             APP.WATCHLIST_AUTO_REFRESH = mock.Mock()
             saved = APP.save_runtime_config(
@@ -1205,6 +1232,7 @@ class StartupBehaviorTests(unittest.TestCase):
                     "download_dir": "/tmp/new",
                     "watchlist_auto_refresh_enabled": True,
                     "watchlist_auto_refresh_minutes": 15,
+                    "watchlist_refresh_delay_seconds": 8,
                 }
             )
             self.assertEqual(saved["mode"], "dub")
@@ -1212,6 +1240,7 @@ class StartupBehaviorTests(unittest.TestCase):
             self.assertEqual(APP.CONFIG["quality"], "720")
             self.assertTrue(APP.CONFIG["watchlist_auto_refresh_enabled"])
             self.assertEqual(APP.CONFIG["watchlist_auto_refresh_minutes"], 15)
+            self.assertEqual(APP.CONFIG["watchlist_refresh_delay_seconds"], 8)
             APP.WATCHLIST_AUTO_REFRESH.notify_config_changed.assert_called_once_with()
         finally:
             APP.CONFIG = original
@@ -1247,12 +1276,13 @@ class HandlerRouteTests(unittest.TestCase):
             APP.initialize_runtime(start_workers=False)
 
     def test_config_post_accepts_watchlist_schedule_fields(self):
-        body = b'{"download_dir":"/tmp/example","mode":"sub","quality":"best","watchlist_auto_refresh_enabled":true,"watchlist_auto_refresh_minutes":"25"}'
+        body = b'{"download_dir":"/tmp/example","mode":"sub","quality":"best","watchlist_auto_refresh_enabled":true,"watchlist_auto_refresh_minutes":"25","watchlist_refresh_delay_seconds":"9"}'
         handler = DummyHandler("/api/config", body=body, content_length=len(body))
         APP.Handler.do_POST(handler)
         self.assertEqual(handler.json_status, HTTPStatus.OK)
         self.assertTrue(handler.json_payload["watchlist_auto_refresh_enabled"])
         self.assertEqual(handler.json_payload["watchlist_auto_refresh_minutes"], 25)
+        self.assertEqual(handler.json_payload["watchlist_refresh_delay_seconds"], 9)
 
     def test_body_json_rejects_oversized_request(self):
         handler = DummyHandler("/api/watchlist/upload-thumbnail", body=b"{}", content_length=APP.MAX_JSON_BODY_BYTES + 1)