summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKali Kaneko <kali@leap.se>2015-07-10 12:57:44 -0400
committerRuben Pollan <meskio@sindominio.net>2015-07-13 11:55:31 -0400
commita36a3bd419bdf33d66ed77277089db537e8b7b36 (patch)
treec0967f88de9a3cf9f7f012ded23c29a8e02de40e
parent5cbb56ab995c620595ab6b840ebabd535fb31244 (diff)
[docs] add some documentation about imap regression tests
This is quite manual for the moment being, and it's not integrated into the unittests. But it is useful to have it documented, with some luck we can automate the process even more and add it to the CI quite soon.
-rw-r--r--README.rst11
-rw-r--r--docs/hacking.rst19
2 files changed, 30 insertions, 0 deletions
diff --git a/README.rst b/README.rst
index 317389a..81b4cec 100644
--- a/README.rst
+++ b/README.rst
@@ -24,3 +24,14 @@ fails::
trial -u leap.mail.imap
Read the *trial* manpage for more options .
+
+imap regressions
+----------------
+
+For testing the IMAP server implementation, there are a couple of utilities.
+From the ``leap.mail.imap.tests`` folder, and with an already initialized server
+running::
+
+ ./regressions_mime_struct user@provider pass path_to_samples/
+
+You can find several message samples in the ``leap/mail/tests`` folder.
diff --git a/docs/hacking.rst b/docs/hacking.rst
index d5669e1..6c49c21 100644
--- a/docs/hacking.rst
+++ b/docs/hacking.rst
@@ -161,6 +161,25 @@ If looking for a quick way of inspecting mailboxes, have a look at ``getmail``::
From: Kali <kali@leap.se>
(snip)
+
+IMAP Message Rendering Regressions
+----------------------------------
+
+For testing the IMAP server implementation, there is a litte regressions script
+that needs some manual work from your side.
+
+First of all, you need an already initialized account. Which for now basically
+means you have created a new account with a provider that offers the Encrypted
+Mail Service, using the Bitmask Client wizard. Then you need to log in with that
+account, and let it generate the secrets and sync with the remote for a first
+time. After this you can run the twistd server locally and offline.
+
+From the ``leap.mail.imap.tests`` folder, and with an already initialized server
+running::
+
+ ./regressions_mime_struct user@provider pass path_to_samples/
+
+You can find several message samples in the ``leap/mail/tests`` folder.
Debugging IMAP commands