From e40cd6048d2e4f466cfff636e21c71700f94aeee Mon Sep 17 00:00:00 2001
From: Trenton H <797416+stumpylog@users.noreply.github.com>
Date: Thu, 30 Apr 2026 08:48:23 -0700
Subject: [PATCH] test(mail): add mail_mocker fixture wrapping MailMocker
 helper

---
 src/paperless_mail/tests/conftest.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/src/paperless_mail/tests/conftest.py b/src/paperless_mail/tests/conftest.py
index 13cf87473..ae4d78c9c 100644
--- a/src/paperless_mail/tests/conftest.py
+++ b/src/paperless_mail/tests/conftest.py
@@ -63,3 +63,20 @@ def oauth_settings(settings):
     settings.OUTLOOK_OAUTH_CLIENT_ID = "test_outlook_client_id"
     settings.OUTLOOK_OAUTH_CLIENT_SECRET = "test_outlook_client_secret"
     return settings
+
+
+@pytest.fixture()
+def mail_mocker(db: None):
+    """
+    Provides a MailMocker instance with its `MailBox` and
+    `queue_consumption_tasks` patches active. Cleanups registered via
+    TestCase.addCleanup are run on teardown by calling doCleanups().
+    """
+    from paperless_mail.tests.test_mail import MailMocker
+
+    mocker = MailMocker()
+    mocker.setUp()
+    try:
+        yield mocker
+    finally:
+        mocker.doCleanups()