Merge lp:~mago-contributors/mago/evolution into lp:~mago-contributors/mago/mago-1.0

[Ara Pulido]

[Ara Pulido (ara)]

Two major things:

1) Added basic tests for evolution (and notify-osd / message-indicator cross tests)
2) LDTP broke the API in version 1.6, and the imagacapture signature is different. Added a method to keep backwards compatibility.

[Nagappan Alagappan (nagappan)]

Nice work :)

review: Approve

[Javier Collado (javier.collado)]

Hello,

Thanks for the changes. It's really nice to have new applications such as
evolution included in the mago distribution.

There's one little thing that I would change to make the regular expression that
takes care of extracting the LDTP version more robust, just in case there are
multiple digits in the version string in the future (i.e. ldtp-99.99.99):

< pattern = re.compile("ldtp-(\d\.\d\.\d).*")
< m = pattern.match(version)

> pattern = re.compile("ldtp-(\d+\.\d+\.\d+)")
> m = pattern.search(version)

Best regards,
    Javier

Ara Pulido wrote:
> Ara Pulido has proposed merging lp:~mago-contributors/mago/evolution into lp:mago.
>
> Requested reviews:
> Mago Contributors (mago-contributors)
>
> Two major things:
>
> 1) Added basic tests for evolution (and notify-osd / message-indicator cross tests)
> 2) LDTP broke the API in version 1.6, and the imagacapture signature is different. Added a method to keep backwards compatibility.
>

=== modified file '.bzrignore'
--- .bzrignore	2009-04-01 14:08:43 +0000
+++ .bzrignore	2009-06-09 15:24:42 +0000
@@ -9,3 +9,4 @@
 debian/ubuntu-desktop-tests
 python-build-stamp-2.5
 pidgin/data/credentials.ini
+evolution/data/credentials.ini
 
=== added directory 'evolution'
=== added directory 'evolution/data'
=== added file 'evolution/data/credentials.ini.example'
--- evolution/data/credentials.ini.example	1970-01-01 00:00:00 +0000
+++ evolution/data/credentials.ini.example	2009-06-10 11:13:16 +0000
@@ -0,0 +1,11 @@
+# [TEST_POP]
+# popaccount  = thisisatest 
+# popserver   = pop.testserver.com
+# smtpaccount = thisisatest
+# smtpserver  = smtp.testserver.com
+# emailaddress = [e-mail]
+# accountname = testing
+# name = Tester Ubuntu
+# protocol = POP
+# password = thisisnotarealpassword
+
 
=== added directory 'evolution/data/evolution'
=== added directory 'evolution/data/evolution/mail'
=== added file 'evolution/data/evolution/mail/%gconf.xml'
--- evolution/data/evolution/mail/%gconf.xml	1970-01-01 00:00:00 +0000
+++ evolution/data/evolution/mail/%gconf.xml	2009-06-09 15:24:42 +0000
@@ -0,0 +1,23 @@
+<?xml version="1.0"?>
+<gconf>
+	<entry name="send_recv_maximized" mtime="1242653573" type="bool" value="false"/>
+	<entry name="send_recv_height" mtime="1242653573" type="int" value="200"/>
+	<entry name="send_recv_width" mtime="1242653573" type="int" value="600"/>
+	<entry name="default_account" mtime="1242371807" type="string">
+		<stringvalue>1242371745.7630.0@sushirider</stringvalue>
+	</entry>
+	<entry name="signatures" mtime="1242310233" type="list" ltype="string">
+		<li type="string">
+			<stringvalue>&lt;?xml version=&quot;1.0&quot;?&gt;
+&lt;signature name=&quot;Autogenerated&quot; uid=&quot;1242310233.29141.18@sushirider&quot; auto=&quot;true&quot; format=&quot;text/html&quot;/&gt;
+</stringvalue>
+		</li>
+	</entry>
+	<entry name="accounts" mtime="1244203896" type="list" ltype="string">
+		<li type="string">
+            <stringvalue>&lt;?xml version=&quot;1.0&quot;?&gt;
+                &lt;account name=&quot;{accountname}&quot; uid=&quot;1242371745.7630.0@sushirider&quot; enabled=&quot;true&quot;&gt;&lt;identity&gt;&lt;name&gt;{name}&lt;/name&gt;&lt;addr-spec&gt;{emailaddress}&lt;/addr-spec&gt;&lt;signature uid=&quot;&quot;/&gt;&lt;/identity&gt;&lt;source save-passwd=&quot;true&quot; keep-on-server=&quot;false&quot; auto-check=&quot;false&quot; auto-check-timeout=&quot;10&quot;&gt;&lt;url&gt;pop://{popaccount}@{popserver}/;use_ssl=always&lt;/url&gt;&lt;/source&gt;&lt;transport save-passwd=&quot;true&quot;&gt;&lt;url&gt;smtp://{smtpaccount};auth=PLAIN@{smtpserver}/;use_ssl=when-possible&lt;/url&gt;&lt;/transport&gt;&lt;drafts-folder&gt;&lt;/drafts-folder&gt;&lt;sent-folder&gt;&lt;/sent-folder&gt;&lt;auto-cc always=&quot;false&quot;&gt;&lt;recipients&gt;&lt;/recipients&gt;&lt;/auto-cc&gt;&lt;auto-bcc always=&quot;false&quot;&gt;&lt;recipients&gt;&lt;/recipients&gt;&lt;/auto-bcc&gt;&lt;receipt-policy policy=&quot;never&quot;/&gt;&lt;pgp encrypt-to-self=&quot;false&quot; always-trust=&quot;false&quot; always-sign=&quot;false&quot; no-imip-sign=&quot;false&quot;/&gt;&lt;smime sign-default=&quot;false&quot; encrypt-default=&quot;false&quot; encrypt-to-self=&quot;false&quot;/&gt;&lt;/account&gt;
+        </stringvalue>
+		</li>
+	</entry>
+</gconf>
 
=== added file 'evolution/evolution_indicator.py'
--- evolution/evolution_indicator.py	1970-01-01 00:00:00 +0000
+++ evolution/evolution_indicator.py	2009-06-16 08:10:06 +0000
@@ -0,0 +1,59 @@
+from mago.test_suite.evolution import EvolutionTestSuite
+from mago.application.evolution import Evolution, AccountInfo
+from mago.check import ScreenshotCompare, FAIL
+from mago.application.deskex import IndicatorApplet 
+
+from ConfigParser import ConfigParser
+import ldtp, ooldtp, ldtputils
+from time import sleep, time
+from shutil import copytree, move
+from os.path import expanduser
+
+class EvolutionUseApp(Evolution):
+    def open(self, profile_template='', credentials='',
+             me_account=''):
+        self.me_account = AccountInfo(me_account, credentials)
+
+        self.backup_config()
+        self.generate_profile(profile_template, self.me_account.template_args)
+
+        Evolution.open(self, False, credentials)
+
+class EvolutionIndicatorTest(EvolutionTestSuite):
+    APPLICATION_FACTORY = EvolutionUseApp
+    def cleanup(self):
+        return
+
+    def testIndicatorShowsUp(self):
+        indicator = IndicatorApplet()
+        if not indicator.is_indicator_shown("Evolution Mail"):
+            raise AssertionError("The indicator didn't show up", ldtputils.imagecapture())
+
+    def testIndicateMyself(self, subject, body, password=''):
+
+        indicator = IndicatorApplet()
+        no_message = indicator.capture_applet_icon()
+        email = self.application.me_account.template_args['emailaddress']
+        password = self.application.me_account.template_args['password']
+
+        self.application.compose_new_message(email, subject, body)
+        self.application.send_email(subject)
+
+        # Force sending the email
+        ldtp.wait(5)
+
+        # Get new messages
+        self.application.send_and_receive(password, True, True)
+
+        # Check that the applet icon changed
+        with_message = indicator.capture_applet_icon()
+
+        checker = ScreenshotCompare(no_message, with_message)
+        
+        if checker.perform_test() != FAIL:
+            raise AssertionError('icon did not change.', ldtputils.imagecapture())
+
+
+
+
+  
 
=== added file 'evolution/evolution_indicator.xml'
--- evolution/evolution_indicator.xml	1970-01-01 00:00:00 +0000
+++ evolution/evolution_indicator.xml	2009-06-16 08:10:06 +0000
@@ -0,0 +1,24 @@
+<?xml version="1.0"?>
+<suite name="evolution indicator">
+  <class>evolution_indicator.EvolutionIndicatorTest</class>
+  <description>
+    Basic Email messaging and m-i
+  </description>
+  <args>
+    <profile_template>./evolution/data/evolution/mail/</profile_template>
+    <credentials>./evolution/data/credentials.ini</credentials>
+    <me_account>TEST_POP</me_account>
+  </args>
+  <case name="IndicatorShowsTest">
+    <method>testIndicatorShowsUp</method>
+    <description>Basic checking for applet</description>
+  </case>
+  <case name="BasicSendAndIndicationTest">
+    <method>testIndicateMyself</method>
+    <description>Send a test to myself and check for indicator-applet to change</description>
+    <args>
+      <subject>Hello World!</subject>
+      <body>This is the first test of my life.</body>
+    </args>
+  </case>
+</suite>
 
=== added file 'evolution/evolution_messaging.py'
--- evolution/evolution_messaging.py	1970-01-01 00:00:00 +0000
+++ evolution/evolution_messaging.py	2009-06-15 10:58:35 +0000
@@ -0,0 +1,53 @@
+from mago.test_suite.evolution import EvolutionTestSuite
+from mago.application.evolution import Evolution, AccountInfo
+from ConfigParser import ConfigParser
+import ldtp, ooldtp, ldtputils
+from time import sleep, time
+from shutil import copytree, move
+from os.path import expanduser
+
+class EvolutionUseApp(Evolution):
+    def open(self, profile_template='', credentials='',
+             me_account=''):
+        self.me_account = AccountInfo(me_account, credentials)
+
+        self.backup_config()
+        self.generate_profile(profile_template, self.me_account.template_args)
+
+        Evolution.open(self, False, credentials)
+
+class EvolutionUseTest(EvolutionTestSuite):
+    APPLICATION_FACTORY = EvolutionUseApp
+    def cleanup(self):
+        return
+
+    def testSendMessageToMyself(self, subject, body, password=''):
+
+        email = self.application.me_account.template_args['emailaddress']
+        password = self.application.me_account.template_args['password']
+
+        self.application.compose_new_message(email, subject, body)
+        self.application.send_email(subject)
+        # Wait for the message to be sent
+        # TODO: Change to look for the Outbox(1) label.
+        ldtp.wait(10)
+
+        # Get new messages
+        self.application.send_and_receive(password)
+        
+        # Get the list of messages and check if it was correctly received
+        messages_list = self.application.get_list_messages()
+
+        found = False
+        for msg in messages_list:
+            if str(msg['subject']) == str(subject):
+                found = True
+                break
+
+        if not found:
+            raise AssertionError("The message was not correctly received.", 
+                    ldtputils.imagecapture())
+
+
+
+  
 
=== added file 'evolution/evolution_messaging.xml'
--- evolution/evolution_messaging.xml	1970-01-01 00:00:00 +0000
+++ evolution/evolution_messaging.xml	2009-06-09 15:24:42 +0000
@@ -0,0 +1,20 @@
+<?xml version="1.0"?>
+<suite name="pidgin messaging">
+  <class>evolution_messaging.EvolutionUseTest</class>
+  <description>
+    Basic Email messaging.
+  </description>
+  <args>
+      <profile_template>./evolution/data/evolution/mail/</profile_template>
+    <credentials>./evolution/data/credentials.ini</credentials>
+    <me_account>TEST_POP</me_account>
+  </args>
+  <case name="BasicSendTest">
+    <method>testSendMessageToMyself</method>
+    <description>Basic send test</description>
+    <args>
+      <subject>Hello World!</subject>
+      <body>This is the first test of my life.</body>
+    </args>
+  </case>
+</suite>
 
=== added file 'evolution/evolution_notify.py'
--- evolution/evolution_notify.py	1970-01-01 00:00:00 +0000
+++ evolution/evolution_notify.py	2009-06-15 10:58:35 +0000
@@ -0,0 +1,74 @@
+from mago.test_suite.evolution import EvolutionTestSuite
+from mago.application.evolution import Evolution, AccountInfo
+from mago.check import ScreenshotCompare, FAIL
+from mago.application.deskex import NotifyOSD
+
+from ConfigParser import ConfigParser
+import ldtp, ooldtp, ldtputils
+from time import sleep, time
+from shutil import copytree, move
+from os.path import expanduser
+
+class EvolutionUseApp(Evolution):
+    def open(self, profile_template='', credentials='',
+             me_account=''):
+        self.me_account = AccountInfo(me_account, credentials)
+
+        self.backup_config()
+        self.generate_profile(profile_template, self.me_account.template_args)
+
+        Evolution.open(self, False, credentials)
+
+class EvolutionNotifyTest(EvolutionTestSuite):
+    APPLICATION_FACTORY = EvolutionUseApp
+    def cleanup(self):
+        return
+
+    def testNotifyMyself(self, subject, body, oracle, password=''):
+
+        notify = NotifyOSD()
+        email = self.application.me_account.template_args['emailaddress']
+        password = self.application.me_account.template_args['password']
+
+        self.application.compose_new_message(email, subject, body)
+        self.application.send_email(subject)
+
+        # Force sending the email
+        ldtp.wait(5)
+
+        # Get new messages
+        self.application.send_and_receive(password, True, True)
+
+        # Wait for notification (TODO)
+        elapsed, screeny = notify.grab_image_and_wait("1 New Message", 40)
+
+        checker = ScreenshotCompare(oracle, screeny)
+
+        try:
+            passed = checker.perform_test()
+        except Exception, e:
+            checker.calibrate()
+            raise e
+
+        if passed == FAIL:
+            raise AssertionError('screenshots differ', screeny)
+
+       
+        # Get the list of messages and check if it was correctly received
+        messages_list = self.application.get_list_messages()
+
+        found = False
+        for msg in messages_list:
+            if str(msg['subject']) == str(subject):
+                found = True
+                break
+
+        if not found:
+            raise AssertionError("The message was not correctly received.", 
+                    ldtputils.imagecapture())
+
+
+
+
+
+  
 
=== added file 'evolution/evolution_notify.xml'
--- evolution/evolution_notify.xml	1970-01-01 00:00:00 +0000
+++ evolution/evolution_notify.xml	2009-06-12 11:56:53 +0000
@@ -0,0 +1,21 @@
+<?xml version="1.0"?>
+<suite name="pidgin messaging">
+  <class>evolution_notify.EvolutionNotifyTest</class>
+  <description>
+    Basic Email messaging and notifications.
+  </description>
+  <args>
+      <profile_template>./evolution/data/evolution/mail/</profile_template>
+    <credentials>./evolution/data/credentials.ini</credentials>
+    <me_account>TEST_POP</me_account>
+  </args>
+  <case name="BasicSendTest">
+    <method>testNotifyMyself</method>
+    <description>Basic send test and notification</description>
+    <args>
+      <oracle>./evolution/data/one_new_message.png</oracle>
+      <subject>Hello World!</subject>
+      <body>This is the first test of my life.</body>
+    </args>
+  </case>
+</suite>
 
=== modified file 'indicator-applet/indicator_applet.py'
--- indicator-applet/indicator_applet.py	2009-06-23 13:26:34 +0000
+++ indicator-applet/indicator_applet.py	2009-07-27 11:06:25 +0000
@@ -19,8 +19,7 @@
         self.application.add_server(os.path.abspath(desktop_file))
         self.application.show_indicator(sender)
         sleep(1)
-        if not ldtp.objectexist(self.application.TOP_PANEL, 
-                                'mnu' + sender.replace(' ','')):
+        if not self.application.is_indicator_shown(sender)
             raise AssertionError('indicator did not appear in applet.')
 
     def iconChangeTest(self, desktop_file=None, sender=None):
 
=== modified file 'mago/application/__init__.py'
--- mago/application/__init__.py	2009-05-26 16:20:12 +0000
+++ mago/application/__init__.py	2009-06-15 10:58:35 +0000
@@ -3,4 +3,4 @@
 
 Classes that wrap application functionality to ease their testing
 """
-__all__ = ['main', 'gnome', 'ubuntu', 'pidgin']
+__all__ = ['main', 'gnome', 'ubuntu', 'pidgin', 'evolution']
 
=== modified file 'mago/application/deskex.py'
--- mago/application/deskex.py	2009-07-21 18:20:22 +0000
+++ mago/application/deskex.py	2009-07-27 11:06:25 +0000
@@ -1,11 +1,12 @@
 from .main import Application
-from ..utils import show_desktop
+from ..utils import show_desktop, get_ldtp_version
 from time import time, sleep
 import tempfile
 import pynotify
 import ldtp, ldtputils
 import os
 import gtk, glib
+from distutils import version
 
 try:
     import indicate
@@ -54,14 +55,29 @@
 
     def capture_applet_icon(self):
         x, y, w, h = ldtp.getobjectsize(self.TOP_PANEL, self.IA_TOPLEVEL)
-        screeny = ldtputils.imagecapture(
-            outFile=tempfile.mktemp('.png', 'ia_'),
-            x=x, y=y, resolution1=w, resolution2=h)        
+        
+        ldtp_one_six = version.StrictVersion('1.6.0')
+        ldtp_current = version.StrictVersion(get_ldtp_version())
+
+        if ldtp_current < ldtp_one_six:
+            screeny = ldtputils.imagecapture(
+                outFile=tempfile.mktemp('.png', 'ia_'),
+                x=x, y=y, resolution1=w, resolution2=h)        
+        else:
+            screeny = ldtputils.imagecapture(
+                outFile=tempfile.mktemp('.png', 'ia_'),
+                x=x, y=y, width=w, height=h)        
+
         return screeny
 
     def select_indicator(self, sender):
         ldtp.selectmenuitem(self.TOP_PANEL, 'mnu' + sender.replace(' ',''))
 
+    def is_indicator_shown(self, sender):
+        return ldtp.objectexist(self.TOP_PANEL, 
+                                'mnu' + sender.replace(' ',''))
+
+
     def wait_for_indicator_display(self, sender, timeout=5):
         handlers = []
         displayed = [False]
@@ -157,16 +173,28 @@
         n.set_hint("value", value)
 	n.show ()
 
-    def grab_image_and_wait(self, summary):
-        ldtp.waittillguiexist(summary)
+    def grab_image_and_wait(self, summary, timeOut=30):
+        ldtp.waittillguiexist(summary, guiTimeOut=timeOut)
         start_time = time()
         sleep(1)
         x, y, w, h = ldtp.getwindowsize(summary)
-        screenshot = \
-            ldtputils.imagecapture(outFile=tempfile.mktemp('.png', 'nosd_'),
+
+        ldtp_one_six = version.StrictVersion('1.6.0')
+        ldtp_current = version.StrictVersion(get_ldtp_version())
+
+        if ldtp_current < ldtp_one_six:
+            screenshot = \
+                ldtputils.imagecapture(outFile=tempfile.mktemp('.png', 'nosd_'),
                                    x=x+3, y=y+3, 
                                    resolution1=w-6, 
                                    resolution2=h-6)
+        else:
+            screenshot = \
+                ldtputils.imagecapture(outFile=tempfile.mktemp('.png', 'nosd_'),
+                                   x=x+3, y=y+3, 
+                                   width=w-6, 
+                                   height=h-6)
+        
         ldtp.waittillguinotexist(summary)
         end_time = time() - start_time
         self.screenshots.append(screenshot)
 
=== added file 'mago/application/evolution.py'
--- mago/application/evolution.py	1970-01-01 00:00:00 +0000
+++ mago/application/evolution.py	2009-07-27 11:46:59 +0000
@@ -0,0 +1,255 @@
+from main import Application
+from ..utils import show_desktop 
+import ldtp, ldtputils, ooldtp
+import os
+import gtk, glib
+import tarfile
+from shutil import move, rmtree, copytree
+from ConfigParser import ConfigParser
+from string import Formatter
+
+class AccountInfo(object):
+
+    def __init__(self, name, credentials):
+        if not isinstance(credentials, ConfigParser):
+            creds_fn = credentials
+            credentials = ConfigParser()
+            credentials.read(creds_fn)
+        self.details = dict(credentials.items(name))
+        self.name = name
+
+    def __getattr__(self, name):
+        try:
+            return self.details[name]
+        except KeyError:
+            raise AttributeError
+
+    @property
+    def template_args(self):
+        args = {}
+        for arg in ('popaccount', 'popserver', 'smtpaccount', 'smtpserver', 
+                    'emailaddress', 'accountname', 'name', 'protocol', 'password'):
+            args[arg] = getattr(self, arg)
+        return args
+
+class Evolution(Application):
+    """
+    Evolution application helper class.
+    """
+    WINDOW         = "*-Evolution"
+    LAUNCHER       = "evolution"
+    BTN_OK         = "OK"
+
+    # Main window elements
+    BTN_SENDRECEIVE = "btnSend/Receive"
+    DLG_SENDRECEIVE = "dlgSend&ReceiveMail"
+    DLG_ENTER_PASSWORD = "dlgEnterPasswordfor*" 
+    TBL_MSG_FOLDERS = 'ttblMailFolderTree'
+
+    # Compose message constants
+    MNU_COMPOSENEW = "mnuComposeNewMessage"
+    FRM_COMPOSE    = "frmComposeMessage"
+    TXT_TO         = "txtTo"
+    TXT_SUBJECT    = "txtSubject"
+    TXT_BODY       = "txt6"
+    BTN_SEND       = "btnSend"
+
+    # Messages treetable
+    MESSAGES       = "ttblMessages"
+    STATUS_LBL     = "Status"
+    STATUS_INDEX   = 0
+    ATTACH_LBL     = "Attachment"
+    ATTACH_INDEX   = 1
+    FLAGGED_LBL    = "Flagged"
+    FLAGGED_INDEX  = 2
+    FROM_LBL       = "From"
+    FROM_INDEX     = 3
+    SUBJECT_LBL    = "Subject"
+    SUBJECT_INDEX  = 4
+    DATE_LBL       = "Date"
+    DATE_INDEX     = 5
+
+    def __init__(self):
+        Application.__init__(self)
+
+    def open(self, clean_profile=True, credentials=''):
+        """
+        It saves the old profile (if needed) and
+        set up a new one. After this initial process,
+        it opens the application
+
+        @type clean_profile: boolean
+        @param clean_profile: True, to back up the old profile and create a 
+            new one (default)
+        @type credentials: string
+        @param credentials: Path to the config file with accounts information
+        """
+        clean_profile = clean_profile not in ('False', '0', False)
+        self.creds_fn = credentials
+        self.credentials = ConfigParser()
+        self.credentials.read(self.creds_fn)
+
+        if clean_profile:
+            self.backup_config()
+
+        Application.open(self)
+
+    def generate_profile(self, profile_template, template_args=None):
+        """
+        It uses the profile_template and the
+        credentials to build a new profile folder
+        """
+
+        conf_folder = '~/.gconf/apps/evolution/mail'
+        os.makedirs(os.path.expanduser(conf_folder))
+
+        formatter = Formatter()
+        for fn in os.listdir(profile_template):
+            if os.path.isdir(os.path.join(profile_template, fn)):
+                copytree(os.path.join(profile_template, fn),
+                         os.path.join(os.path.expanduser(conf_folder), fn))
+                continue
+            buf = open(os.path.join(profile_template, fn)).read()
+            f = open(os.path.join(os.path.expanduser(conf_folder), fn), 'w')
+            try:
+                buf = formatter.format(buf, **template_args)
+            except KeyError, e:
+                raise Exception, e
+            f.write(buf)
+            f.close()
+
+    def compose_new_message(self, to, subject='', body='', account=''):
+       
+        evolution = ooldtp.context(self.WINDOW)
+        mnuComposeNew = evolution.getchild(self.MNU_COMPOSENEW)
+        mnuComposeNew.click()
+        ldtp.waittillguiexist(self.FRM_COMPOSE)
+        compose_window = ooldtp.context(self.FRM_COMPOSE)
+        txtTo = compose_window.getchild(self.TXT_TO)
+        txtTo.settextvalue(to)
+        txtSubject = compose_window.getchild(self.TXT_SUBJECT)
+        txtSubject.settextvalue(subject)
+       
+        # Remap is needed because the frame changes its name
+        self.remap() 
+        
+        compose_window = ooldtp.context(subject)
+
+        txtBody = compose_window.getchild(self.TXT_BODY)
+        txtBody.settextvalue(body)
+   
+    def send_email(self, subject):
+
+        compose_window = ooldtp.context(subject)
+        btnSend = compose_window.getchild(self.BTN_SEND)
+        btnSend.click()
+
+    def send_and_receive(self, password='', minimize=False, dont_wait=False):
+        evolution = ooldtp.context(self.WINDOW)
+        btnsr = evolution.getchild(self.BTN_SENDRECEIVE)
+        btnsr.click()
+        ldtp.waittillguiexist(self.DLG_SENDRECEIVE)
+
+        if minimize:
+            show_desktop(True)
+
+        if ldtp.waittillguiexist(self.DLG_ENTER_PASSWORD, guiTimeOut=2) == 1:
+            enter_pass_dlg = ooldtp.context(self.DLG_ENTER_PASSWORD)
+            txt_pass = enter_pass_dlg.getchild(role='password_text')[0]
+            txt_pass.settextvalue(password)
+            btn_ok = enter_pass_dlg.getchild(self.BTN_OK)
+            btn_ok.click()
+            if minimize:
+                show_desktop(True)
+
+        if dont_wait:
+            return
+
+        ldtp.waittillguinotexist(self.DLG_SENDRECEIVE)
+
+     
+    def get_list_messages(self, only_unread=False, folder="Inbox"):
+
+        messages_list = []
+        
+        self.select_folder(folder)
+
+        evolution = ooldtp.context(self.WINDOW)
+        messages = evolution.getchild(self.MESSAGES)
+
+        for i in range(messages.getrowcount()):
+            status  = messages.getcellvalue(i, self.STATUS_INDEX)
+            sender  = messages.getcellvalue(i, self.FROM_INDEX)
+            subject = messages.getcellvalue(i, self.SUBJECT_INDEX)
+
+            if not only_unread or status == '0':
+                messages_list.append({'subject':subject,'sender':sender,'status':status})
+
+        return messages_list
+
+    def select_folder(self, folder):
+        evolution = ooldtp.context(self.WINDOW)
+        table_msg = evolution.getchild(self.TBL_MSG_FOLDERS)
+        table_msg.selectrowpartialmatch(folder)
+
+    def backup_config(self):
+        """
+        It saves the configuration of Evolution in a file
+        called ~/.evo.bak.tar.gz{.n}
+
+        It saves the evolution config & messages
+        """
+        p = os.path.expanduser('~/.evo.bak.tar.gz')
+        backup_path = p
+        i = 2
+        while os.path.exists(backup_path):
+            backup_path = '%s.%d' % (p, i)
+            i += 1
+            
+        try:
+            tar = tarfile.open(backup_path, mode='w:gz')
+            evolution_conf = os.path.expanduser('~/.evolution')
+            evolution_gconf = os.path.expanduser('~/.gconf/apps/evolution')
+
+            if os.path.exists(evolution_conf):
+                tar.add(evolution_conf)
+                rmtree(evolution_conf)
+            if os.path.exists(evolution_gconf):
+                tar.add(evolution_gconf)
+                rmtree(evolution_gconf)
+            tar.close()
+        except IOError:
+            pass
+        else:
+            self.backup_path = backup_path
+
+    def restore_config(self):
+        """
+        It deletes the configuration folder and restore then
+        one backed up (at backup_path)
+        """
+        try:
+            rmtree(os.path.expanduser('~/.evolution'))
+            rmtree(os.path.expanduser('~/.gconf/apps/evolution'))
+        except OSError:
+            pass
+
+        try:
+            tar = tarfile.open(self.backup_path, mode='r:gz')
+            tar.extractall(os.path.expanduser('/.'))
+        except IOError:
+            traceback.print_exc()
+
+
+    
+if __name__ == "__main__":
+    from time import sleep
+    test = Evolution()
+    #test.open()
+    #subject = "Greetings"
+    #test.compose_new_message("[e-mail]", subject, "hey hey")
+    #test.send_email(subject)
+    #test.send_and_receive('testingubuntu')
+    test.backup_config()
+    test.restore_config()
+   # test.close()
 
=== modified file 'mago/test_suite/__init__.py'
--- mago/test_suite/__init__.py	2009-05-26 16:20:12 +0000
+++ mago/test_suite/__init__.py	2009-06-15 10:58:35 +0000
@@ -3,4 +3,4 @@
 
 Test suite classes that implement setup/teardown/cleanup methods
 """
-__all__ = ['main', 'gnome', 'ubuntu', 'pidgin']
+__all__ = ['main', 'gnome', 'ubuntu', 'pidgin', 'evolution']
 
=== added file 'mago/test_suite/evolution.py'
--- mago/test_suite/evolution.py	1970-01-01 00:00:00 +0000
+++ mago/test_suite/evolution.py	2009-06-09 15:24:42 +0000
@@ -0,0 +1,28 @@
+"""
+gnome module contains the definition of the test suites used for gnome
+applications
+"""
+import ldtp, ooldtp
+from .main import SingleApplicationTestSuite
+from ..application.gnome import Application
+from ..application.evolution import Evolution 
+
+class EvolutionTestSuite(SingleApplicationTestSuite):
+    """
+    Default test suite for Evolution 
+    """
+    APPLICATION_FACTORY = Evolution 
+    def __init__(self, **kwargs):
+        self.app_args = kwargs
+        SingleApplicationTestSuite.__init__(self)
+
+    def setup(self):
+        self.application.open(**self.app_args)
+
+    def teardown(self):
+        self.application.close()
+
+    def cleanup(self):
+        self.application.close()
+        self.application.open(**self.app_args)
+
 
=== modified file 'mago/utils.py'
--- mago/utils.py	2009-06-29 18:46:40 +0000
+++ mago/utils.py	2009-07-27 11:06:25 +0000
@@ -1,5 +1,7 @@
 import os
 import gtk, gobject, wnck
+import subprocess
+import re
 
 def show_desktop(show):
     def _start_showing():
@@ -12,3 +14,13 @@
 
 def get_system_language():
     raise NotImplementedError, "not yet..."
+
+def get_ldtp_version():
+    script = subprocess.Popen(['ldtp', '--version'], stdout=subprocess.PIPE)
+    version =  script.communicate()[0]
+    pattern = re.compile("ldtp-(\d\.\d\.\d).*")
+    m = pattern.match(version)
+    version = m.group(1)
+    return version
+
+