feat(testing.email): add Email.dump

Signed-off-by: Kevin Morris <kevr@0cost.org>

test/conftest.py

@@ -217,3 +217,15 @@ def db_test(db_session: scoped_session) -> None:
 @pytest.fixture
 def git(tmpdir: py.path.local) -> GitRepository:
     yield GitRepository(tmpdir)
+
+
+@pytest.fixture
+def email_test() -> None:
+    """
+    A decoupled test email setup fixture.
+
+    When using the `db_test` fixture, this fixture is redundant. Otherwise,
+    email tests need to run through our `setup_email` function to ensure
+    that we set them up to be used via aurweb.testing.email.Email.
+    """
+    setup_email()

test/test_email.py

@@ -0,0 +1,59 @@
+import io
+
+from subprocess import PIPE, Popen
+
+import pytest
+
+from aurweb import config
+from aurweb.testing.email import Email
+
+
+@pytest.fixture(autouse=True)
+def setup(email_test):
+    return
+
+
+def sendmail(from_: str, to_: str, content: str) -> Email:
+    binary = config.get("notifications", "sendmail")
+    proc = Popen(binary, stdin=PIPE, stdout=PIPE, stderr=PIPE)
+    content = f"From: {from_}\nTo: {to_}\n\n{content}"
+    proc.communicate(content.encode())
+    proc.wait()
+    assert proc.returncode == 0
+
+
+def test_email_glue():
+    """ Test that Email.glue() decodes both base64 and decoded content. """
+    body = "Test email."
+    sendmail("test@example.org", "test@example.org", body)
+    assert Email.count() == 1
+
+    email1 = Email(1)
+    email2 = Email(1)
+    assert email1.glue() == email2.glue()
+
+
+def test_email_dump():
+    """ Test that Email.dump() dumps a single email. """
+    body = "Test email."
+    sendmail("test@example.org", "test@example.org", body)
+    assert Email.count() == 1
+
+    stdout = io.StringIO()
+    Email.dump(file=stdout)
+    content = stdout.getvalue()
+    assert "== Email #1 ==" in content
+
+
+def test_email_dump_multiple():
+    """ Test that Email.dump() dumps multiple emails. """
+    body = "Test email."
+    sendmail("test@example.org", "test@example.org", body)
+    sendmail("test2@example.org", "test2@example.org", body)
+    assert Email.count() == 2
+
+    stdout = io.StringIO()
+    Email.dump(file=stdout)
+    content = stdout.getvalue()
+    assert "== Email #1 ==" in content
+    assert "== Email #2 ==" in content