from __future__ import annotations import tempfile import unittest from pathlib import Path from unittest.mock import patch from backend.dto.common import ApiError, ErrorCode from backend.services.queue_service import QueueService from core.audit_service import AuditService from core.event_bus import EventBus from core.identity import RequestContext from database.db_helper import Database, DatabaseSettings, SqliteSettings from database.repositories.job_repository import JobRepository class QueueServiceTests(unittest.TestCase): def setUp(self): self.tmp = tempfile.TemporaryDirectory() self.database = Database( DatabaseSettings(sqlite=SqliteSettings(path=str(Path(self.tmp.name) / "imagestudio.db"))) ) self.database.initialize() self.audit_service = AuditService(self.database) self.event_bus = EventBus() self.queue_service = QueueService(JobRepository(self.database), self.audit_service, self.event_bus) self.ctx = RequestContext.from_astrbot( username="admin", user_id="user_001", permissions={"can_write"}, ) def tearDown(self): self.tmp.cleanup() def test_create_task_reuses_existing_idempotency_key(self): first = self.queue_service.create_task( { "status": "queued", "idempotency_key": "generate-node-001", "request": {"prompt": "portrait"}, }, self.ctx, ) second = self.queue_service.create_task( { "status": "queued", "idempotency_key": " generate-node-001 ", "request": {"prompt": "different prompt"}, }, self.ctx, ) self.assertEqual(first.task_id, second.task_id) self.assertEqual(second.request, {"prompt": "portrait"}) self.assertEqual(self.queue_service.list_jobs(page=1, page_size=10).total, 1) self.assertEqual(len(self.event_bus.history("generation.task_created")), 1) def test_blank_idempotency_key_is_treated_as_missing(self): first = self.queue_service.create_task({"status": "queued", "idempotency_key": " "}, self.ctx) second = self.queue_service.create_task({"status": "queued", "idempotency_key": ""}, self.ctx) self.assertNotEqual(first.task_id, second.task_id) self.assertIsNone(first.idempotency_key) self.assertIsNone(second.idempotency_key) def test_cancel_job_records_actor_reason_and_is_idempotent(self): task = self.queue_service.create_task({"status": "running", "metadata": {"worker_attempt": 1}}, self.ctx) cancelled = self.queue_service.cancel_job(task.task_id, self.ctx, reason="user stopped") repeated = self.queue_service.cancel_job(task.task_id, self.ctx, reason="ignored") self.assertEqual(cancelled.status, "cancelled") self.assertEqual(repeated.task_id, task.task_id) self.assertEqual(repeated.metadata["cancellation"]["reason"], "user stopped") self.assertEqual(cancelled.metadata["cancellation"]["requested_by"], "user_001") self.assertEqual(cancelled.metadata["cancellation"]["previous_status"], "running") self.assertTrue(self.queue_service.is_cancelled(task.task_id)) def test_retrying_task_cannot_be_cancelled_mid_execution(self): task = self.queue_service.create_task({"status": "failed"}, self.ctx) claimed = self.queue_service.begin_retry(task.task_id, self.ctx, operation_id="retry_test") with self.assertRaises(ApiError) as raised: self.queue_service.cancel_job(claimed.task_id, self.ctx) self.assertEqual(raised.exception.error_code, ErrorCode.TASK_NOT_CANCELABLE) self.assertEqual(self.queue_service.get_job(task.task_id).status, "retrying") def test_cancel_job_does_not_overwrite_terminal_state_from_stale_snapshot(self): task = self.queue_service.create_task({"status": "running"}, self.ctx) repository = self.queue_service.repository original_update_if_status = repository.update_if_status injected_terminal_update = False def finish_before_cancel(task_id, expected_statuses, payload): nonlocal injected_terminal_update if not injected_terminal_update: injected_terminal_update = True repository.update(task_id, {"status": "succeeded", "progress": 100}) return original_update_if_status(task_id, expected_statuses, payload) with patch.object(repository, "update_if_status", side_effect=finish_before_cancel): with self.assertRaises(ApiError) as raised: self.queue_service.cancel_job(task.task_id, self.ctx, reason="stale cancel") self.assertEqual(raised.exception.error_code, ErrorCode.TASK_NOT_CANCELABLE) self.assertEqual(raised.exception.details["status"], "succeeded") completed = self.queue_service.get_job(task.task_id) self.assertEqual(completed.status, "succeeded") self.assertNotIn("cancellation", completed.metadata) def test_dead_letter_batch_limits_are_normalized(self): for index in range(3): self.queue_service.create_task({"status": "failed", "error_message": f"failure {index}"}, self.ctx) none_moved = self.queue_service.move_failed_to_dead_letter(self.ctx, limit=0) self.assertEqual(none_moved["total"], 1) self.assertEqual(self.queue_service.queue_summary()["dead_letter"], 1) moved = self.queue_service.move_failed_to_dead_letter(self.ctx, limit=999) self.assertEqual(moved["total"], 2) requeued = self.queue_service.requeue_dead_letters(self.ctx, limit=-5) self.assertEqual(requeued["total"], 1) self.assertEqual(self.queue_service.queue_summary()["dead_letter"], 2) def test_recent_job_limit_is_normalized(self): repository = self.queue_service.repository for index in range(3): self.queue_service.create_task({"status": "queued", "request": {"index": index}}, self.ctx) self.assertEqual(len(repository.recent(limit=0)), 1) self.assertEqual(len(repository.recent(limit=-5)), 1) self.assertEqual(len(repository.recent(limit=999)), 3) def test_job_repository_pagination_is_normalized(self): repository = self.queue_service.repository for index in range(3): self.queue_service.create_task({"status": "queued", "request": {"index": index}}, self.ctx) zero_items, zero_total = repository.list(page=0, page_size=0) huge_items, huge_total = repository.list(page=1, page_size=999) self.assertEqual(len(zero_items), 1) self.assertEqual(zero_total, 3) self.assertEqual(len(huge_items), 3) self.assertEqual(huge_total, 3) if __name__ == "__main__": unittest.main()