From 1646b018bda0d40b38c747932029a41b8a7c8536 Mon Sep 17 00:00:00 2001 From: Kali Kaneko Date: Fri, 10 Jul 2015 12:57:44 -0400 Subject: [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. --- mail/README.rst | 11 +++++++++++ mail/docs/hacking.rst | 19 +++++++++++++++++++ 2 files changed, 30 insertions(+) diff --git a/mail/README.rst b/mail/README.rst index 317389a5..81b4cec9 100644 --- a/mail/README.rst +++ b/mail/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/mail/docs/hacking.rst b/mail/docs/hacking.rst index d5669e15..6c49c211 100644 --- a/mail/docs/hacking.rst +++ b/mail/docs/hacking.rst @@ -161,6 +161,25 @@ If looking for a quick way of inspecting mailboxes, have a look at ``getmail``:: From: Kali (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 -- cgit v1.2.3