Merge lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms into lp:ubuntu-system-tests

[Brendan Donegan]

Test and framework for receiving an SMS

Add the sanity test for receiving an SMS and the supporting helpers

Note that the phone number cannot be queried from the SIM in all circumstances so we have to have it as a config option.

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:99
No commit message was specified in the merge proposal. Click on the following link and set the commit message (if you want a jenkins rebuild you need to trigger it yourself):
https://code.launchpad.net/~canonical-platform-qa/ubuntu-system-tests/test_receive_sms/+merge/260545/+edit-commit-message

http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/263/
Executed test runs:
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/34/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/34/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/34/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/263/rebuild

review: Needs Fixing (continuous-integration)

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:99
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/264/
Executed test runs:
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/35/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/35/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/35/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/264/rebuild

review: Needs Fixing (continuous-integration)

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

100. By Brendan Donegan on 2015-05-29

Notifications helpers

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:100
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/265/
Executed test runs:
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/36/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/36/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/36/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/265/rebuild

review: Needs Fixing (continuous-integration)

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

101. By Brendan Donegan on 2015-05-29

Remove TODO comment

102. By Brendan Donegan on 2015-05-29

Update to/from_number config help text

103. By Brendan Donegan on 2015-05-29

Update README with info on getting telephony service access

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:101
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/266/
Executed test runs:
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/37/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/37/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/37/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/266/rebuild

review: Needs Fixing (continuous-integration)

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:103
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/267/
Executed test runs:
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/38/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/38/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/38/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/267/rebuild

review: Needs Fixing (continuous-integration)

[Richard Huddie (rhuddie)]

This is looking good. I managed to get it working after a few problems (see comments below).

Also, some flake8 errors:
./ubuntu_system_tests/helpers/telephony.py:42:50: F821 undefined name 'message'
./ubuntu_system_tests/helpers/telephony.py:92:5: E303 too many blank lines (2)
./ubuntu_system_tests/helpers/telephony.py:107:9: F841 local variable 'response' is assigned to but never used
./ubuntu_system_tests/helpers/telephony.py:108:1: W293 blank line contains whitespace
./ubuntu_system_tests/helpers/telephony.py:120:9: F841 local variable 'url' is assigned to but never used
./ubuntu_system_tests/helpers/telephony.py:124:9: F841 local variable 'url' is assigned to but never used
./ubuntu_system_tests/helpers/unity8/notifications.py:23:1: E302 expected 2 blank lines, found 1
./ubuntu_system_tests/helpers/unity8/notifications.py:30:1: E302 expected 2 blank lines, found 1
./ubuntu_system_tests/helpers/unity8/notifications.py:36:1: W391 blank line at end of file

review: Needs Fixing

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

104. By Brendan Donegan on 2015-05-29

Fix flake8 issues in telephony helpers

105. By Brendan Donegan on 2015-05-29

Rename to_number to device_phone_number and from_number to telephony_service_number

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:105
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/268/
Executed test runs:
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/39/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/39/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/39/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/268/rebuild

review: Needs Fixing (continuous-integration)

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

106. By Brendan Donegan on 2015-05-29

Remove stray print statement

107. By Brendan Donegan on 2015-05-29

Added last bits of test and addressed last comments

[Brendan Donegan (brendan-donegan)]

Made a lot of updates, let's see what the Jenkins job comes back with.

[Brendan Donegan (brendan-donegan)]

Response to diff comments

[Brendan Donegan (brendan-donegan)]

Btw there is some new code at the end of the test to pay attention to, particularly to delete the message - maybe that should be done in a different way, not using the UI?

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:107
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/269/
Executed test runs:
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/40
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/40
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/40

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/269/rebuild

review: Approve (continuous-integration)

[Sergio Cazzolato (sergio-j-cazzolato)]

2 comments inline

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

108. By Brendan Donegan on 2015-05-30

Comment up the test code

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:108
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/273/
Executed test runs:
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/44
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/44
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/44

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/273/rebuild

review: Approve (continuous-integration)

[Brendan Donegan (brendan-donegan)]

Spoke to renato - since the dbus API is essentially private it could potentially change and break at any time - however the only public and supported way is using the C++ API. Writing bindings is laborious and fraught with danger, so I'd prefer to stick with using the DBus API. I would point out that this code was initially written nearly a year ago and still works as is so it's not as unstable as it might sound initially.

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

109. By Brendan Donegan on 2015-06-03

Merged from trunk

110. By Brendan Donegan on 2015-06-03

Fix flake8 issue

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:110
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/296/
Executed test runs:
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/67
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/68
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/67

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/296/rebuild

review: Approve (continuous-integration)

[Sergio Cazzolato (sergio-j-cazzolato)]

review: Approve

[Brendan Donegan (brendan-donegan)]

Tested again to make sure it works, and it does. If no further objections, we can top-approve?

review: Approve

[Richard Huddie (rhuddie)]

This looks really good, I ran the test fine.
Just 1 comment below about skipping the test if no sim inserted.

review: Needs Fixing

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

111. By Brendan Donegan on 2015-06-04

Skip test_receive_sms if no SIM is inserted

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:111
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/299/
Executed test runs:
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/70/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/71/console
    FAILURE: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/70/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/299/rebuild

review: Needs Fixing (continuous-integration)

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

112. By Brendan Donegan on 2015-06-04

Merged from trunk

[Brendan Donegan (brendan-donegan)]

Skip added, tested both with and without SIM inserted, all works properly. Just wait for the Jenkins job to return clean and we can top-approve I guess

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:112
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/300/
Executed test runs:
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/71
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/72
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/71

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/300/rebuild

review: Approve (continuous-integration)

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

113. By Brendan Donegan on 2015-06-04

Revert removal of restart_unity

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:113
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/301/
Executed test runs:
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/72
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/73
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/72

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/301/rebuild

review: Approve (continuous-integration)

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

114. By Brendan Donegan on 2015-06-04

Remove _ensure_application_closed from test_messaging.py

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:114
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/302/
Executed test runs:
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/73
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/74
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/73

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/302/rebuild

review: Approve (continuous-integration)

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

115. By Brendan Donegan on 2015-06-04

typo in ensure_application_closed

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:115
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/303/
Executed test runs:
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/74
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/75
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/74

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/303/rebuild

review: Approve (continuous-integration)

[lp:~canonical-platform-qa/ubuntu-system-tests/test_receive_sms]

116. By Richard Huddie on 2015-06-04

Temporarily remove use of tap_on notification method to improve reliability.

[Richard Huddie (rhuddie)]

Re-tested on mako with the notification change to improve reliability. Works fine.

review: Approve

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:116
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/304/
Executed test runs:
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-amd64-ci/75
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-armhf-ci/76
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-wily-i386-ci/75

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sanity-tests-ci/304/rebuild

review: Approve (continuous-integration)

=== modified file 'README.rst'
--- README.rst	2015-05-27 20:21:41 +0000
+++ README.rst	2015-06-04 15:20:03 +0000
@@ -92,6 +92,13 @@
 To do this you need to be part of the platform-qa group on people.canonical.com
 and have shell access there.
 
+Set up telephony service access (currently Twilio)
+--------------------------------------------------
+
+To run tests that use telephony service you will need an account on Twilio.com. Please
+email [e-mail] and they will set up a sub-account with its own API
+credentials and an initial test number, as well as instructions on adding more.
+
 Copy data files to the testbed
 ------------------------------
 

=== modified file 'debian/tests/control'
--- debian/tests/control	2015-05-26 16:23:26 +0000
+++ debian/tests/control	2015-06-04 15:20:03 +0000
@@ -4,12 +4,14 @@
 Depends: address-book-app-autopilot (>=0.2+15.04.20150226-0ubuntu1),
          camera-app-autopilot,
          exiftool,
+         messaging-app-autopilot,
          oxideqt-chromedriver,
          python3-autopilot,
          python3-dbus,
          python3-debian,
          python3-gi,
          python3-testtools,
+         python3-requests,
          python3-selenium,
          subunit,
          ubuntu-keyboard-autopilot,

=== modified file 'ubuntu_system_tests/config.py'
--- ubuntu_system_tests/config.py	2015-05-27 15:55:44 +0000
+++ ubuntu_system_tests/config.py	2015-06-04 15:20:03 +0000
@@ -54,6 +54,20 @@
         'bluetooth_device_name',
         help_string='Name of a nearby bluetooth pairing device'),
     options.Option(
+        'device_phone_number',
+        help_string="The phone number of the device to which calls "
+                    "and messages should be directed. This must "
+                    "be formatted exactly as you would dial it "
+                    "normally."),
+    options.Option(
+        'telephony_service_number',
+        help_string="The phone number to call and message from "
+                    "in the telephony service. In Twilio go to "
+                    "https://www.twilio.com/user/account/"
+                    "phone-numbers/incoming and click on the number "
+                    "you want to use, then copy the 'Phone Number' "
+                    "field exactly."),
+    options.Option(
         # this is a private key, that will not be exported to
         # autopilot directly
         '_twilio_account_sid', default=options.MANDATORY,

=== added file 'ubuntu_system_tests/helpers/addressbook/dbus_service.py'
--- ubuntu_system_tests/helpers/addressbook/dbus_service.py	1970-01-01 00:00:00 +0000
+++ ubuntu_system_tests/helpers/addressbook/dbus_service.py	2015-06-04 15:20:03 +0000
@@ -0,0 +1,84 @@
+# -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
+
+#
+# Ubuntu System Tests
+# Copyright (C) 2015 Canonical
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3,
+# as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+import dbus
+import re
+
+
+DBUS_NAME_PIM = 'com.canonical.pim'
+DBUS_IFACE_ADDRESS_BOOK = 'com.canonical.pim.AddressBook'
+DBUS_IFACE_ADDRESS_BOOKVIEW = 'com.canonical.pim.AddressBookView'
+DBUS_OBJECT_ADDRESS_BOOK = '/com/canonical/pim/AddressBook'
+
+
+class ContactsDbusService:
+    def __init__(self):
+        self.bus = None
+        self.addr = None
+        self.addr_iface = None
+        self.bus = dbus.SessionBus()
+        self.addr = self.bus.get_object(
+            DBUS_NAME_PIM, DBUS_OBJECT_ADDRESS_BOOK)
+        self.addr_iface = dbus.Interface(
+            self.addr, dbus_interface=DBUS_IFACE_ADDRESS_BOOK)
+
+    def query_contacts(self, fields='', query='', sources=[]):
+        view_path = self.addr_iface.query(fields, query, [])
+        view = self.bus.get_object(
+            DBUS_NAME_PIM, view_path)
+        view_iface = dbus.Interface(
+            view, dbus_interface=DBUS_IFACE_ADDRESS_BOOKVIEW)
+        contacts = view_iface.contactsDetails([], 0, -1)
+        view.close()
+        return contacts
+
+    def update_contact(self, vcard):
+        return self.addr_iface.updateContacts([vcard])
+
+    def create_contact(self, vcard):
+        return self.addr_iface.createContact(vcard, "")
+
+    def delete_contact(self, ids):
+        return self.addr_iface.removeContacts(ids)
+
+    def get_vcard_uid(self, vcard):
+        """
+        Return the UID of the provided vcard
+        :param vcard: vcard formatted data
+        :return: uid value from vcard, else None
+        """
+        uid_pattern = re.compile(r'^UID:(?P<uid>\S*)\r?$',
+                                 re.MULTILINE | re.IGNORECASE)
+        uid = None
+        match = uid_pattern.search(vcard)
+        if match:
+            uid = match.group('uid')
+        return uid
+
+    def delete_all_contacts(self):
+        """
+        Delete all contacts using the dbus service
+        """
+        uids = []
+        contacts = self.query_contacts()
+        for contact in contacts:
+            uid = self.get_vcard_uid(contact)
+            if uid:
+                uids.append(uid)
+        self.delete_contact(uids)

=== added file 'ubuntu_system_tests/helpers/telephony.py'
--- ubuntu_system_tests/helpers/telephony.py	1970-01-01 00:00:00 +0000
+++ ubuntu_system_tests/helpers/telephony.py	2015-06-04 15:20:03 +0000
@@ -0,0 +1,197 @@
+# -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
+
+#
+# Ubuntu Sanity Tests
+# Copyright (C) 2015 Canonical
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+import functools
+import logging
+import requests
+
+from requests.auth import HTTPBasicAuth
+
+logger = logging.getLogger(__name__)
+
+TWILIO_API_URL = "https://api.twilio.com/2010-04-01"
+
+
+class Telephony:
+
+    def __init__(self, credentials, backend='twilio'):
+        self._backend = _get_backend(backend)(credentials)
+
+    def send_sms(self, to, from_, message):
+        return self._backend.send_sms(to, from_, message)
+
+    def get_sent_sms(self, to, from_, date):
+        return self._backend.get_sent_sms(to, from_, date)
+
+    def send_mms(self, to, from_, message, media):
+        return self._backend.send_mms(to, from_, message, media)
+
+    def make_phonecall(self, to, from_, hangup_timeout, voice_message):
+        return self._backend.make_phonecall(to, from_, hangup_timeout,
+                                            voice_message)
+
+
+NeedBackendError = functools.partial(
+    NotImplementedError,
+    "This class cannot be instantiated. Please use a specific backend."
+)
+
+
+class TelephonyBackend:
+
+    def __init__(self, credentials):
+        """
+        :param credentials: dictionary containing the required credential
+          details specific for the backend.
+
+        :raises ValueError: if any required credential details are missing.
+
+        """
+        raise NeedBackendError()
+
+    def send_sms(self, to, from_, message):
+        raise NeedBackendError()
+
+    def get_sent_sms(self, to, from_, date):
+        raise NeedBackendError()
+
+    def send_mms(self, to, from_, message, media):
+        raise NeedBackendError()
+
+    def make_phonecall(self, to, from_, hangup_timeout, voice_message):
+        # Only a suggestion, not sure specifics what are required.
+        raise NeedBackendError()
+
+
+class TwilioBackend(TelephonyBackend):
+    """Backend that utilises the Twilio service.
+
+    Required credentials are:
+      - AccountSid: This represents the account id
+      - AuthToken: This is the token used to authenticate the request against
+        the account (Note: It must be kept secret!).
+
+    """
+
+    def __init__(self, credentials):
+        _raise_if_required_credentials_missing(
+            credentials, 'AccountSid', 'AuthToken')
+        self._account_sid = credentials['AccountSid']
+        self._account_auth = credentials['AuthToken']
+        self._http_auth = HTTPBasicAuth(self._account_sid, self._account_auth)
+
+    def send_sms(self, to, from_, message):
+        # Ensure recipient number meets expectations
+        # (i.e. https://www.twilio.com/docs/api/rest/sending-messages#post 'To'
+        # field details.)
+        _raise_if_number_doesnt_look_valid(to)
+        _raise_if_number_doesnt_look_valid(from_)
+        url = self._get_api_url('Messages')
+        params = {'From': from_, 'To': to, 'Body': message}
+        response = requests.post(url, data=params, auth=self._http_auth)
+        if not response.ok:
+            logger.error(response.text)
+        return response.ok
+
+    def get_sent_sms(self, to, from_, time):
+        _raise_if_number_doesnt_look_valid(to)
+        _raise_if_number_doesnt_look_valid(from_)
+        url = self.get_api_url('Messages')
+        params = {'From': from_, 'To': to, 'DateSent': str(time.date)}
+        response = requests.get(url, data=params, auth=self._http_auth)
+        for message in response.json()['messages']:
+            print(message)
+
+    def send_mms(self, number, message, media):
+        _raise_if_number_doesnt_look_valid(number)
+        url = self._get_api_url('Messages')  # NOQA
+
+    def make_phonecall(self, number, hangup_timeout, voice_message):
+        _raise_if_number_doesnt_look_valid(number)
+        url = self._get_api_url('Calls')  # NOQA
+
+    def _get_api_url(self, action):
+        """Return API URL to post to."""
+        api_url = TWILIO_API_URL + '/Accounts/{sid}/{action}.json'.format(
+            sid=self._account_sid,
+            action=action
+        )
+        return api_url
+
+
+class FakeBackend(TelephonyBackend):
+    """A verified fake for use with testing.
+
+    Does not make any calls to external resources nor does it intiate any
+    actual calls/messages.
+
+    """
+    pass
+
+
+def _make_rest_request(url, params, auth_details):
+    """Return request object containing the results of the REST request."""
+    # i.e. r = requests.post(....)
+    # return r or should we check the status code here and raise an exception
+    # if it's not what's expected (could be another arg.)
+    pass
+
+
+def _get_backend(backend):
+    """Return the requested backend class
+
+    :raises ValueError: if the requested backend was not found.
+
+    """
+    # i.e. return TwiloBackend (well, smarter than that)
+    # The register (or whatever) could be a lot nicer too.
+
+    backend_register = dict(
+        twilio=TwilioBackend,
+        fake=FakeBackend,
+    )
+    return backend_register[backend]
+
+
+def _raise_if_number_doesnt_look_valid(number):
+    """Ensure number looks valid (i.e. E.164 format).
+
+    Does not ensure the number is in service etc.
+    """
+    pass
+
+
+def _raise_if_required_credentials_missing(credentials, *required_keys):
+    """Raise ValueError if any required keys are absent from credentials.
+
+    The exception string will include a description of which keys are missing.
+
+    """
+    missing_keys = []
+    for key in required_keys:
+        if credentials.get(key, None) is None:
+            missing_keys.append(key)
+
+    if missing_keys:
+        raise ValueError(
+            "Missing required credential detail{plural}: '{details}'".format(
+                plural='s' if len(missing_keys) > 1 else '',
+                details=', '.join(missing_keys))
+        )

=== added file 'ubuntu_system_tests/helpers/unity8/notifications.py'
--- ubuntu_system_tests/helpers/unity8/notifications.py	1970-01-01 00:00:00 +0000
+++ ubuntu_system_tests/helpers/unity8/notifications.py	2015-06-04 15:20:03 +0000
@@ -0,0 +1,41 @@
+# -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
+
+#
+# Ubuntu System Tests
+# Copyright (C) 2015 Canonical
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3,
+# as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+
+import ubuntuuitoolkit
+
+from ubuntu_system_tests.helpers.autopilot import override_proxy_timeout
+
+
+class Notifications(ubuntuuitoolkit.UbuntuUIToolkitCustomProxyObjectBase):
+
+    def get_current_notification(self):
+        with override_proxy_timeout(self, 60):
+            return self.wait_select_single(
+                'Notification',
+                objectName='notification1'
+            )
+
+
+class Notification(ubuntuuitoolkit.UbuntuUIToolkitCustomProxyObjectBase):
+
+    def tap_on(self):
+        self.pointing_device.click_object(
+            self.select_single(objectName="interactiveArea")
+        )

=== modified file 'ubuntu_system_tests/tests/base.py'
--- ubuntu_system_tests/tests/base.py	2015-06-03 17:04:45 +0000
+++ ubuntu_system_tests/tests/base.py	2015-06-04 15:20:03 +0000
@@ -32,6 +32,7 @@
 from unity8 import process_helpers
 from unity8.shell.emulators import dash
 
+from ubuntu_system_tests import config
 from ubuntu_system_tests.helpers import unity8
 from ubuntu_system_tests.helpers.unity8 import shell
 
@@ -88,3 +89,28 @@
     def ensure_application_closed(self, app_name):
         """Stop the app before unity8 is restarted so it's not orphaned."""
         subprocess.call(['ubuntu-app-stop', app_name])
+
+
+class BaseTelephonyTestCase(BaseUbuntuSystemTestCase):
+    """Base class to be used for all telephony tests."""
+
+    def setUp(self):
+        """Base class setUp method."""
+        super().setUp()
+        self.config_stack = config.get_device_config_stack()
+
+    def get_telephony_service_account_id(self):
+        """Return account id for telephony service."""
+        return self.config_stack.get('_twilio_account_sid')
+
+    def get_telephony_service_auth_token(self):
+        """Return auth token for telephony service."""
+        return self.config_stack.get('_twilio_auth_token')
+
+    def get_telephony_service_number(self):
+        """Return the number to call and message from."""
+        return self.config_stack.get('telephony_service_number')
+
+    def get_device_phone_number(self):
+        """Return the number to send messages and calls to."""
+        return self.config_stack.get('device_phone_number')

=== added file 'ubuntu_system_tests/tests/test_messaging.py'
--- ubuntu_system_tests/tests/test_messaging.py	1970-01-01 00:00:00 +0000
+++ ubuntu_system_tests/tests/test_messaging.py	2015-06-04 15:20:03 +0000
@@ -0,0 +1,129 @@
+# -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
+
+#
+# Ubuntu System Tests
+# Copyright (C) 2015 Canonical
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3,
+# as published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+import uuid
+
+from autopilot.matchers import Eventually
+from messaging_app import emulators as messaging_emulators
+from testtools import skipUnless
+from testtools.matchers import Equals
+from ubuntuuitoolkit import emulators as toolkit_emulators
+
+from ubuntu_system_tests.helpers.addressbook import dbus_service
+from ubuntu_system_tests.helpers import autopilot as autopilot_helpers
+from ubuntu_system_tests.helpers import ofono
+from ubuntu_system_tests.helpers.telephony import Telephony
+from ubuntu_system_tests.helpers.unity8 import notifications  # NOQA
+from ubuntu_system_tests.tests import base
+
+CONTACT_NAME = 'Fulano de Tal'
+
+
+class MessagingTestCase(base.BaseTelephonyTestCase):
+
+    @skipUnless(ofono.is_sim_inserted(ignore_phonesim=True), 'No SIM inserted')
+    def setUp(self):
+        super().setUp()
+        self.unity_proxy = self.launch_unity()
+        self.unity_proxy.unlock()
+
+    def _get_messaging_app_proxy(self):
+        """Return messaging app proxy object from existing process."""
+        return autopilot_helpers.get_proxy_object_for_existing_process(
+            'messaging-app',
+            toolkit_emulators.UbuntuUIToolkitEmulatorBase)
+
+    def _create_temporary_contact(self):
+        """
+        Create a contact in the address book using the dbus service
+        and remove it in the cleanup step.
+        """
+        vcard = """
+BEGIN:VCARD
+VERSION:3.0
+FN:{name}
+TEL;TYPE=CELL:{number}
+END:VCARD""".format(name=CONTACT_NAME,
+                    number=self.get_telephony_service_number())
+        self.addressbook_dbus = dbus_service.ContactsDbusService()
+        contact_vcard = self.addressbook_dbus.create_contact(vcard)
+        contact_uid = self.addressbook_dbus.get_vcard_uid(contact_vcard)
+        self.addCleanup(self.addressbook_dbus.delete_contact, [contact_uid])
+
+    def _get_notifications_list(self):
+        return self.unity_proxy.select_single(
+            'Notifications',
+            objectName='notificationList'
+        )
+
+    def test_receive_sms_from_contact(self):
+        """
+        Prerequisite: A contact in the address book with the number you
+        are sending from
+        1. From another device send an SMS to the phone number of a SIM
+           card that is in the SUT
+           - A notification appears containing the senders
+             name and the message content.
+        2. Tap on the message notification before it disappears
+           - The messaging application is opened showing all
+             messages received by that sender. The message
+             just sent should appear at the bottom.
+        """
+        self._create_temporary_contact()
+        # Get the notifications list first as we don't want to
+        # waste precious time waiting for this call to return
+        notifications_list = self._get_notifications_list()
+        credentials = {'AccountSid': self.get_telephony_service_account_id(),
+                       'AuthToken': self.get_telephony_service_auth_token()}
+        tel = Telephony(credentials)
+        # We use a UUID as the message body so that we know the message
+        # that is received is the same one we sent.
+        message_body = str(uuid.uuid1())
+        sent = tel.send_sms(self.get_device_phone_number(),
+                            self.get_telephony_service_number(),
+                            message_body)
+        self.assertTrue(sent, 'The SMS was not sent succesfully by the '
+                              'telephony service.')
+        # Tap on indicator when it appears and check the contents are
+        # correct - message body is displayed and contact name is shown
+        sms_notification = notifications_list.get_current_notification()
+        self.assertThat(sms_notification.summary,
+                        Eventually(Equals('Message from {contact}'.format(
+                                          contact='Fulano de Tal'))))
+        self.assertThat(sms_notification.body,
+                        Eventually(Equals(message_body)))
+        # Open the messaging app by tapping on the notification.
+        # Due to launchpad.net/bugs/1457629 the following tap_on() method can
+        # fail due to CPO inheritance problems in Autopilot.
+        # A workaround is to select and press the object directly in the test.
+        # This should be removed as soon as the Autopilot CPO bug is fixed.
+        # sms_notification.tap_on()
+        sms_notification.pointing_device.click_object(
+            sms_notification.select_single(objectName="interactiveArea"))
+
+        messaging_app = self._get_messaging_app_proxy()
+        self.addCleanup(self.ensure_application_closed, 'messaging-app')
+        main_view = messaging_app.select_single(messaging_emulators.MainView)
+        # Confirm that the message is displayed and the header title
+        # is the name of the contact
+        main_view.get_message(message_body)
+        self.assertThat(main_view.get_header().title,
+                        Eventually(Equals(CONTACT_NAME)))
+        # Delete the message
+        main_view.delete_message(message_body)