Rough removal of GrandCentral support
authorepage <eopage@byu.net>
Sat, 29 Aug 2009 00:05:42 +0000 (00:05 +0000)
committerepage <eopage@byu.net>
Sat, 29 Aug 2009 00:05:42 +0000 (00:05 +0000)
git-svn-id: file:///svnroot/gc-dialer/trunk@423 c39d3808-3fe2-4d86-a59f-b7f623ee9f21

src/dc_glade.py
src/gc_backend.py [deleted file]
src/gc_views.py [deleted file]
src/gv_views.py [new file with mode: 0644]

index 042671c..99889c5 100755 (executable)
@@ -70,9 +70,8 @@ class Dialcentral(object):
        ACCOUNT_TAB = 4
 
        NULL_BACKEND = 0
-       GC_BACKEND = 1
        GV_BACKEND = 2
-       BACKENDS = (NULL_BACKEND, GC_BACKEND, GV_BACKEND)
+       BACKENDS = (NULL_BACKEND, GV_BACKEND)
 
        def __init__(self):
                self._initDone = False
@@ -82,7 +81,7 @@ class Dialcentral(object):
 
                self._credentials = ("", "")
                self._selectedBackendId = self.NULL_BACKEND
-               self._defaultBackendId = self.GC_BACKEND
+               self._defaultBackendId = self.GV_BACKEND
                self._phoneBackends = None
                self._dialpads = None
                self._accountViews = None
@@ -219,9 +218,8 @@ class Dialcentral(object):
 
                        # Setup costly backends
                        import gv_backend
-                       import gc_backend
                        import file_backend
-                       import gc_views
+                       import gv_views
 
                        try:
                                os.makedirs(constants._data_path_)
@@ -231,57 +229,43 @@ class Dialcentral(object):
                        gcCookiePath = os.path.join(constants._data_path_, "gc_cookies.txt")
                        gvCookiePath = os.path.join(constants._data_path_, "gv_cookies.txt")
                        self._defaultBackendId = self._guess_preferred_backend((
-                               (self.GC_BACKEND, gcCookiePath),
                                (self.GV_BACKEND, gvCookiePath),
                        ))
 
                        self._phoneBackends.update({
-                               self.GC_BACKEND: gc_backend.GCDialer(gcCookiePath),
                                self.GV_BACKEND: gv_backend.GVDialer(gvCookiePath),
                        })
                        with gtk_toolbox.gtk_lock():
-                               unifiedDialpad = gc_views.Dialpad(self._widgetTree, self._errorDisplay)
+                               unifiedDialpad = gv_views.Dialpad(self._widgetTree, self._errorDisplay)
                                unifiedDialpad.set_number("")
                                self._dialpads.update({
-                                       self.GC_BACKEND: unifiedDialpad,
                                        self.GV_BACKEND: unifiedDialpad,
                                })
                                self._accountViews.update({
-                                       self.GC_BACKEND: gc_views.AccountInfo(
-                                               self._widgetTree, self._phoneBackends[self.GC_BACKEND], None, self._errorDisplay
-                                       ),
-                                       self.GV_BACKEND: gc_views.AccountInfo(
+                                       self.GV_BACKEND: gv_views.AccountInfo(
                                                self._widgetTree, self._phoneBackends[self.GV_BACKEND], self._alarmHandler, self._errorDisplay
                                        ),
                                })
-                               self._accountViews[self.GC_BACKEND].save_everything = lambda *args: None
                                self._accountViews[self.GV_BACKEND].save_everything = self._save_settings
                                self._recentViews.update({
-                                       self.GC_BACKEND: gc_views.RecentCallsView(
-                                               self._widgetTree, self._phoneBackends[self.GC_BACKEND], self._errorDisplay
-                                       ),
-                                       self.GV_BACKEND: gc_views.RecentCallsView(
+                                       self.GV_BACKEND: gv_views.RecentCallsView(
                                                self._widgetTree, self._phoneBackends[self.GV_BACKEND], self._errorDisplay
                                        ),
                                })
                                self._messagesViews.update({
-                                       self.GC_BACKEND: null_views.MessagesView(self._widgetTree),
-                                       self.GV_BACKEND: gc_views.MessagesView(
+                                       self.GV_BACKEND: gv_views.MessagesView(
                                                self._widgetTree, self._phoneBackends[self.GV_BACKEND], self._errorDisplay
                                        ),
                                })
                                self._contactsViews.update({
-                                       self.GC_BACKEND: gc_views.ContactsView(
-                                               self._widgetTree, self._phoneBackends[self.GC_BACKEND], self._errorDisplay
-                                       ),
-                                       self.GV_BACKEND: gc_views.ContactsView(
+                                       self.GV_BACKEND: gv_views.ContactsView(
                                                self._widgetTree, self._phoneBackends[self.GV_BACKEND], self._errorDisplay
                                        ),
                                })
 
                        fsContactsPath = os.path.join(constants._data_path_, "contacts")
                        fileBackend = file_backend.FilesystemAddressBookFactory(fsContactsPath)
-                       for backendId in (self.GV_BACKEND, self.GC_BACKEND):
+                       for backendId in (self.GV_BACKEND, ):
                                self._dialpads[backendId].number_selected = self._select_action
                                self._recentViews[backendId].number_selected = self._select_action
                                self._messagesViews[backendId].number_selected = self._select_action
@@ -291,7 +275,7 @@ class Dialcentral(object):
                                        self._phoneBackends[backendId],
                                        fileBackend,
                                ]
-                               mergedBook = gc_views.MergedAddressBook(addressBooks, gc_views.MergedAddressBook.advanced_lastname_sorter)
+                               mergedBook = gv_views.MergedAddressBook(addressBooks, gv_views.MergedAddressBook.advanced_lastname_sorter)
                                self._contactsViews[backendId].append(mergedBook)
                                self._contactsViews[backendId].extend(addressBooks)
                                self._contactsViews[backendId].open_addressbook(*self._contactsViews[backendId].get_addressbooks().next()[0][0:2])
@@ -413,7 +397,6 @@ class Dialcentral(object):
                                break
                        availableServices = (
                                (self.GV_BACKEND, "Google Voice"),
-                               (self.GC_BACKEND, "Grand Central"),
                        )
                        with gtk_toolbox.gtk_lock():
                                credentials = self._credentialsDialog.request_credentials_from(
diff --git a/src/gc_backend.py b/src/gc_backend.py
deleted file mode 100644 (file)
index 67723c7..0000000
+++ /dev/null
@@ -1,367 +0,0 @@
-#!/usr/bin/python
-
-"""
-DialCentral - Front end for Google's Grand Central service.
-Copyright (C) 2008  Eric Warnke ericew AT gmail DOT com
-
-This library is free software; you can redistribute it and/or
-modify it under the terms of the GNU Lesser General Public
-License as published by the Free Software Foundation; either
-version 2.1 of the License, or (at your option) any later version.
-
-This library 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
-Lesser General Public License for more details.
-
-You should have received a copy of the GNU Lesser General Public
-License along with this library; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-
-Grandcentral backend code
-"""
-
-
-import os
-import re
-import urllib
-import urllib2
-import time
-import warnings
-import traceback
-from xml.sax import saxutils
-
-import browser_emu
-
-
-class GCDialer(object):
-       """
-       This class encapsulates all of the knowledge necessary to interace with the grandcentral servers
-       the functions include login, setting up a callback number, and initalting a callback
-       """
-
-       _gcDialingStrRe = re.compile("This may take a few seconds", re.M)
-       _accessTokenRe = re.compile(r"""<input type="hidden" name="a_t" [^>]*value="(.*)"/>""")
-       _isLoginPageRe = re.compile(r"""<form method="post" action="https://www.grandcentral.com/mobile/account/login">""")
-       _callbackRe = re.compile(r"""name="default_number" value="(\d+)" />\s+(.*)\s$""", re.M)
-       _accountNumRe = re.compile(r"""<img src="/images/mobile/inbox_logo.gif" alt="GrandCentral" />\s*(.{14})\s*&nbsp""", re.M)
-       _upgradedAccountNumRe = re.compile(r"""<input type="hidden" name="gcentral_num" [^>]*value="(.*)"/>""")
-       _inboxRe = re.compile(r"""<td>.*?(voicemail|received|missed|call return).*?</td>\s+<td>\s+<font size="2">\s+(.*?)\s+&nbsp;\|&nbsp;\s+<a href="/mobile/contacts/.*?">(.*?)\s?</a>\s+<br/>\s+(.*?)\s?<a href=""", re.S)
-       _contactsRe = re.compile(r"""<a href="/mobile/contacts/detail/(\d+)">(.*?)</a>""", re.S)
-       _contactsNextRe = re.compile(r""".*<a href="/mobile/contacts(\?page=\d+)">Next</a>""", re.S)
-       _contactDetailPhoneRe = re.compile(r"""(\w+):[0-9\-\(\) \t]*?<a href="/mobile/calls/click_to_call\?destno=(\d+).*?">call</a>""", re.S)
-
-       _validateRe = re.compile("^[0-9]{10,}$")
-
-       _forwardselectURL = "http://www.grandcentral.com/mobile/settings/forwarding_select"
-       _loginURL = "https://www.grandcentral.com/mobile/account/login"
-       _setforwardURL = "http://www.grandcentral.com/mobile/settings/set_forwarding?from=settings"
-       _clicktocallURL = "http://www.grandcentral.com/mobile/calls/click_to_call?a_t=%s&destno=%s"
-       _inboxallURL = "http://www.grandcentral.com/mobile/messages/inbox?types=all"
-       _contactsURL = "http://www.grandcentral.com/mobile/contacts"
-       _contactDetailURL = "http://www.grandcentral.com/mobile/contacts/detail"
-
-       def __init__(self, cookieFile = None):
-               # Important items in this function are the setup of the browser emulation and cookie file
-               self._browser = browser_emu.MozillaEmulator(1)
-               if cookieFile is None:
-                       cookieFile = os.path.join(os.path.expanduser("~"), ".gc_cookies.txt")
-               self._browser.cookies.filename = cookieFile
-               if os.path.isfile(cookieFile):
-                       self._browser.cookies.load()
-
-               self._accessToken = None
-               self._accountNum = ""
-               self._lastAuthed = 0.0
-               self._callbackNumber = ""
-               self._callbackNumbers = {}
-
-               self.__contacts = None
-
-       def is_authed(self, force = False):
-               """
-               Attempts to detect a current session and pull the auth token ( a_t ) from the page.
-               @note Once logged in try not to reauth more than once a minute.
-               @returns If authenticated
-               """
-
-               if (time.time() - self._lastAuthed) < 60 and not force:
-                       return True
-
-               try:
-                       forwardSelectionPage = self._browser.download(self._forwardselectURL)
-               except urllib2.URLError, e:
-                       warnings.warn(traceback.format_exc())
-                       return False
-
-               if self._isLoginPageRe.search(forwardSelectionPage) is not None:
-                       return False
-
-               try:
-                       self._grab_token(forwardSelectionPage)
-               except StandardError, e:
-                       warnings.warn(traceback.format_exc())
-                       return False
-
-               self._browser.cookies.save()
-               self._lastAuthed = time.time()
-               return True
-
-       def login(self, username, password):
-               """
-               Attempt to login to grandcentral
-               @returns Whether login was successful or not
-               """
-               if self.is_authed():
-                       return True
-
-               loginPostData = urllib.urlencode( {'username' : username , 'password' : password } )
-
-               try:
-                       loginSuccessOrFailurePage = self._browser.download(self._loginURL, loginPostData)
-               except urllib2.URLError, e:
-                       warnings.warn(traceback.format_exc())
-                       raise RuntimeError("%s is not accesible" % self._loginURL)
-
-               return self.is_authed()
-
-       def logout(self):
-               self._lastAuthed = 0.0
-               self._browser.cookies.clear()
-               self._browser.cookies.save()
-
-               self.clear_caches()
-
-       def dial(self, number):
-               """
-               This is the main function responsible for initating the callback
-               """
-               if not self.is_valid_syntax(number):
-                       raise ValueError('Number is not valid: "%s"' % number)
-               elif not self.is_authed():
-                       raise RuntimeError("Not Authenticated")
-
-               if len(number) == 11 and number[0] == 1:
-                       # Strip leading 1 from 11 digit dialing
-                       number = number[1:]
-
-               try:
-                       callSuccessPage = self._browser.download(
-                               self._clicktocallURL % (self._accessToken, number),
-                               None,
-                               {'Referer' : 'http://www.grandcentral.com/mobile/messages'}
-                       )
-               except urllib2.URLError, e:
-                       warnings.warn(traceback.format_exc())
-                       raise RuntimeError("%s is not accesible" % self._clicktocallURL)
-
-               if self._gcDialingStrRe.search(callSuccessPage) is None:
-                       raise RuntimeError("Grand Central returned an error")
-
-               return True
-
-       def send_sms(self, number, message):
-               raise NotImplementedError("SMS Is Not Supported by GrandCentral")
-
-       def clear_caches(self):
-               self.__contacts = None
-
-       def is_valid_syntax(self, number):
-               """
-               @returns If This number be called ( syntax validation only )
-               """
-               return self._validateRe.match(number) is not None
-
-       def get_account_number(self):
-               """
-               @returns The grand central phone number
-               """
-               return self._accountNum
-
-       def set_sane_callback(self):
-               """
-               Try to set a sane default callback number on these preferences
-               1) 1747 numbers ( Gizmo )
-               2) anything with gizmo in the name
-               3) anything with computer in the name
-               4) the first value
-               """
-               numbers = self.get_callback_numbers()
-
-               for number, description in numbers.iteritems():
-                       if re.compile(r"""1747""").match(number) is not None:
-                               self.set_callback_number(number)
-                               return
-
-               for number, description in numbers.iteritems():
-                       if re.compile(r"""gizmo""", re.I).search(description) is not None:
-                               self.set_callback_number(number)
-                               return
-
-               for number, description in numbers.iteritems():
-                       if re.compile(r"""computer""", re.I).search(description) is not None:
-                               self.set_callback_number(number)
-                               return
-
-               for number, description in numbers.iteritems():
-                       self.set_callback_number(number)
-                       return
-
-       def get_callback_numbers(self):
-               """
-               @returns a dictionary mapping call back numbers to descriptions
-               @note These results are cached for 30 minutes.
-               """
-               if time.time() - self._lastAuthed < 1800 or self.is_authed():
-                       return self._callbackNumbers
-
-               return {}
-
-       def set_callback_number(self, callbacknumber):
-               """
-               Set the number that grandcental calls
-               @param callbacknumber should be a proper 10 digit number
-               """
-               self._callbackNumber = callbacknumber
-               callbackPostData = urllib.urlencode({
-                       'a_t': self._accessToken,
-                       'default_number': callbacknumber
-               })
-               try:
-                       callbackSetPage = self._browser.download(self._setforwardURL, callbackPostData)
-               except urllib2.URLError, e:
-                       warnings.warn(traceback.format_exc())
-                       raise RuntimeError("%s is not accesible" % self._setforwardURL)
-
-               self._browser.cookies.save()
-               return True
-
-       def get_callback_number(self):
-               """
-               @returns Current callback number or None
-               """
-               for c in self._browser.cookies:
-                       if c.name == "pda_forwarding_number":
-                               return c.value
-               return self._callbackNumber
-
-       def get_recent(self):
-               """
-               @returns Iterable of (personsName, phoneNumber, date, action)
-               """
-               try:
-                       recentCallsPage = self._browser.download(self._inboxallURL)
-               except urllib2.URLError, e:
-                       warnings.warn(traceback.format_exc())
-                       raise RuntimeError("%s is not accesible" % self._inboxallURL)
-
-               for match in self._inboxRe.finditer(recentCallsPage):
-                       phoneNumber = match.group(4)
-                       action = saxutils.unescape(match.group(1))
-                       date = saxutils.unescape(match.group(2))
-                       personsName = saxutils.unescape(match.group(3))
-                       yield personsName, phoneNumber, date, action
-
-       def get_addressbooks(self):
-               """
-               @returns Iterable of (Address Book Factory, Book Id, Book Name)
-               """
-               yield self, "", ""
-
-       def open_addressbook(self, bookId):
-               return self
-
-       @staticmethod
-       def contact_source_short_name(contactId):
-               return "GC"
-
-       @staticmethod
-       def factory_name():
-               return "Grand Central"
-
-       def get_contacts(self):
-               """
-               @returns Iterable of (contact id, contact name)
-               """
-               if self.__contacts is None:
-                       self.__contacts = []
-
-                       contactsPagesUrls = [self._contactsURL]
-                       for contactsPageUrl in contactsPagesUrls:
-                               try:
-                                       contactsPage = self._browser.download(contactsPageUrl)
-                               except urllib2.URLError, e:
-                                       warnings.warn(traceback.format_exc())
-                                       raise RuntimeError("%s is not accesible" % contactsPageUrl)
-                               for contact_match in self._contactsRe.finditer(contactsPage):
-                                       contactId = contact_match.group(1)
-                                       contactName = contact_match.group(2)
-                                       contact = contactId, saxutils.unescape(contactName)
-                                       self.__contacts.append(contact)
-                                       yield contact
-
-                               next_match = self._contactsNextRe.match(contactsPage)
-                               if next_match is not None:
-                                       newContactsPageUrl = self._contactsURL + next_match.group(1)
-                                       contactsPagesUrls.append(newContactsPageUrl)
-               else:
-                       for contact in self.__contacts:
-                               yield contact
-
-       def get_contact_details(self, contactId):
-               """
-               @returns Iterable of (Phone Type, Phone Number)
-               """
-               try:
-                       detailPage = self._browser.download(self._contactDetailURL + '/' + contactId)
-               except urllib2.URLError, e:
-                       warnings.warn(traceback.format_exc())
-                       raise RuntimeError("%s is not accesible" % self._contactDetailURL)
-
-               for detail_match in self._contactDetailPhoneRe.finditer(detailPage):
-                       phoneType = saxutils.unescape(detail_match.group(1))
-                       phoneNumber = detail_match.group(2)
-                       yield (phoneType, phoneNumber)
-
-       def get_messages(self):
-               return ()
-
-       def _grab_token(self, data):
-               "Pull the magic cookie from the datastream"
-               atGroup = self._accessTokenRe.search(data)
-               if atGroup is None:
-                       raise RuntimeError("Could not extract authentication token from GrandCentral")
-               self._accessToken = atGroup.group(1)
-
-               anGroup = self._accountNumRe.search(data)
-               if anGroup is None:
-                       anGroup = self._upgradedAccountNumRe.search(data)
-               if anGroup is not None:
-                       self._accountNum = anGroup.group(1)
-               else:
-                       warnings.warn("Could not extract account number from GrandCentral", UserWarning, 2)
-
-               self._callbackNumbers = {}
-               for match in self._callbackRe.finditer(data):
-                       self._callbackNumbers[match.group(1)] = match.group(2)
-
-
-def test_backend(username, password):
-       import pprint
-       backend = GCDialer()
-       print "Authenticated: ", backend.is_authed()
-       print "Login?: ", backend.login(username, password)
-       print "Authenticated: ", backend.is_authed()
-       # print "Token: ", backend._accessToken
-       print "Account: ", backend.get_account_number()
-       print "Callback: ", backend.get_callback_number()
-       # print "All Callback: ",
-       # pprint.pprint(backend.get_callback_numbers())
-       # print "Recent: ",
-       # pprint.pprint(list(backend.get_recent()))
-       # print "Contacts: ",
-       # for contact in backend.get_contacts():
-       #       print contact
-       #       pprint.pprint(list(backend.get_contact_details(contact[0])))
-
-       return backend
diff --git a/src/gc_views.py b/src/gc_views.py
deleted file mode 100644 (file)
index e9cb3b6..0000000
+++ /dev/null
@@ -1,1292 +0,0 @@
-#!/usr/bin/python2.5
-
-"""
-DialCentral - Front end for Google's Grand Central service.
-Copyright (C) 2008  Mark Bergman bergman AT merctech DOT com
-
-This library is free software; you can redistribute it and/or
-modify it under the terms of the GNU Lesser General Public
-License as published by the Free Software Foundation; either
-version 2.1 of the License, or (at your option) any later version.
-
-This library 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
-Lesser General Public License for more details.
-
-You should have received a copy of the GNU Lesser General Public
-License along with this library; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-"""
-
-from __future__ import with_statement
-
-import ConfigParser
-import warnings
-
-import gobject
-import pango
-import gtk
-
-import gtk_toolbox
-import hildonize
-import null_backend
-
-
-def make_ugly(prettynumber):
-       """
-       function to take a phone number and strip out all non-numeric
-       characters
-
-       >>> make_ugly("+012-(345)-678-90")
-       '01234567890'
-       """
-       import re
-       uglynumber = re.sub('\D', '', prettynumber)
-       return uglynumber
-
-
-def make_pretty(phonenumber):
-       """
-       Function to take a phone number and return the pretty version
-       pretty numbers:
-               if phonenumber begins with 0:
-                       ...-(...)-...-....
-               if phonenumber begins with 1: ( for gizmo callback numbers )
-                       1 (...)-...-....
-               if phonenumber is 13 digits:
-                       (...)-...-....
-               if phonenumber is 10 digits:
-                       ...-....
-       >>> make_pretty("12")
-       '12'
-       >>> make_pretty("1234567")
-       '123-4567'
-       >>> make_pretty("2345678901")
-       '(234)-567-8901'
-       >>> make_pretty("12345678901")
-       '1 (234)-567-8901'
-       >>> make_pretty("01234567890")
-       '+012-(345)-678-90'
-       """
-       if phonenumber is None or phonenumber is "":
-               return ""
-
-       phonenumber = make_ugly(phonenumber)
-
-       if len(phonenumber) < 3:
-               return phonenumber
-
-       if phonenumber[0] == "0":
-               prettynumber = ""
-               prettynumber += "+%s" % phonenumber[0:3]
-               if 3 < len(phonenumber):
-                       prettynumber += "-(%s)" % phonenumber[3:6]
-                       if 6 < len(phonenumber):
-                               prettynumber += "-%s" % phonenumber[6:9]
-                               if 9 < len(phonenumber):
-                                       prettynumber += "-%s" % phonenumber[9:]
-               return prettynumber
-       elif len(phonenumber) <= 7:
-               prettynumber = "%s-%s" % (phonenumber[0:3], phonenumber[3:])
-       elif len(phonenumber) > 8 and phonenumber[0] == "1":
-               prettynumber = "1 (%s)-%s-%s" % (phonenumber[1:4], phonenumber[4:7], phonenumber[7:])
-       elif len(phonenumber) > 7:
-               prettynumber = "(%s)-%s-%s" % (phonenumber[0:3], phonenumber[3:6], phonenumber[6:])
-       return prettynumber
-
-
-class MergedAddressBook(object):
-       """
-       Merger of all addressbooks
-       """
-
-       def __init__(self, addressbookFactories, sorter = None):
-               self.__addressbookFactories = addressbookFactories
-               self.__addressbooks = None
-               self.__sort_contacts = sorter if sorter is not None else self.null_sorter
-
-       def clear_caches(self):
-               self.__addressbooks = None
-               for factory in self.__addressbookFactories:
-                       factory.clear_caches()
-
-       def get_addressbooks(self):
-               """
-               @returns Iterable of (Address Book Factory, Book Id, Book Name)
-               """
-               yield self, "", ""
-
-       def open_addressbook(self, bookId):
-               return self
-
-       def contact_source_short_name(self, contactId):
-               if self.__addressbooks is None:
-                       return ""
-               bookIndex, originalId = contactId.split("-", 1)
-               return self.__addressbooks[int(bookIndex)].contact_source_short_name(originalId)
-
-       @staticmethod
-       def factory_name():
-               return "All Contacts"
-
-       def get_contacts(self):
-               """
-               @returns Iterable of (contact id, contact name)
-               """
-               if self.__addressbooks is None:
-                       self.__addressbooks = list(
-                               factory.open_addressbook(id)
-                               for factory in self.__addressbookFactories
-                               for (f, id, name) in factory.get_addressbooks()
-                       )
-               contacts = (
-                       ("-".join([str(bookIndex), contactId]), contactName)
-                               for (bookIndex, addressbook) in enumerate(self.__addressbooks)
-                                       for (contactId, contactName) in addressbook.get_contacts()
-               )
-               sortedContacts = self.__sort_contacts(contacts)
-               return sortedContacts
-
-       def get_contact_details(self, contactId):
-               """
-               @returns Iterable of (Phone Type, Phone Number)
-               """
-               if self.__addressbooks is None:
-                       return []
-               bookIndex, originalId = contactId.split("-", 1)
-               return self.__addressbooks[int(bookIndex)].get_contact_details(originalId)
-
-       @staticmethod
-       def null_sorter(contacts):
-               """
-               Good for speed/low memory
-               """
-               return contacts
-
-       @staticmethod
-       def basic_firtname_sorter(contacts):
-               """
-               Expects names in "First Last" format
-               """
-               contactsWithKey = [
-                       (contactName.rsplit(" ", 1)[0], (contactId, contactName))
-                               for (contactId, contactName) in contacts
-               ]
-               contactsWithKey.sort()
-               return (contactData for (lastName, contactData) in contactsWithKey)
-
-       @staticmethod
-       def basic_lastname_sorter(contacts):
-               """
-               Expects names in "First Last" format
-               """
-               contactsWithKey = [
-                       (contactName.rsplit(" ", 1)[-1], (contactId, contactName))
-                               for (contactId, contactName) in contacts
-               ]
-               contactsWithKey.sort()
-               return (contactData for (lastName, contactData) in contactsWithKey)
-
-       @staticmethod
-       def reversed_firtname_sorter(contacts):
-               """
-               Expects names in "Last, First" format
-               """
-               contactsWithKey = [
-                       (contactName.split(", ", 1)[-1], (contactId, contactName))
-                               for (contactId, contactName) in contacts
-               ]
-               contactsWithKey.sort()
-               return (contactData for (lastName, contactData) in contactsWithKey)
-
-       @staticmethod
-       def reversed_lastname_sorter(contacts):
-               """
-               Expects names in "Last, First" format
-               """
-               contactsWithKey = [
-                       (contactName.split(", ", 1)[0], (contactId, contactName))
-                               for (contactId, contactName) in contacts
-               ]
-               contactsWithKey.sort()
-               return (contactData for (lastName, contactData) in contactsWithKey)
-
-       @staticmethod
-       def guess_firstname(name):
-               if ", " in name:
-                       return name.split(", ", 1)[-1]
-               else:
-                       return name.rsplit(" ", 1)[0]
-
-       @staticmethod
-       def guess_lastname(name):
-               if ", " in name:
-                       return name.split(", ", 1)[0]
-               else:
-                       return name.rsplit(" ", 1)[-1]
-
-       @classmethod
-       def advanced_firstname_sorter(cls, contacts):
-               contactsWithKey = [
-                       (cls.guess_firstname(contactName), (contactId, contactName))
-                               for (contactId, contactName) in contacts
-               ]
-               contactsWithKey.sort()
-               return (contactData for (lastName, contactData) in contactsWithKey)
-
-       @classmethod
-       def advanced_lastname_sorter(cls, contacts):
-               contactsWithKey = [
-                       (cls.guess_lastname(contactName), (contactId, contactName))
-                               for (contactId, contactName) in contacts
-               ]
-               contactsWithKey.sort()
-               return (contactData for (lastName, contactData) in contactsWithKey)
-
-
-class PhoneTypeSelector(object):
-
-       ACTION_CANCEL = "cancel"
-       ACTION_SELECT = "select"
-       ACTION_DIAL = "dial"
-       ACTION_SEND_SMS = "sms"
-
-       def __init__(self, widgetTree, gcBackend):
-               self._gcBackend = gcBackend
-               self._widgetTree = widgetTree
-
-               self._dialog = self._widgetTree.get_widget("phonetype_dialog")
-               self._smsDialog = SmsEntryDialog(self._widgetTree)
-
-               self._smsButton = self._widgetTree.get_widget("sms_button")
-               self._smsButton.connect("clicked", self._on_phonetype_send_sms)
-
-               self._dialButton = self._widgetTree.get_widget("dial_button")
-               self._dialButton.connect("clicked", self._on_phonetype_dial)
-
-               self._selectButton = self._widgetTree.get_widget("select_button")
-               self._selectButton.connect("clicked", self._on_phonetype_select)
-
-               self._cancelButton = self._widgetTree.get_widget("cancel_button")
-               self._cancelButton.connect("clicked", self._on_phonetype_cancel)
-
-               self._typemodel = gtk.ListStore(gobject.TYPE_STRING, gobject.TYPE_STRING)
-               self._typeviewselection = None
-
-               self._message = self._widgetTree.get_widget("phoneSelectionMessage")
-               self._messageViewport = self._widgetTree.get_widget("phoneSelectionMessage_viewport")
-               self._scrollWindow = self._widgetTree.get_widget("phoneSelectionMessage_scrolledwindow")
-               self._typeview = self._widgetTree.get_widget("phonetypes")
-               self._typeview.connect("row-activated", self._on_phonetype_select)
-
-               self._action = self.ACTION_CANCEL
-
-       def run(self, contactDetails, message = "", parent = None):
-               self._action = self.ACTION_CANCEL
-               self._typemodel.clear()
-               self._typeview.set_model(self._typemodel)
-
-               # Add the column to the treeview
-               textrenderer = gtk.CellRendererText()
-               numberColumn = gtk.TreeViewColumn("Phone Numbers", textrenderer, text=0)
-               self._typeview.append_column(numberColumn)
-
-               textrenderer = gtk.CellRendererText()
-               typeColumn = gtk.TreeViewColumn("Phone Type", textrenderer, text=1)
-               self._typeview.append_column(typeColumn)
-
-               self._typeviewselection = self._typeview.get_selection()
-               self._typeviewselection.set_mode(gtk.SELECTION_SINGLE)
-
-               for phoneType, phoneNumber in contactDetails:
-                       display = " - ".join((phoneNumber, phoneType))
-                       display = phoneType
-                       row = (phoneNumber, display)
-                       self._typemodel.append(row)
-
-               self._typeviewselection.select_iter(self._typemodel.get_iter_first())
-               if message:
-                       self._message.set_markup(message)
-                       self._message.show()
-               else:
-                       self._message.set_markup("")
-                       self._message.hide()
-
-               if parent is not None:
-                       self._dialog.set_transient_for(parent)
-
-               try:
-                       self._dialog.show()
-                       adjustment = self._scrollWindow.get_vadjustment()
-                       dx = self._message.get_allocation().height - self._messageViewport.get_allocation().height
-                       dx = max(dx, 0)
-                       adjustment.value = dx
-
-                       userResponse = self._dialog.run()
-               finally:
-                       self._dialog.hide()
-
-               if userResponse == gtk.RESPONSE_OK:
-                       phoneNumber = self._get_number()
-                       phoneNumber = make_ugly(phoneNumber)
-               else:
-                       phoneNumber = ""
-               if not phoneNumber:
-                       self._action = self.ACTION_CANCEL
-
-               if self._action == self.ACTION_SEND_SMS:
-                       smsMessage = self._smsDialog.run(phoneNumber, message, parent)
-                       if not smsMessage:
-                               phoneNumber = ""
-                               self._action = self.ACTION_CANCEL
-               else:
-                       smsMessage = ""
-
-               self._typeviewselection.unselect_all()
-               self._typeview.remove_column(numberColumn)
-               self._typeview.remove_column(typeColumn)
-               self._typeview.set_model(None)
-
-               return self._action, phoneNumber, smsMessage
-
-       def _get_number(self):
-               model, itr = self._typeviewselection.get_selected()
-               if not itr:
-                       return ""
-
-               phoneNumber = self._typemodel.get_value(itr, 0)
-               return phoneNumber
-
-       def _on_phonetype_dial(self, *args):
-               self._dialog.response(gtk.RESPONSE_OK)
-               self._action = self.ACTION_DIAL
-
-       def _on_phonetype_send_sms(self, *args):
-               self._dialog.response(gtk.RESPONSE_OK)
-               self._action = self.ACTION_SEND_SMS
-
-       def _on_phonetype_select(self, *args):
-               self._dialog.response(gtk.RESPONSE_OK)
-               self._action = self.ACTION_SELECT
-
-       def _on_phonetype_cancel(self, *args):
-               self._dialog.response(gtk.RESPONSE_CANCEL)
-               self._action = self.ACTION_CANCEL
-
-
-class SmsEntryDialog(object):
-
-       """
-       @todo Add multi-SMS messages like GoogleVoice
-       """
-
-       MAX_CHAR = 160
-
-       def __init__(self, widgetTree):
-               self._widgetTree = widgetTree
-               self._dialog = self._widgetTree.get_widget("smsDialog")
-
-               self._smsButton = self._widgetTree.get_widget("sendSmsButton")
-               self._smsButton.connect("clicked", self._on_send)
-
-               self._cancelButton = self._widgetTree.get_widget("cancelSmsButton")
-               self._cancelButton.connect("clicked", self._on_cancel)
-
-               self._letterCountLabel = self._widgetTree.get_widget("smsLetterCount")
-               self._message = self._widgetTree.get_widget("smsMessage")
-               self._messageViewport = self._widgetTree.get_widget("smsMessage_viewport")
-               self._scrollWindow = self._widgetTree.get_widget("smsMessage_scrolledwindow")
-               self._smsEntry = self._widgetTree.get_widget("smsEntry")
-               self._smsEntry.get_buffer().connect("changed", self._on_entry_changed)
-
-       def run(self, number, message = "", parent = None):
-               if message:
-                       self._message.set_markup(message)
-                       self._message.show()
-               else:
-                       self._message.set_markup("")
-                       self._message.hide()
-               self._smsEntry.get_buffer().set_text("")
-               self._update_letter_count()
-
-               if parent is not None:
-                       self._dialog.set_transient_for(parent)
-
-               try:
-                       self._dialog.show()
-                       adjustment = self._scrollWindow.get_vadjustment()
-                       dx = self._message.get_allocation().height - self._messageViewport.get_allocation().height
-                       dx = max(dx, 0)
-                       adjustment.value = dx
-
-                       userResponse = self._dialog.run()
-               finally:
-                       self._dialog.hide()
-
-               if userResponse == gtk.RESPONSE_OK:
-                       entryBuffer = self._smsEntry.get_buffer()
-                       enteredMessage = entryBuffer.get_text(entryBuffer.get_start_iter(), entryBuffer.get_end_iter())
-                       enteredMessage = enteredMessage[0:self.MAX_CHAR]
-               else:
-                       enteredMessage = ""
-
-               return enteredMessage.strip()
-
-       def _update_letter_count(self, *args):
-               entryLength = self._smsEntry.get_buffer().get_char_count()
-               charsLeft = self.MAX_CHAR - entryLength
-               self._letterCountLabel.set_text(str(charsLeft))
-               if charsLeft < 0:
-                       self._smsButton.set_sensitive(False)
-               else:
-                       self._smsButton.set_sensitive(True)
-
-       def _on_entry_changed(self, *args):
-               self._update_letter_count()
-
-       def _on_send(self, *args):
-               self._dialog.response(gtk.RESPONSE_OK)
-
-       def _on_cancel(self, *args):
-               self._dialog.response(gtk.RESPONSE_CANCEL)
-
-
-class Dialpad(object):
-
-       def __init__(self, widgetTree, errorDisplay):
-               self._errorDisplay = errorDisplay
-               self._smsDialog = SmsEntryDialog(widgetTree)
-
-               self._numberdisplay = widgetTree.get_widget("numberdisplay")
-               self._dialButton = widgetTree.get_widget("dial")
-               self._backButton = widgetTree.get_widget("back")
-               self._phonenumber = ""
-               self._prettynumber = ""
-
-               callbackMapping = {
-                       "on_dial_clicked": self._on_dial_clicked,
-                       "on_sms_clicked": self._on_sms_clicked,
-                       "on_digit_clicked": self._on_digit_clicked,
-                       "on_clear_number": self._on_clear_number,
-               }
-               widgetTree.signal_autoconnect(callbackMapping)
-
-               self._originalLabel = self._backButton.get_label()
-               self._backTapHandler = gtk_toolbox.TapOrHold(self._backButton)
-               self._backTapHandler.on_tap = self._on_backspace
-               self._backTapHandler.on_hold = self._on_clearall
-               self._backTapHandler.on_holding = self._set_clear_button
-               self._backTapHandler.on_cancel = self._reset_back_button
-
-               self._window = gtk_toolbox.find_parent_window(self._numberdisplay)
-
-       def enable(self):
-               self.set_number(self._phonenumber)
-               self._dialButton.grab_focus()
-               self._backTapHandler.enable()
-
-       def disable(self):
-               self._reset_back_button()
-               self._backTapHandler.disable()
-               self.set_number("")
-
-       def number_selected(self, action, number, message):
-               """
-               @note Actual dial function is patched in later
-               """
-               raise NotImplementedError("Horrible unknown error has occurred")
-
-       def get_number(self):
-               return self._phonenumber
-
-       def set_number(self, number):
-               """
-               Set the number to dial
-               """
-               try:
-                       self._phonenumber = make_ugly(number)
-                       self._prettynumber = make_pretty(self._phonenumber)
-                       self._numberdisplay.set_label("<span size='30000' weight='bold'>%s</span>" % (self._prettynumber))
-               except TypeError, e:
-                       self._errorDisplay.push_exception()
-
-       def clear(self):
-               self.set_number("")
-
-       @staticmethod
-       def name():
-               return "Dialpad"
-
-       def load_settings(self, config, section):
-               pass
-
-       def save_settings(self, config, section):
-               """
-               @note Thread Agnostic
-               """
-               pass
-
-       def _on_sms_clicked(self, widget):
-               action = PhoneTypeSelector.ACTION_SEND_SMS
-               phoneNumber = self.get_number()
-
-               message = self._smsDialog.run(phoneNumber, "", self._window)
-               if not message:
-                       phoneNumber = ""
-                       action = PhoneTypeSelector.ACTION_CANCEL
-
-               if action == PhoneTypeSelector.ACTION_CANCEL:
-                       return
-               self.number_selected(action, phoneNumber, message)
-
-       def _on_dial_clicked(self, widget):
-               action = PhoneTypeSelector.ACTION_DIAL
-               phoneNumber = self.get_number()
-               message = ""
-               self.number_selected(action, phoneNumber, message)
-
-       def _on_clear_number(self, *args):
-               self.clear()
-
-       def _on_digit_clicked(self, widget):
-               self.set_number(self._phonenumber + widget.get_name()[-1])
-
-       def _on_backspace(self, taps):
-               self.set_number(self._phonenumber[:-taps])
-               self._reset_back_button()
-
-       def _on_clearall(self, taps):
-               self.clear()
-               self._reset_back_button()
-               return False
-
-       def _set_clear_button(self):
-               self._backButton.set_label("gtk-clear")
-
-       def _reset_back_button(self):
-               self._backButton.set_label(self._originalLabel)
-
-
-class AccountInfo(object):
-
-       def __init__(self, widgetTree, backend, alarmHandler, errorDisplay):
-               self._errorDisplay = errorDisplay
-               self._backend = backend
-               self._isPopulated = False
-               self._alarmHandler = alarmHandler
-               self._notifyOnMissed = False
-               self._notifyOnVoicemail = False
-               self._notifyOnSms = False
-
-               self._callbackList = gtk.ListStore(gobject.TYPE_STRING)
-               self._accountViewNumberDisplay = widgetTree.get_widget("gcnumber_display")
-               self._callbackCombo = widgetTree.get_widget("callbackcombo")
-               self._onCallbackentryChangedId = 0
-
-               self._notifyCheckbox = widgetTree.get_widget("notifyCheckbox")
-               self._minutesEntry = widgetTree.get_widget("minutesEntry")
-               self._missedCheckbox = widgetTree.get_widget("missedCheckbox")
-               self._voicemailCheckbox = widgetTree.get_widget("voicemailCheckbox")
-               self._smsCheckbox = widgetTree.get_widget("smsCheckbox")
-               self._onNotifyToggled = 0
-               self._onMinutesChanged = 0
-               self._onMissedToggled = 0
-               self._onVoicemailToggled = 0
-               self._onSmsToggled = 0
-               self._applyAlarmTimeoutId = None
-
-               self._defaultCallback = ""
-
-       def enable(self):
-               assert self._backend.is_authed(), "Attempting to enable backend while not logged in"
-
-               self._accountViewNumberDisplay.set_use_markup(True)
-               self.set_account_number("")
-
-               self._callbackList.clear()
-               self._onCallbackentryChangedId = self._callbackCombo.get_child().connect("changed", self._on_callbackentry_changed)
-
-               if self._alarmHandler is not None:
-                       self._minutesEntry.set_range(1, 60)
-
-                       self._notifyCheckbox.set_active(self._alarmHandler.isEnabled)
-                       self._minutesEntry.set_value(self._alarmHandler.recurrence)
-                       self._missedCheckbox.set_active(self._notifyOnMissed)
-                       self._voicemailCheckbox.set_active(self._notifyOnVoicemail)
-                       self._smsCheckbox.set_active(self._notifyOnSms)
-
-                       self._onNotifyToggled = self._notifyCheckbox.connect("toggled", self._on_notify_toggled)
-                       self._onMinutesChanged = self._minutesEntry.connect("value-changed", self._on_minutes_changed)
-                       self._onMissedToggled = self._missedCheckbox.connect("toggled", self._on_missed_toggled)
-                       self._onVoicemailToggled = self._voicemailCheckbox.connect("toggled", self._on_voicemail_toggled)
-                       self._onSmsToggled = self._smsCheckbox.connect("toggled", self._on_sms_toggled)
-               else:
-                       self._notifyCheckbox.set_sensitive(False)
-                       self._minutesEntry.set_sensitive(False)
-                       self._missedCheckbox.set_sensitive(False)
-                       self._voicemailCheckbox.set_sensitive(False)
-                       self._smsCheckbox.set_sensitive(False)
-
-               self.update(force=True)
-
-       def disable(self):
-               self._callbackCombo.get_child().disconnect(self._onCallbackentryChangedId)
-               self._onCallbackentryChangedId = 0
-
-               if self._alarmHandler is not None:
-                       self._notifyCheckbox.disconnect(self._onNotifyToggled)
-                       self._minutesEntry.disconnect(self._onMinutesChanged)
-                       self._missedCheckbox.disconnect(self._onNotifyToggled)
-                       self._voicemailCheckbox.disconnect(self._onNotifyToggled)
-                       self._smsCheckbox.disconnect(self._onNotifyToggled)
-                       self._onNotifyToggled = 0
-                       self._onMinutesChanged = 0
-                       self._onMissedToggled = 0
-                       self._onVoicemailToggled = 0
-                       self._onSmsToggled = 0
-               else:
-                       self._notifyCheckbox.set_sensitive(True)
-                       self._minutesEntry.set_sensitive(True)
-                       self._missedCheckbox.set_sensitive(True)
-                       self._voicemailCheckbox.set_sensitive(True)
-                       self._smsCheckbox.set_sensitive(True)
-
-               self.clear()
-               self._callbackList.clear()
-
-       def get_selected_callback_number(self):
-               return make_ugly(self._callbackCombo.get_child().get_text())
-
-       def set_account_number(self, number):
-               """
-               Displays current account number
-               """
-               self._accountViewNumberDisplay.set_label("<span size='23000' weight='bold'>%s</span>" % (number))
-
-       def update(self, force = False):
-               if not force and self._isPopulated:
-                       return False
-               self._populate_callback_combo()
-               self.set_account_number(self._backend.get_account_number())
-               return True
-
-       def clear(self):
-               self._callbackCombo.get_child().set_text("")
-               self.set_account_number("")
-               self._isPopulated = False
-
-       def save_everything(self):
-               raise NotImplementedError
-
-       @staticmethod
-       def name():
-               return "Account Info"
-
-       def load_settings(self, config, section):
-               self._defaultCallback = config.get(section, "callback")
-               self._notifyOnMissed = config.getboolean(section, "notifyOnMissed")
-               self._notifyOnVoicemail = config.getboolean(section, "notifyOnVoicemail")
-               self._notifyOnSms = config.getboolean(section, "notifyOnSms")
-
-       def save_settings(self, config, section):
-               """
-               @note Thread Agnostic
-               """
-               callback = self.get_selected_callback_number()
-               config.set(section, "callback", callback)
-               config.set(section, "notifyOnMissed", repr(self._notifyOnMissed))
-               config.set(section, "notifyOnVoicemail", repr(self._notifyOnVoicemail))
-               config.set(section, "notifyOnSms", repr(self._notifyOnSms))
-
-       def _populate_callback_combo(self):
-               self._isPopulated = True
-               self._callbackList.clear()
-               try:
-                       callbackNumbers = self._backend.get_callback_numbers()
-               except StandardError, e:
-                       self._errorDisplay.push_exception()
-                       self._isPopulated = False
-                       return
-
-               for number, description in callbackNumbers.iteritems():
-                       self._callbackList.append((make_pretty(number),))
-
-               self._callbackCombo.set_model(self._callbackList)
-               self._callbackCombo.set_text_column(0)
-               #callbackNumber = self._backend.get_callback_number()
-               callbackNumber = self._defaultCallback
-               self._callbackCombo.get_child().set_text(make_pretty(callbackNumber))
-
-       def _set_callback_number(self, number):
-               try:
-                       if not self._backend.is_valid_syntax(number):
-                               self._errorDisplay.push_message("%s is not a valid callback number" % number)
-                       elif number == self._backend.get_callback_number():
-                               warnings.warn(
-                                       "Callback number already is %s" % (
-                                               self._backend.get_callback_number(),
-                                       ),
-                                       UserWarning,
-                                       2
-                               )
-                       else:
-                               self._backend.set_callback_number(number)
-                               assert make_ugly(number) == make_ugly(self._backend.get_callback_number()), "Callback number should be %s but instead is %s" % (
-                                       make_pretty(number), make_pretty(self._backend.get_callback_number())
-                               )
-                               warnings.warn(
-                                       "Callback number set to %s" % (
-                                               self._backend.get_callback_number(),
-                                       ),
-                                       UserWarning, 2
-                               )
-               except StandardError, e:
-                       self._errorDisplay.push_exception()
-
-       def _update_alarm_settings(self):
-               try:
-                       isEnabled = self._notifyCheckbox.get_active()
-                       recurrence = self._minutesEntry.get_value_as_int()
-                       if isEnabled != self._alarmHandler.isEnabled or recurrence != self._alarmHandler.recurrence:
-                               self._alarmHandler.apply_settings(isEnabled, recurrence)
-               finally:
-                       self.save_everything()
-                       self._notifyCheckbox.set_active(self._alarmHandler.isEnabled)
-                       self._minutesEntry.set_value(self._alarmHandler.recurrence)
-
-       def _on_callbackentry_changed(self, *args):
-               text = self.get_selected_callback_number()
-               number = make_ugly(text)
-               self._set_callback_number(number)
-
-       def _on_notify_toggled(self, *args):
-               if self._applyAlarmTimeoutId is not None:
-                       gobject.source_remove(self._applyAlarmTimeoutId)
-                       self._applyAlarmTimeoutId = None
-               self._applyAlarmTimeoutId = gobject.timeout_add(500, self._on_apply_timeout)
-
-       def _on_minutes_changed(self, *args):
-               if self._applyAlarmTimeoutId is not None:
-                       gobject.source_remove(self._applyAlarmTimeoutId)
-                       self._applyAlarmTimeoutId = None
-               self._applyAlarmTimeoutId = gobject.timeout_add(500, self._on_apply_timeout)
-
-       def _on_apply_timeout(self, *args):
-               self._applyAlarmTimeoutId = None
-
-               self._update_alarm_settings()
-               return False
-
-       def _on_missed_toggled(self, *args):
-               self._notifyOnMissed = self._missedCheckbox.get_active()
-               self.save_everything()
-
-       def _on_voicemail_toggled(self, *args):
-               self._notifyOnVoicemail = self._voicemailCheckbox.get_active()
-               self.save_everything()
-
-       def _on_sms_toggled(self, *args):
-               self._notifyOnSms = self._smsCheckbox.get_active()
-               self.save_everything()
-
-
-class RecentCallsView(object):
-
-       NUMBER_IDX = 0
-       DATE_IDX = 1
-       ACTION_IDX = 2
-       FROM_IDX = 3
-
-       def __init__(self, widgetTree, backend, errorDisplay):
-               self._errorDisplay = errorDisplay
-               self._backend = backend
-
-               self._isPopulated = False
-               self._recentmodel = gtk.ListStore(
-                       gobject.TYPE_STRING, # number
-                       gobject.TYPE_STRING, # date
-                       gobject.TYPE_STRING, # action
-                       gobject.TYPE_STRING, # from
-               )
-               self._recentview = widgetTree.get_widget("recentview")
-               self._recentviewselection = None
-               self._onRecentviewRowActivatedId = 0
-
-               textrenderer = gtk.CellRendererText()
-               textrenderer.set_property("yalign", 0)
-               hildonize.set_cell_thumb_selectable(textrenderer)
-               self._dateColumn = gtk.TreeViewColumn("Date")
-               self._dateColumn.pack_start(textrenderer, expand=True)
-               self._dateColumn.add_attribute(textrenderer, "text", self.DATE_IDX)
-
-               textrenderer = gtk.CellRendererText()
-               textrenderer.set_property("yalign", 0)
-               hildonize.set_cell_thumb_selectable(textrenderer)
-               self._actionColumn = gtk.TreeViewColumn("Action")
-               self._actionColumn.pack_start(textrenderer, expand=True)
-               self._actionColumn.add_attribute(textrenderer, "text", self.ACTION_IDX)
-
-               textrenderer = gtk.CellRendererText()
-               textrenderer.set_property("yalign", 0)
-               hildonize.set_cell_thumb_selectable(textrenderer)
-               self._nameColumn = gtk.TreeViewColumn("From")
-               self._nameColumn.pack_start(textrenderer, expand=True)
-               self._nameColumn.add_attribute(textrenderer, "text", self.FROM_IDX)
-               self._nameColumn.set_sizing(gtk.TREE_VIEW_COLUMN_FIXED)
-
-               textrenderer = gtk.CellRendererText()
-               textrenderer.set_property("yalign", 0)
-               hildonize.set_cell_thumb_selectable(textrenderer)
-               self._numberColumn = gtk.TreeViewColumn("Number")
-               self._numberColumn.pack_start(textrenderer, expand=True)
-               self._numberColumn.add_attribute(textrenderer, "text", self.NUMBER_IDX)
-
-               self._window = gtk_toolbox.find_parent_window(self._recentview)
-               self._phoneTypeSelector = PhoneTypeSelector(widgetTree, self._backend)
-
-               self._updateSink = gtk_toolbox.threaded_stage(
-                       gtk_toolbox.comap(
-                               self._idly_populate_recentview,
-                               gtk_toolbox.null_sink(),
-                       )
-               )
-
-       def enable(self):
-               assert self._backend.is_authed(), "Attempting to enable backend while not logged in"
-               self._recentview.set_model(self._recentmodel)
-
-               self._recentview.append_column(self._dateColumn)
-               self._recentview.append_column(self._actionColumn)
-               self._recentview.append_column(self._numberColumn)
-               self._recentview.append_column(self._nameColumn)
-               self._recentviewselection = self._recentview.get_selection()
-               self._recentviewselection.set_mode(gtk.SELECTION_SINGLE)
-
-               self._onRecentviewRowActivatedId = self._recentview.connect("row-activated", self._on_recentview_row_activated)
-
-       def disable(self):
-               self._recentview.disconnect(self._onRecentviewRowActivatedId)
-
-               self.clear()
-
-               self._recentview.remove_column(self._dateColumn)
-               self._recentview.remove_column(self._actionColumn)
-               self._recentview.remove_column(self._nameColumn)
-               self._recentview.remove_column(self._numberColumn)
-               self._recentview.set_model(None)
-
-       def number_selected(self, action, number, message):
-               """
-               @note Actual dial function is patched in later
-               """
-               raise NotImplementedError("Horrible unknown error has occurred")
-
-       def update(self, force = False):
-               if not force and self._isPopulated:
-                       return False
-               self._updateSink.send(())
-               return True
-
-       def clear(self):
-               self._isPopulated = False
-               self._recentmodel.clear()
-
-       @staticmethod
-       def name():
-               return "Recent Calls"
-
-       def load_settings(self, config, section):
-               pass
-
-       def save_settings(self, config, section):
-               """
-               @note Thread Agnostic
-               """
-               pass
-
-       def _idly_populate_recentview(self):
-               self._recentmodel.clear()
-               self._isPopulated = True
-
-               try:
-                       recentItems = self._backend.get_recent()
-               except StandardError, e:
-                       self._errorDisplay.push_exception_with_lock()
-                       self._isPopulated = False
-                       recentItems = []
-
-               for personName, phoneNumber, date, action in recentItems:
-                       if not personName:
-                               personName = "Unknown"
-                       prettyNumber = phoneNumber[2:] if phoneNumber.startswith("+1") else phoneNumber
-                       prettyNumber = make_pretty(prettyNumber)
-                       item = (prettyNumber, date, action.capitalize(), personName)
-                       with gtk_toolbox.gtk_lock():
-                               self._recentmodel.append(item)
-
-               return False
-
-       def _on_recentview_row_activated(self, treeview, path, view_column):
-               model, itr = self._recentviewselection.get_selected()
-               if not itr:
-                       return
-
-               number = self._recentmodel.get_value(itr, self.NUMBER_IDX)
-               number = make_ugly(number)
-               contactPhoneNumbers = [("Phone", number)]
-               description = self._recentmodel.get_value(itr, self.FROM_IDX)
-
-               action, phoneNumber, message = self._phoneTypeSelector.run(
-                       contactPhoneNumbers,
-                       message = description,
-                       parent = self._window,
-               )
-               if action == PhoneTypeSelector.ACTION_CANCEL:
-                       return
-               assert phoneNumber, "A lack of phone number exists"
-
-               self.number_selected(action, phoneNumber, message)
-               self._recentviewselection.unselect_all()
-
-
-class MessagesView(object):
-
-       NUMBER_IDX = 0
-       DATE_IDX = 1
-       HEADER_IDX = 2
-       MESSAGE_IDX = 3
-
-       def __init__(self, widgetTree, backend, errorDisplay):
-               self._errorDisplay = errorDisplay
-               self._backend = backend
-
-               self._isPopulated = False
-               self._messagemodel = gtk.ListStore(
-                       gobject.TYPE_STRING, # number
-                       gobject.TYPE_STRING, # date
-                       gobject.TYPE_STRING, # header
-                       gobject.TYPE_STRING, # message
-               )
-               self._messageview = widgetTree.get_widget("messages_view")
-               self._messageviewselection = None
-               self._onMessageviewRowActivatedId = 0
-
-               self._messageRenderer = gtk.CellRendererText()
-               hildonize.set_cell_thumb_selectable(self._messageRenderer)
-               self._messageRenderer.set_property("wrap-mode", pango.WRAP_WORD)
-               self._messageRenderer.set_property("wrap-width", 650)
-               self._messageColumn = gtk.TreeViewColumn("Messages")
-               self._messageColumn.pack_start(self._messageRenderer, expand=True)
-               self._messageColumn.add_attribute(self._messageRenderer, "markup", self.MESSAGE_IDX)
-               self._messageColumn.set_sizing(gtk.TREE_VIEW_COLUMN_FIXED)
-
-               self._window = gtk_toolbox.find_parent_window(self._messageview)
-               self._phoneTypeSelector = PhoneTypeSelector(widgetTree, self._backend)
-
-               self._updateSink = gtk_toolbox.threaded_stage(
-                       gtk_toolbox.comap(
-                               self._idly_populate_messageview,
-                               gtk_toolbox.null_sink(),
-                       )
-               )
-
-       def enable(self):
-               assert self._backend.is_authed(), "Attempting to enable backend while not logged in"
-               self._messageview.set_model(self._messagemodel)
-
-               self._messageview.append_column(self._messageColumn)
-               self._messageviewselection = self._messageview.get_selection()
-               self._messageviewselection.set_mode(gtk.SELECTION_SINGLE)
-
-               self._onMessageviewRowActivatedId = self._messageview.connect("row-activated", self._on_messageview_row_activated)
-
-       def disable(self):
-               self._messageview.disconnect(self._onMessageviewRowActivatedId)
-
-               self.clear()
-
-               self._messageview.remove_column(self._dateColumn)
-               self._messageview.remove_column(self._headerColumn)
-               self._messageview.remove_column(self._messageColumn)
-               self._messageview.set_model(None)
-
-       def number_selected(self, action, number, message):
-               """
-               @note Actual dial function is patched in later
-               """
-               raise NotImplementedError("Horrible unknown error has occurred")
-
-       def update(self, force = False):
-               if not force and self._isPopulated:
-                       return False
-               self._updateSink.send(())
-               return True
-
-       def clear(self):
-               self._isPopulated = False
-               self._messagemodel.clear()
-
-       @staticmethod
-       def name():
-               return "Messages"
-
-       def load_settings(self, config, section):
-               pass
-
-       def save_settings(self, config, section):
-               """
-               @note Thread Agnostic
-               """
-               pass
-
-       def _idly_populate_messageview(self):
-               self._messagemodel.clear()
-               self._isPopulated = True
-
-               try:
-                       messageItems = self._backend.get_messages()
-               except StandardError, e:
-                       self._errorDisplay.push_exception_with_lock()
-                       self._isPopulated = False
-                       messageItems = []
-
-               for header, number, relativeDate, message in messageItems:
-                       prettyNumber = number[2:] if number.startswith("+1") else number
-                       prettyNumber = make_pretty(prettyNumber)
-                       message = "<b>%s - %s</b> <i>(%s)</i>\n\n%s" % (header, prettyNumber, relativeDate, message)
-                       number = make_ugly(number)
-                       row = (number, relativeDate, header, message)
-                       with gtk_toolbox.gtk_lock():
-                               self._messagemodel.append(row)
-
-               return False
-
-       def _on_messageview_row_activated(self, treeview, path, view_column):
-               model, itr = self._messageviewselection.get_selected()
-               if not itr:
-                       return
-
-               contactPhoneNumbers = [("Phone", self._messagemodel.get_value(itr, self.NUMBER_IDX))]
-               description = self._messagemodel.get_value(itr, self.MESSAGE_IDX)
-
-               action, phoneNumber, message = self._phoneTypeSelector.run(
-                       contactPhoneNumbers,
-                       message = description,
-                       parent = self._window,
-               )
-               if action == PhoneTypeSelector.ACTION_CANCEL:
-                       return
-               assert phoneNumber, "A lock of phone number exists"
-
-               self.number_selected(action, phoneNumber, message)
-               self._messageviewselection.unselect_all()
-
-
-class ContactsView(object):
-
-       def __init__(self, widgetTree, backend, errorDisplay):
-               self._errorDisplay = errorDisplay
-               self._backend = backend
-
-               self._addressBook = None
-               self._selectedComboIndex = 0
-               self._addressBookFactories = [null_backend.NullAddressBook()]
-
-               self._booksList = gtk.ListStore(gobject.TYPE_STRING, gobject.TYPE_STRING, gobject.TYPE_STRING)
-               self._booksSelectionBox = widgetTree.get_widget("addressbook_combo")
-
-               self._isPopulated = False
-               self._contactsmodel = gtk.ListStore(gobject.TYPE_STRING, gobject.TYPE_STRING, gobject.TYPE_STRING, gobject.TYPE_STRING, gobject.TYPE_STRING)
-               self._contactsviewselection = None
-               self._contactsview = widgetTree.get_widget("contactsview")
-
-               self._contactColumn = gtk.TreeViewColumn("Contact")
-               displayContactSource = False
-               if displayContactSource:
-                       textrenderer = gtk.CellRendererText()
-                       self._contactColumn.pack_start(textrenderer, expand=False)
-                       self._contactColumn.add_attribute(textrenderer, 'text', 0)
-               textrenderer = gtk.CellRendererText()
-               hildonize.set_cell_thumb_selectable(textrenderer)
-               self._contactColumn.pack_start(textrenderer, expand=True)
-               self._contactColumn.add_attribute(textrenderer, 'text', 1)
-               textrenderer = gtk.CellRendererText()
-               self._contactColumn.pack_start(textrenderer, expand=True)
-               self._contactColumn.add_attribute(textrenderer, 'text', 4)
-               self._contactColumn.set_sizing(gtk.TREE_VIEW_COLUMN_FIXED)
-               self._contactColumn.set_sort_column_id(1)
-               self._contactColumn.set_visible(True)
-
-               self._onContactsviewRowActivatedId = 0
-               self._onAddressbookComboChangedId = 0
-               self._window = gtk_toolbox.find_parent_window(self._contactsview)
-               self._phoneTypeSelector = PhoneTypeSelector(widgetTree, self._backend)
-
-               self._updateSink = gtk_toolbox.threaded_stage(
-                       gtk_toolbox.comap(
-                               self._idly_populate_contactsview,
-                               gtk_toolbox.null_sink(),
-                       )
-               )
-
-       def enable(self):
-               assert self._backend.is_authed(), "Attempting to enable backend while not logged in"
-
-               self._contactsview.set_model(self._contactsmodel)
-               self._contactsview.append_column(self._contactColumn)
-               self._contactsviewselection = self._contactsview.get_selection()
-               self._contactsviewselection.set_mode(gtk.SELECTION_SINGLE)
-
-               self._booksList.clear()
-               for (factoryId, bookId), (factoryName, bookName) in self.get_addressbooks():
-                       if factoryName and bookName:
-                               entryName = "%s: %s" % (factoryName, bookName)
-                       elif factoryName:
-                               entryName = factoryName
-                       elif bookName:
-                               entryName = bookName
-                       else:
-                               entryName = "Bad name (%d)" % factoryId
-                       row = (str(factoryId), bookId, entryName)
-                       self._booksList.append(row)
-
-               self._booksSelectionBox.set_model(self._booksList)
-               cell = gtk.CellRendererText()
-               self._booksSelectionBox.pack_start(cell, True)
-               self._booksSelectionBox.add_attribute(cell, 'text', 2)
-
-               self._onContactsviewRowActivatedId = self._contactsview.connect("row-activated", self._on_contactsview_row_activated)
-               self._onAddressbookComboChangedId = self._booksSelectionBox.connect("changed", self._on_addressbook_combo_changed)
-
-               if len(self._booksList) <= self._selectedComboIndex:
-                       self._selectedComboIndex = 0
-               self._booksSelectionBox.set_active(self._selectedComboIndex)
-
-       def disable(self):
-               self._contactsview.disconnect(self._onContactsviewRowActivatedId)
-               self._booksSelectionBox.disconnect(self._onAddressbookComboChangedId)
-
-               self.clear()
-
-               self._booksSelectionBox.clear()
-               self._booksSelectionBox.set_model(None)
-               self._contactsview.set_model(None)
-               self._contactsview.remove_column(self._contactColumn)
-
-       def number_selected(self, action, number, message):
-               """
-               @note Actual dial function is patched in later
-               """
-               raise NotImplementedError("Horrible unknown error has occurred")
-
-       def get_addressbooks(self):
-               """
-               @returns Iterable of ((Factory Id, Book Id), (Factory Name, Book Name))
-               """
-               for i, factory in enumerate(self._addressBookFactories):
-                       for bookFactory, bookId, bookName in factory.get_addressbooks():
-                               yield (str(i), bookId), (factory.factory_name(), bookName)
-
-       def open_addressbook(self, bookFactoryId, bookId):
-               bookFactoryIndex = int(bookFactoryId)
-               addressBook = self._addressBookFactories[bookFactoryIndex].open_addressbook(bookId)
-
-               forceUpdate = True if addressBook is not self._addressBook else False
-
-               self._addressBook = addressBook
-               self.update(force=forceUpdate)
-
-       def update(self, force = False):
-               if not force and self._isPopulated:
-                       return False
-               self._updateSink.send(())
-               return True
-
-       def clear(self):
-               self._isPopulated = False
-               self._contactsmodel.clear()
-               for factory in self._addressBookFactories:
-                       factory.clear_caches()
-               self._addressBook.clear_caches()
-
-       def append(self, book):
-               self._addressBookFactories.append(book)
-
-       def extend(self, books):
-               self._addressBookFactories.extend(books)
-
-       @staticmethod
-       def name():
-               return "Contacts"
-
-       def load_settings(self, config, sectionName):
-               try:
-                       self._selectedComboIndex = config.getint(sectionName, "selectedAddressbook")
-               except ConfigParser.NoOptionError:
-                       self._selectedComboIndex = 0
-
-       def save_settings(self, config, sectionName):
-               config.set(sectionName, "selectedAddressbook", str(self._selectedComboIndex))
-
-       def _idly_populate_contactsview(self):
-               addressBook = None
-               while addressBook is not self._addressBook:
-                       addressBook = self._addressBook
-                       with gtk_toolbox.gtk_lock():
-                               self._contactsview.set_model(None)
-                               self.clear()
-
-                       try:
-                               contacts = addressBook.get_contacts()
-                       except StandardError, e:
-                               contacts = []
-                               self._isPopulated = False
-                               self._errorDisplay.push_exception_with_lock()
-                       for contactId, contactName in contacts:
-                               contactType = (addressBook.contact_source_short_name(contactId), )
-                               self._contactsmodel.append(contactType + (contactName, "", contactId) + ("", ))
-
-                       with gtk_toolbox.gtk_lock():
-                               self._contactsview.set_model(self._contactsmodel)
-
-               self._isPopulated = True
-               return False
-
-       def _on_addressbook_combo_changed(self, *args, **kwds):
-               itr = self._booksSelectionBox.get_active_iter()
-               if itr is None:
-                       return
-               self._selectedComboIndex = self._booksSelectionBox.get_active()
-               selectedFactoryId = self._booksList.get_value(itr, 0)
-               selectedBookId = self._booksList.get_value(itr, 1)
-               self.open_addressbook(selectedFactoryId, selectedBookId)
-
-       def _on_contactsview_row_activated(self, treeview, path, view_column):
-               model, itr = self._contactsviewselection.get_selected()
-               if not itr:
-                       return
-
-               contactId = self._contactsmodel.get_value(itr, 3)
-               contactName = self._contactsmodel.get_value(itr, 1)
-               try:
-                       contactDetails = self._addressBook.get_contact_details(contactId)
-               except StandardError, e:
-                       contactDetails = []
-                       self._errorDisplay.push_exception()
-               contactPhoneNumbers = [phoneNumber for phoneNumber in contactDetails]
-
-               if len(contactPhoneNumbers) == 0:
-                       return
-
-               action, phoneNumber, message = self._phoneTypeSelector.run(
-                       contactPhoneNumbers,
-                       message = contactName,
-                       parent = self._window,
-               )
-               if action == PhoneTypeSelector.ACTION_CANCEL:
-                       return
-               assert phoneNumber, "A lack of phone number exists"
-
-               self.number_selected(action, phoneNumber, message)
-               self._contactsviewselection.unselect_all()
diff --git a/src/gv_views.py b/src/gv_views.py
new file mode 100644 (file)
index 0000000..9cd8053
--- /dev/null
@@ -0,0 +1,1290 @@
+#!/usr/bin/python2.5
+
+"""
+DialCentral - Front end for Google's Grand Central service.
+Copyright (C) 2008  Mark Bergman bergman AT merctech DOT com
+
+This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.
+
+This library 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
+Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+"""
+
+from __future__ import with_statement
+
+import ConfigParser
+import warnings
+
+import gobject
+import pango
+import gtk
+
+import gtk_toolbox
+import hildonize
+import null_backend
+
+
+def make_ugly(prettynumber):
+       """
+       function to take a phone number and strip out all non-numeric
+       characters
+
+       >>> make_ugly("+012-(345)-678-90")
+       '01234567890'
+       """
+       import re
+       uglynumber = re.sub('\D', '', prettynumber)
+       return uglynumber
+
+
+def make_pretty(phonenumber):
+       """
+       Function to take a phone number and return the pretty version
+       pretty numbers:
+               if phonenumber begins with 0:
+                       ...-(...)-...-....
+               if phonenumber begins with 1: ( for gizmo callback numbers )
+                       1 (...)-...-....
+               if phonenumber is 13 digits:
+                       (...)-...-....
+               if phonenumber is 10 digits:
+                       ...-....
+       >>> make_pretty("12")
+       '12'
+       >>> make_pretty("1234567")
+       '123-4567'
+       >>> make_pretty("2345678901")
+       '(234)-567-8901'
+       >>> make_pretty("12345678901")
+       '1 (234)-567-8901'
+       >>> make_pretty("01234567890")
+       '+012-(345)-678-90'
+       """
+       if phonenumber is None or phonenumber is "":
+               return ""
+
+       phonenumber = make_ugly(phonenumber)
+
+       if len(phonenumber) < 3:
+               return phonenumber
+
+       if phonenumber[0] == "0":
+               prettynumber = ""
+               prettynumber += "+%s" % phonenumber[0:3]
+               if 3 < len(phonenumber):
+                       prettynumber += "-(%s)" % phonenumber[3:6]
+                       if 6 < len(phonenumber):
+                               prettynumber += "-%s" % phonenumber[6:9]
+                               if 9 < len(phonenumber):
+                                       prettynumber += "-%s" % phonenumber[9:]
+               return prettynumber
+       elif len(phonenumber) <= 7:
+               prettynumber = "%s-%s" % (phonenumber[0:3], phonenumber[3:])
+       elif len(phonenumber) > 8 and phonenumber[0] == "1":
+               prettynumber = "1 (%s)-%s-%s" % (phonenumber[1:4], phonenumber[4:7], phonenumber[7:])
+       elif len(phonenumber) > 7:
+               prettynumber = "(%s)-%s-%s" % (phonenumber[0:3], phonenumber[3:6], phonenumber[6:])
+       return prettynumber
+
+
+class MergedAddressBook(object):
+       """
+       Merger of all addressbooks
+       """
+
+       def __init__(self, addressbookFactories, sorter = None):
+               self.__addressbookFactories = addressbookFactories
+               self.__addressbooks = None
+               self.__sort_contacts = sorter if sorter is not None else self.null_sorter
+
+       def clear_caches(self):
+               self.__addressbooks = None
+               for factory in self.__addressbookFactories:
+                       factory.clear_caches()
+
+       def get_addressbooks(self):
+               """
+               @returns Iterable of (Address Book Factory, Book Id, Book Name)
+               """
+               yield self, "", ""
+
+       def open_addressbook(self, bookId):
+               return self
+
+       def contact_source_short_name(self, contactId):
+               if self.__addressbooks is None:
+                       return ""
+               bookIndex, originalId = contactId.split("-", 1)
+               return self.__addressbooks[int(bookIndex)].contact_source_short_name(originalId)
+
+       @staticmethod
+       def factory_name():
+               return "All Contacts"
+
+       def get_contacts(self):
+               """
+               @returns Iterable of (contact id, contact name)
+               """
+               if self.__addressbooks is None:
+                       self.__addressbooks = list(
+                               factory.open_addressbook(id)
+                               for factory in self.__addressbookFactories
+                               for (f, id, name) in factory.get_addressbooks()
+                       )
+               contacts = (
+                       ("-".join([str(bookIndex), contactId]), contactName)
+                               for (bookIndex, addressbook) in enumerate(self.__addressbooks)
+                                       for (contactId, contactName) in addressbook.get_contacts()
+               )
+               sortedContacts = self.__sort_contacts(contacts)
+               return sortedContacts
+
+       def get_contact_details(self, contactId):
+               """
+               @returns Iterable of (Phone Type, Phone Number)
+               """
+               if self.__addressbooks is None:
+                       return []
+               bookIndex, originalId = contactId.split("-", 1)
+               return self.__addressbooks[int(bookIndex)].get_contact_details(originalId)
+
+       @staticmethod
+       def null_sorter(contacts):
+               """
+               Good for speed/low memory
+               """
+               return contacts
+
+       @staticmethod
+       def basic_firtname_sorter(contacts):
+               """
+               Expects names in "First Last" format
+               """
+               contactsWithKey = [
+                       (contactName.rsplit(" ", 1)[0], (contactId, contactName))
+                               for (contactId, contactName) in contacts
+               ]
+               contactsWithKey.sort()
+               return (contactData for (lastName, contactData) in contactsWithKey)
+
+       @staticmethod
+       def basic_lastname_sorter(contacts):
+               """
+               Expects names in "First Last" format
+               """
+               contactsWithKey = [
+                       (contactName.rsplit(" ", 1)[-1], (contactId, contactName))
+                               for (contactId, contactName) in contacts
+               ]
+               contactsWithKey.sort()
+               return (contactData for (lastName, contactData) in contactsWithKey)
+
+       @staticmethod
+       def reversed_firtname_sorter(contacts):
+               """
+               Expects names in "Last, First" format
+               """
+               contactsWithKey = [
+                       (contactName.split(", ", 1)[-1], (contactId, contactName))
+                               for (contactId, contactName) in contacts
+               ]
+               contactsWithKey.sort()
+               return (contactData for (lastName, contactData) in contactsWithKey)
+
+       @staticmethod
+       def reversed_lastname_sorter(contacts):
+               """
+               Expects names in "Last, First" format
+               """
+               contactsWithKey = [
+                       (contactName.split(", ", 1)[0], (contactId, contactName))
+                               for (contactId, contactName) in contacts
+               ]
+               contactsWithKey.sort()
+               return (contactData for (lastName, contactData) in contactsWithKey)
+
+       @staticmethod
+       def guess_firstname(name):
+               if ", " in name:
+                       return name.split(", ", 1)[-1]
+               else:
+                       return name.rsplit(" ", 1)[0]
+
+       @staticmethod
+       def guess_lastname(name):
+               if ", " in name:
+                       return name.split(", ", 1)[0]
+               else:
+                       return name.rsplit(" ", 1)[-1]
+
+       @classmethod
+       def advanced_firstname_sorter(cls, contacts):
+               contactsWithKey = [
+                       (cls.guess_firstname(contactName), (contactId, contactName))
+                               for (contactId, contactName) in contacts
+               ]
+               contactsWithKey.sort()
+               return (contactData for (lastName, contactData) in contactsWithKey)
+
+       @classmethod
+       def advanced_lastname_sorter(cls, contacts):
+               contactsWithKey = [
+                       (cls.guess_lastname(contactName), (contactId, contactName))
+                               for (contactId, contactName) in contacts
+               ]
+               contactsWithKey.sort()
+               return (contactData for (lastName, contactData) in contactsWithKey)
+
+
+class PhoneTypeSelector(object):
+
+       ACTION_CANCEL = "cancel"
+       ACTION_SELECT = "select"
+       ACTION_DIAL = "dial"
+       ACTION_SEND_SMS = "sms"
+
+       def __init__(self, widgetTree, gcBackend):
+               self._gcBackend = gcBackend
+               self._widgetTree = widgetTree
+
+               self._dialog = self._widgetTree.get_widget("phonetype_dialog")
+               self._smsDialog = SmsEntryDialog(self._widgetTree)
+
+               self._smsButton = self._widgetTree.get_widget("sms_button")
+               self._smsButton.connect("clicked", self._on_phonetype_send_sms)
+
+               self._dialButton = self._widgetTree.get_widget("dial_button")
+               self._dialButton.connect("clicked", self._on_phonetype_dial)
+
+               self._selectButton = self._widgetTree.get_widget("select_button")
+               self._selectButton.connect("clicked", self._on_phonetype_select)
+
+               self._cancelButton = self._widgetTree.get_widget("cancel_button")
+               self._cancelButton.connect("clicked", self._on_phonetype_cancel)
+
+               self._typemodel = gtk.ListStore(gobject.TYPE_STRING, gobject.TYPE_STRING)
+               self._typeviewselection = None
+
+               self._message = self._widgetTree.get_widget("phoneSelectionMessage")
+               self._messageViewport = self._widgetTree.get_widget("phoneSelectionMessage_viewport")
+               self._scrollWindow = self._widgetTree.get_widget("phoneSelectionMessage_scrolledwindow")
+               self._typeview = self._widgetTree.get_widget("phonetypes")
+               self._typeview.connect("row-activated", self._on_phonetype_select)
+
+               self._action = self.ACTION_CANCEL
+
+       def run(self, contactDetails, message = "", parent = None):
+               self._action = self.ACTION_CANCEL
+               self._typemodel.clear()
+               self._typeview.set_model(self._typemodel)
+
+               # Add the column to the treeview
+               textrenderer = gtk.CellRendererText()
+               numberColumn = gtk.TreeViewColumn("Phone Numbers", textrenderer, text=0)
+               self._typeview.append_column(numberColumn)
+
+               textrenderer = gtk.CellRendererText()
+               typeColumn = gtk.TreeViewColumn("Phone Type", textrenderer, text=1)
+               self._typeview.append_column(typeColumn)
+
+               self._typeviewselection = self._typeview.get_selection()
+               self._typeviewselection.set_mode(gtk.SELECTION_SINGLE)
+
+               for phoneType, phoneNumber in contactDetails:
+                       display = " - ".join((phoneNumber, phoneType))
+                       display = phoneType
+                       row = (phoneNumber, display)
+                       self._typemodel.append(row)
+
+               self._typeviewselection.select_iter(self._typemodel.get_iter_first())
+               if message:
+                       self._message.set_markup(message)
+                       self._message.show()
+               else:
+                       self._message.set_markup("")
+                       self._message.hide()
+
+               if parent is not None:
+                       self._dialog.set_transient_for(parent)
+
+               try:
+                       self._dialog.show()
+                       adjustment = self._scrollWindow.get_vadjustment()
+                       dx = self._message.get_allocation().height - self._messageViewport.get_allocation().height
+                       dx = max(dx, 0)
+                       adjustment.value = dx
+
+                       userResponse = self._dialog.run()
+               finally:
+                       self._dialog.hide()
+
+               if userResponse == gtk.RESPONSE_OK:
+                       phoneNumber = self._get_number()
+                       phoneNumber = make_ugly(phoneNumber)
+               else:
+                       phoneNumber = ""
+               if not phoneNumber:
+                       self._action = self.ACTION_CANCEL
+
+               if self._action == self.ACTION_SEND_SMS:
+                       smsMessage = self._smsDialog.run(phoneNumber, message, parent)
+                       if not smsMessage:
+                               phoneNumber = ""
+                               self._action = self.ACTION_CANCEL
+               else:
+                       smsMessage = ""
+
+               self._typeviewselection.unselect_all()
+               self._typeview.remove_column(numberColumn)
+               self._typeview.remove_column(typeColumn)
+               self._typeview.set_model(None)
+
+               return self._action, phoneNumber, smsMessage
+
+       def _get_number(self):
+               model, itr = self._typeviewselection.get_selected()
+               if not itr:
+                       return ""
+
+               phoneNumber = self._typemodel.get_value(itr, 0)
+               return phoneNumber
+
+       def _on_phonetype_dial(self, *args):
+               self._dialog.response(gtk.RESPONSE_OK)
+               self._action = self.ACTION_DIAL
+
+       def _on_phonetype_send_sms(self, *args):
+               self._dialog.response(gtk.RESPONSE_OK)
+               self._action = self.ACTION_SEND_SMS
+
+       def _on_phonetype_select(self, *args):
+               self._dialog.response(gtk.RESPONSE_OK)
+               self._action = self.ACTION_SELECT
+
+       def _on_phonetype_cancel(self, *args):
+               self._dialog.response(gtk.RESPONSE_CANCEL)
+               self._action = self.ACTION_CANCEL
+
+
+class SmsEntryDialog(object):
+
+       """
+       @todo Add multi-SMS messages like GoogleVoice
+       """
+
+       MAX_CHAR = 160
+
+       def __init__(self, widgetTree):
+               self._widgetTree = widgetTree
+               self._dialog = self._widgetTree.get_widget("smsDialog")
+
+               self._smsButton = self._widgetTree.get_widget("sendSmsButton")
+               self._smsButton.connect("clicked", self._on_send)
+
+               self._cancelButton = self._widgetTree.get_widget("cancelSmsButton")
+               self._cancelButton.connect("clicked", self._on_cancel)
+
+               self._letterCountLabel = self._widgetTree.get_widget("smsLetterCount")
+               self._message = self._widgetTree.get_widget("smsMessage")
+               self._messageViewport = self._widgetTree.get_widget("smsMessage_viewport")
+               self._scrollWindow = self._widgetTree.get_widget("smsMessage_scrolledwindow")
+               self._smsEntry = self._widgetTree.get_widget("smsEntry")
+               self._smsEntry.get_buffer().connect("changed", self._on_entry_changed)
+
+       def run(self, number, message = "", parent = None):
+               if message:
+                       self._message.set_markup(message)
+                       self._message.show()
+               else:
+                       self._message.set_markup("")
+                       self._message.hide()
+               self._smsEntry.get_buffer().set_text("")
+               self._update_letter_count()
+
+               if parent is not None:
+                       self._dialog.set_transient_for(parent)
+
+               try:
+                       self._dialog.show()
+                       adjustment = self._scrollWindow.get_vadjustment()
+                       dx = self._message.get_allocation().height - self._messageViewport.get_allocation().height
+                       dx = max(dx, 0)
+                       adjustment.value = dx
+
+                       userResponse = self._dialog.run()
+               finally:
+                       self._dialog.hide()
+
+               if userResponse == gtk.RESPONSE_OK:
+                       entryBuffer = self._smsEntry.get_buffer()
+                       enteredMessage = entryBuffer.get_text(entryBuffer.get_start_iter(), entryBuffer.get_end_iter())
+                       enteredMessage = enteredMessage[0:self.MAX_CHAR]
+               else:
+                       enteredMessage = ""
+
+               return enteredMessage.strip()
+
+       def _update_letter_count(self, *args):
+               entryLength = self._smsEntry.get_buffer().get_char_count()
+               charsLeft = self.MAX_CHAR - entryLength
+               self._letterCountLabel.set_text(str(charsLeft))
+               if charsLeft < 0:
+                       self._smsButton.set_sensitive(False)
+               else:
+                       self._smsButton.set_sensitive(True)
+
+       def _on_entry_changed(self, *args):
+               self._update_letter_count()
+
+       def _on_send(self, *args):
+               self._dialog.response(gtk.RESPONSE_OK)
+
+       def _on_cancel(self, *args):
+               self._dialog.response(gtk.RESPONSE_CANCEL)
+
+
+class Dialpad(object):
+
+       def __init__(self, widgetTree, errorDisplay):
+               self._errorDisplay = errorDisplay
+               self._smsDialog = SmsEntryDialog(widgetTree)
+
+               self._numberdisplay = widgetTree.get_widget("numberdisplay")
+               self._dialButton = widgetTree.get_widget("dial")
+               self._backButton = widgetTree.get_widget("back")
+               self._phonenumber = ""
+               self._prettynumber = ""
+
+               callbackMapping = {
+                       "on_dial_clicked": self._on_dial_clicked,
+                       "on_sms_clicked": self._on_sms_clicked,
+                       "on_digit_clicked": self._on_digit_clicked,
+                       "on_clear_number": self._on_clear_number,
+               }
+               widgetTree.signal_autoconnect(callbackMapping)
+
+               self._originalLabel = self._backButton.get_label()
+               self._backTapHandler = gtk_toolbox.TapOrHold(self._backButton)
+               self._backTapHandler.on_tap = self._on_backspace
+               self._backTapHandler.on_hold = self._on_clearall
+               self._backTapHandler.on_holding = self._set_clear_button
+               self._backTapHandler.on_cancel = self._reset_back_button
+
+               self._window = gtk_toolbox.find_parent_window(self._numberdisplay)
+
+       def enable(self):
+               self.set_number(self._phonenumber)
+               self._dialButton.grab_focus()
+               self._backTapHandler.enable()
+
+       def disable(self):
+               self._reset_back_button()
+               self._backTapHandler.disable()
+               self.set_number("")
+
+       def number_selected(self, action, number, message):
+               """
+               @note Actual dial function is patched in later
+               """
+               raise NotImplementedError("Horrible unknown error has occurred")
+
+       def get_number(self):
+               return self._phonenumber
+
+       def set_number(self, number):
+               """
+               Set the number to dial
+               """
+               try:
+                       self._phonenumber = make_ugly(number)
+                       self._prettynumber = make_pretty(self._phonenumber)
+                       self._numberdisplay.set_label("<span size='30000' weight='bold'>%s</span>" % (self._prettynumber))
+               except TypeError, e:
+                       self._errorDisplay.push_exception()
+
+       def clear(self):
+               self.set_number("")
+
+       @staticmethod
+       def name():
+               return "Dialpad"
+
+       def load_settings(self, config, section):
+               pass
+
+       def save_settings(self, config, section):
+               """
+               @note Thread Agnostic
+               """
+               pass
+
+       def _on_sms_clicked(self, widget):
+               action = PhoneTypeSelector.ACTION_SEND_SMS
+               phoneNumber = self.get_number()
+
+               message = self._smsDialog.run(phoneNumber, "", self._window)
+               if not message:
+                       phoneNumber = ""
+                       action = PhoneTypeSelector.ACTION_CANCEL
+
+               if action == PhoneTypeSelector.ACTION_CANCEL:
+                       return
+               self.number_selected(action, phoneNumber, message)
+
+       def _on_dial_clicked(self, widget):
+               action = PhoneTypeSelector.ACTION_DIAL
+               phoneNumber = self.get_number()
+               message = ""
+               self.number_selected(action, phoneNumber, message)
+
+       def _on_clear_number(self, *args):
+               self.clear()
+
+       def _on_digit_clicked(self, widget):
+               self.set_number(self._phonenumber + widget.get_name()[-1])
+
+       def _on_backspace(self, taps):
+               self.set_number(self._phonenumber[:-taps])
+               self._reset_back_button()
+
+       def _on_clearall(self, taps):
+               self.clear()
+               self._reset_back_button()
+               return False
+
+       def _set_clear_button(self):
+               self._backButton.set_label("gtk-clear")
+
+       def _reset_back_button(self):
+               self._backButton.set_label(self._originalLabel)
+
+
+class AccountInfo(object):
+
+       def __init__(self, widgetTree, backend, alarmHandler, errorDisplay):
+               self._errorDisplay = errorDisplay
+               self._backend = backend
+               self._isPopulated = False
+               self._alarmHandler = alarmHandler
+               self._notifyOnMissed = False
+               self._notifyOnVoicemail = False
+               self._notifyOnSms = False
+
+               self._callbackList = gtk.ListStore(gobject.TYPE_STRING)
+               self._accountViewNumberDisplay = widgetTree.get_widget("gcnumber_display")
+               self._callbackCombo = widgetTree.get_widget("callbackcombo")
+               self._onCallbackentryChangedId = 0
+
+               self._notifyCheckbox = widgetTree.get_widget("notifyCheckbox")
+               self._minutesEntry = widgetTree.get_widget("minutesEntry")
+               self._missedCheckbox = widgetTree.get_widget("missedCheckbox")
+               self._voicemailCheckbox = widgetTree.get_widget("voicemailCheckbox")
+               self._smsCheckbox = widgetTree.get_widget("smsCheckbox")
+               self._onNotifyToggled = 0
+               self._onMinutesChanged = 0
+               self._onMissedToggled = 0
+               self._onVoicemailToggled = 0
+               self._onSmsToggled = 0
+               self._applyAlarmTimeoutId = None
+
+               self._defaultCallback = ""
+
+       def enable(self):
+               assert self._backend.is_authed(), "Attempting to enable backend while not logged in"
+
+               self._accountViewNumberDisplay.set_use_markup(True)
+               self.set_account_number("")
+
+               self._callbackList.clear()
+               self._onCallbackentryChangedId = self._callbackCombo.get_child().connect("changed", self._on_callbackentry_changed)
+
+               if self._alarmHandler is not None:
+                       self._minutesEntry.set_range(1, 60)
+
+                       self._notifyCheckbox.set_active(self._alarmHandler.isEnabled)
+                       self._minutesEntry.set_value(self._alarmHandler.recurrence)
+                       self._missedCheckbox.set_active(self._notifyOnMissed)
+                       self._voicemailCheckbox.set_active(self._notifyOnVoicemail)
+                       self._smsCheckbox.set_active(self._notifyOnSms)
+
+                       self._onNotifyToggled = self._notifyCheckbox.connect("toggled", self._on_notify_toggled)
+                       self._onMinutesChanged = self._minutesEntry.connect("value-changed", self._on_minutes_changed)
+                       self._onMissedToggled = self._missedCheckbox.connect("toggled", self._on_missed_toggled)
+                       self._onVoicemailToggled = self._voicemailCheckbox.connect("toggled", self._on_voicemail_toggled)
+                       self._onSmsToggled = self._smsCheckbox.connect("toggled", self._on_sms_toggled)
+               else:
+                       self._notifyCheckbox.set_sensitive(False)
+                       self._minutesEntry.set_sensitive(False)
+                       self._missedCheckbox.set_sensitive(False)
+                       self._voicemailCheckbox.set_sensitive(False)
+                       self._smsCheckbox.set_sensitive(False)
+
+               self.update(force=True)
+
+       def disable(self):
+               self._callbackCombo.get_child().disconnect(self._onCallbackentryChangedId)
+               self._onCallbackentryChangedId = 0
+
+               if self._alarmHandler is not None:
+                       self._notifyCheckbox.disconnect(self._onNotifyToggled)
+                       self._minutesEntry.disconnect(self._onMinutesChanged)
+                       self._missedCheckbox.disconnect(self._onNotifyToggled)
+                       self._voicemailCheckbox.disconnect(self._onNotifyToggled)
+                       self._smsCheckbox.disconnect(self._onNotifyToggled)
+                       self._onNotifyToggled = 0
+                       self._onMinutesChanged = 0
+                       self._onMissedToggled = 0
+                       self._onVoicemailToggled = 0
+                       self._onSmsToggled = 0
+               else:
+                       self._notifyCheckbox.set_sensitive(True)
+                       self._minutesEntry.set_sensitive(True)
+                       self._missedCheckbox.set_sensitive(True)
+                       self._voicemailCheckbox.set_sensitive(True)
+                       self._smsCheckbox.set_sensitive(True)
+
+               self.clear()
+               self._callbackList.clear()
+
+       def get_selected_callback_number(self):
+               return make_ugly(self._callbackCombo.get_child().get_text())
+
+       def set_account_number(self, number):
+               """
+               Displays current account number
+               """
+               self._accountViewNumberDisplay.set_label("<span size='23000' weight='bold'>%s</span>" % (number))
+
+       def update(self, force = False):
+               if not force and self._isPopulated:
+                       return False
+               self._populate_callback_combo()
+               self.set_account_number(self._backend.get_account_number())
+               return True
+
+       def clear(self):
+               self._callbackCombo.get_child().set_text("")
+               self.set_account_number("")
+               self._isPopulated = False
+
+       def save_everything(self):
+               raise NotImplementedError
+
+       @staticmethod
+       def name():
+               return "Account Info"
+
+       def load_settings(self, config, section):
+               self._defaultCallback = config.get(section, "callback")
+               self._notifyOnMissed = config.getboolean(section, "notifyOnMissed")
+               self._notifyOnVoicemail = config.getboolean(section, "notifyOnVoicemail")
+               self._notifyOnSms = config.getboolean(section, "notifyOnSms")
+
+       def save_settings(self, config, section):
+               """
+               @note Thread Agnostic
+               """
+               callback = self.get_selected_callback_number()
+               config.set(section, "callback", callback)
+               config.set(section, "notifyOnMissed", repr(self._notifyOnMissed))
+               config.set(section, "notifyOnVoicemail", repr(self._notifyOnVoicemail))
+               config.set(section, "notifyOnSms", repr(self._notifyOnSms))
+
+       def _populate_callback_combo(self):
+               self._isPopulated = True
+               self._callbackList.clear()
+               try:
+                       callbackNumbers = self._backend.get_callback_numbers()
+               except StandardError, e:
+                       self._errorDisplay.push_exception()
+                       self._isPopulated = False
+                       return
+
+               for number, description in callbackNumbers.iteritems():
+                       self._callbackList.append((make_pretty(number),))
+
+               self._callbackCombo.set_model(self._callbackList)
+               self._callbackCombo.set_text_column(0)
+               #callbackNumber = self._backend.get_callback_number()
+               callbackNumber = self._defaultCallback
+               self._callbackCombo.get_child().set_text(make_pretty(callbackNumber))
+
+       def _set_callback_number(self, number):
+               try:
+                       if not self._backend.is_valid_syntax(number):
+                               self._errorDisplay.push_message("%s is not a valid callback number" % number)
+                       elif number == self._backend.get_callback_number():
+                               warnings.warn(
+                                       "Callback number already is %s" % (
+                                               self._backend.get_callback_number(),
+                                       ),
+                                       UserWarning,
+                                       2
+                               )
+                       else:
+                               self._backend.set_callback_number(number)
+                               assert make_ugly(number) == make_ugly(self._backend.get_callback_number()), "Callback number should be %s but instead is %s" % (
+                                       make_pretty(number), make_pretty(self._backend.get_callback_number())
+                               )
+                               warnings.warn(
+                                       "Callback number set to %s" % (
+                                               self._backend.get_callback_number(),
+                                       ),
+                                       UserWarning, 2
+                               )
+               except StandardError, e:
+                       self._errorDisplay.push_exception()
+
+       def _update_alarm_settings(self):
+               try:
+                       isEnabled = self._notifyCheckbox.get_active()
+                       recurrence = self._minutesEntry.get_value_as_int()
+                       if isEnabled != self._alarmHandler.isEnabled or recurrence != self._alarmHandler.recurrence:
+                               self._alarmHandler.apply_settings(isEnabled, recurrence)
+               finally:
+                       self.save_everything()
+                       self._notifyCheckbox.set_active(self._alarmHandler.isEnabled)
+                       self._minutesEntry.set_value(self._alarmHandler.recurrence)
+
+       def _on_callbackentry_changed(self, *args):
+               text = self.get_selected_callback_number()
+               number = make_ugly(text)
+               self._set_callback_number(number)
+
+       def _on_notify_toggled(self, *args):
+               if self._applyAlarmTimeoutId is not None:
+                       gobject.source_remove(self._applyAlarmTimeoutId)
+                       self._applyAlarmTimeoutId = None
+               self._applyAlarmTimeoutId = gobject.timeout_add(500, self._on_apply_timeout)
+
+       def _on_minutes_changed(self, *args):
+               if self._applyAlarmTimeoutId is not None:
+                       gobject.source_remove(self._applyAlarmTimeoutId)
+                       self._applyAlarmTimeoutId = None
+               self._applyAlarmTimeoutId = gobject.timeout_add(500, self._on_apply_timeout)
+
+       def _on_apply_timeout(self, *args):
+               self._applyAlarmTimeoutId = None
+
+               self._update_alarm_settings()
+               return False
+
+       def _on_missed_toggled(self, *args):
+               self._notifyOnMissed = self._missedCheckbox.get_active()
+               self.save_everything()
+
+       def _on_voicemail_toggled(self, *args):
+               self._notifyOnVoicemail = self._voicemailCheckbox.get_active()
+               self.save_everything()
+
+       def _on_sms_toggled(self, *args):
+               self._notifyOnSms = self._smsCheckbox.get_active()
+               self.save_everything()
+
+
+class RecentCallsView(object):
+
+       NUMBER_IDX = 0
+       DATE_IDX = 1
+       ACTION_IDX = 2
+       FROM_IDX = 3
+
+       def __init__(self, widgetTree, backend, errorDisplay):
+               self._errorDisplay = errorDisplay
+               self._backend = backend
+
+               self._isPopulated = False
+               self._recentmodel = gtk.ListStore(
+                       gobject.TYPE_STRING, # number
+                       gobject.TYPE_STRING, # date
+                       gobject.TYPE_STRING, # action
+                       gobject.TYPE_STRING, # from
+               )
+               self._recentview = widgetTree.get_widget("recentview")
+               self._recentviewselection = None
+               self._onRecentviewRowActivatedId = 0
+
+               textrenderer = gtk.CellRendererText()
+               textrenderer.set_property("yalign", 0)
+               hildonize.set_cell_thumb_selectable(textrenderer)
+               self._dateColumn = gtk.TreeViewColumn("Date")
+               self._dateColumn.pack_start(textrenderer, expand=True)
+               self._dateColumn.add_attribute(textrenderer, "text", self.DATE_IDX)
+
+               textrenderer = gtk.CellRendererText()
+               textrenderer.set_property("yalign", 0)
+               hildonize.set_cell_thumb_selectable(textrenderer)
+               self._actionColumn = gtk.TreeViewColumn("Action")
+               self._actionColumn.pack_start(textrenderer, expand=True)
+               self._actionColumn.add_attribute(textrenderer, "text", self.ACTION_IDX)
+
+               textrenderer = gtk.CellRendererText()
+               textrenderer.set_property("yalign", 0)
+               hildonize.set_cell_thumb_selectable(textrenderer)
+               self._nameColumn = gtk.TreeViewColumn("From")
+               self._nameColumn.pack_start(textrenderer, expand=True)
+               self._nameColumn.add_attribute(textrenderer, "text", self.FROM_IDX)
+               self._nameColumn.set_sizing(gtk.TREE_VIEW_COLUMN_FIXED)
+
+               textrenderer = gtk.CellRendererText()
+               textrenderer.set_property("yalign", 0)
+               hildonize.set_cell_thumb_selectable(textrenderer)
+               self._numberColumn = gtk.TreeViewColumn("Number")
+               self._numberColumn.pack_start(textrenderer, expand=True)
+               self._numberColumn.add_attribute(textrenderer, "text", self.NUMBER_IDX)
+
+               self._window = gtk_toolbox.find_parent_window(self._recentview)
+               self._phoneTypeSelector = PhoneTypeSelector(widgetTree, self._backend)
+
+               self._updateSink = gtk_toolbox.threaded_stage(
+                       gtk_toolbox.comap(
+                               self._idly_populate_recentview,
+                               gtk_toolbox.null_sink(),
+                       )
+               )
+
+       def enable(self):
+               assert self._backend.is_authed(), "Attempting to enable backend while not logged in"
+               self._recentview.set_model(self._recentmodel)
+
+               self._recentview.append_column(self._dateColumn)
+               self._recentview.append_column(self._actionColumn)
+               self._recentview.append_column(self._numberColumn)
+               self._recentview.append_column(self._nameColumn)
+               self._recentviewselection = self._recentview.get_selection()
+               self._recentviewselection.set_mode(gtk.SELECTION_SINGLE)
+
+               self._onRecentviewRowActivatedId = self._recentview.connect("row-activated", self._on_recentview_row_activated)
+
+       def disable(self):
+               self._recentview.disconnect(self._onRecentviewRowActivatedId)
+
+               self.clear()
+
+               self._recentview.remove_column(self._dateColumn)
+               self._recentview.remove_column(self._actionColumn)
+               self._recentview.remove_column(self._nameColumn)
+               self._recentview.remove_column(self._numberColumn)
+               self._recentview.set_model(None)
+
+       def number_selected(self, action, number, message):
+               """
+               @note Actual dial function is patched in later
+               """
+               raise NotImplementedError("Horrible unknown error has occurred")
+
+       def update(self, force = False):
+               if not force and self._isPopulated:
+                       return False
+               self._updateSink.send(())
+               return True
+
+       def clear(self):
+               self._isPopulated = False
+               self._recentmodel.clear()
+
+       @staticmethod
+       def name():
+               return "Recent Calls"
+
+       def load_settings(self, config, section):
+               pass
+
+       def save_settings(self, config, section):
+               """
+               @note Thread Agnostic
+               """
+               pass
+
+       def _idly_populate_recentview(self):
+               self._recentmodel.clear()
+               self._isPopulated = True
+
+               try:
+                       recentItems = self._backend.get_recent()
+               except StandardError, e:
+                       self._errorDisplay.push_exception_with_lock()
+                       self._isPopulated = False
+                       recentItems = []
+
+               for personName, phoneNumber, date, action in recentItems:
+                       if not personName:
+                               personName = "Unknown"
+                       prettyNumber = phoneNumber[2:] if phoneNumber.startswith("+1") else phoneNumber
+                       prettyNumber = make_pretty(prettyNumber)
+                       item = (prettyNumber, date, action.capitalize(), personName)
+                       with gtk_toolbox.gtk_lock():
+                               self._recentmodel.append(item)
+
+               return False
+
+       def _on_recentview_row_activated(self, treeview, path, view_column):
+               model, itr = self._recentviewselection.get_selected()
+               if not itr:
+                       return
+
+               number = self._recentmodel.get_value(itr, self.NUMBER_IDX)
+               number = make_ugly(number)
+               contactPhoneNumbers = [("Phone", number)]
+               description = self._recentmodel.get_value(itr, self.FROM_IDX)
+
+               action, phoneNumber, message = self._phoneTypeSelector.run(
+                       contactPhoneNumbers,
+                       message = description,
+                       parent = self._window,
+               )
+               if action == PhoneTypeSelector.ACTION_CANCEL:
+                       return
+               assert phoneNumber, "A lack of phone number exists"
+
+               self.number_selected(action, phoneNumber, message)
+               self._recentviewselection.unselect_all()
+
+
+class MessagesView(object):
+
+       NUMBER_IDX = 0
+       DATE_IDX = 1
+       HEADER_IDX = 2
+       MESSAGE_IDX = 3
+
+       def __init__(self, widgetTree, backend, errorDisplay):
+               self._errorDisplay = errorDisplay
+               self._backend = backend
+
+               self._isPopulated = False
+               self._messagemodel = gtk.ListStore(
+                       gobject.TYPE_STRING, # number
+                       gobject.TYPE_STRING, # date
+                       gobject.TYPE_STRING, # header
+                       gobject.TYPE_STRING, # message
+               )
+               self._messageview = widgetTree.get_widget("messages_view")
+               self._messageviewselection = None
+               self._onMessageviewRowActivatedId = 0
+
+               self._messageRenderer = gtk.CellRendererText()
+               hildonize.set_cell_thumb_selectable(self._messageRenderer)
+               self._messageRenderer.set_property("wrap-mode", pango.WRAP_WORD)
+               self._messageRenderer.set_property("wrap-width", 650)
+               self._messageColumn = gtk.TreeViewColumn("Messages")
+               self._messageColumn.pack_start(self._messageRenderer, expand=True)
+               self._messageColumn.add_attribute(self._messageRenderer, "markup", self.MESSAGE_IDX)
+               self._messageColumn.set_sizing(gtk.TREE_VIEW_COLUMN_FIXED)
+
+               self._window = gtk_toolbox.find_parent_window(self._messageview)
+               self._phoneTypeSelector = PhoneTypeSelector(widgetTree, self._backend)
+
+               self._updateSink = gtk_toolbox.threaded_stage(
+                       gtk_toolbox.comap(
+                               self._idly_populate_messageview,
+                               gtk_toolbox.null_sink(),
+                       )
+               )
+
+       def enable(self):
+               assert self._backend.is_authed(), "Attempting to enable backend while not logged in"
+               self._messageview.set_model(self._messagemodel)
+
+               self._messageview.append_column(self._messageColumn)
+               self._messageviewselection = self._messageview.get_selection()
+               self._messageviewselection.set_mode(gtk.SELECTION_SINGLE)
+
+               self._onMessageviewRowActivatedId = self._messageview.connect("row-activated", self._on_messageview_row_activated)
+
+       def disable(self):
+               self._messageview.disconnect(self._onMessageviewRowActivatedId)
+
+               self.clear()
+
+               self._messageview.remove_column(self._messageColumn)
+               self._messageview.set_model(None)
+
+       def number_selected(self, action, number, message):
+               """
+               @note Actual dial function is patched in later
+               """
+               raise NotImplementedError("Horrible unknown error has occurred")
+
+       def update(self, force = False):
+               if not force and self._isPopulated:
+                       return False
+               self._updateSink.send(())
+               return True
+
+       def clear(self):
+               self._isPopulated = False
+               self._messagemodel.clear()
+
+       @staticmethod
+       def name():
+               return "Messages"
+
+       def load_settings(self, config, section):
+               pass
+
+       def save_settings(self, config, section):
+               """
+               @note Thread Agnostic
+               """
+               pass
+
+       def _idly_populate_messageview(self):
+               self._messagemodel.clear()
+               self._isPopulated = True
+
+               try:
+                       messageItems = self._backend.get_messages()
+               except StandardError, e:
+                       self._errorDisplay.push_exception_with_lock()
+                       self._isPopulated = False
+                       messageItems = []
+
+               for header, number, relativeDate, message in messageItems:
+                       prettyNumber = number[2:] if number.startswith("+1") else number
+                       prettyNumber = make_pretty(prettyNumber)
+                       message = "<b>%s - %s</b> <i>(%s)</i>\n\n%s" % (header, prettyNumber, relativeDate, message)
+                       number = make_ugly(number)
+                       row = (number, relativeDate, header, message)
+                       with gtk_toolbox.gtk_lock():
+                               self._messagemodel.append(row)
+
+               return False
+
+       def _on_messageview_row_activated(self, treeview, path, view_column):
+               model, itr = self._messageviewselection.get_selected()
+               if not itr:
+                       return
+
+               contactPhoneNumbers = [("Phone", self._messagemodel.get_value(itr, self.NUMBER_IDX))]
+               description = self._messagemodel.get_value(itr, self.MESSAGE_IDX)
+
+               action, phoneNumber, message = self._phoneTypeSelector.run(
+                       contactPhoneNumbers,
+                       message = description,
+                       parent = self._window,
+               )
+               if action == PhoneTypeSelector.ACTION_CANCEL:
+                       return
+               assert phoneNumber, "A lock of phone number exists"
+
+               self.number_selected(action, phoneNumber, message)
+               self._messageviewselection.unselect_all()
+
+
+class ContactsView(object):
+
+       def __init__(self, widgetTree, backend, errorDisplay):
+               self._errorDisplay = errorDisplay
+               self._backend = backend
+
+               self._addressBook = None
+               self._selectedComboIndex = 0
+               self._addressBookFactories = [null_backend.NullAddressBook()]
+
+               self._booksList = gtk.ListStore(gobject.TYPE_STRING, gobject.TYPE_STRING, gobject.TYPE_STRING)
+               self._booksSelectionBox = widgetTree.get_widget("addressbook_combo")
+
+               self._isPopulated = False
+               self._contactsmodel = gtk.ListStore(gobject.TYPE_STRING, gobject.TYPE_STRING, gobject.TYPE_STRING, gobject.TYPE_STRING, gobject.TYPE_STRING)
+               self._contactsviewselection = None
+               self._contactsview = widgetTree.get_widget("contactsview")
+
+               self._contactColumn = gtk.TreeViewColumn("Contact")
+               displayContactSource = False
+               if displayContactSource:
+                       textrenderer = gtk.CellRendererText()
+                       self._contactColumn.pack_start(textrenderer, expand=False)
+                       self._contactColumn.add_attribute(textrenderer, 'text', 0)
+               textrenderer = gtk.CellRendererText()
+               hildonize.set_cell_thumb_selectable(textrenderer)
+               self._contactColumn.pack_start(textrenderer, expand=True)
+               self._contactColumn.add_attribute(textrenderer, 'text', 1)
+               textrenderer = gtk.CellRendererText()
+               self._contactColumn.pack_start(textrenderer, expand=True)
+               self._contactColumn.add_attribute(textrenderer, 'text', 4)
+               self._contactColumn.set_sizing(gtk.TREE_VIEW_COLUMN_FIXED)
+               self._contactColumn.set_sort_column_id(1)
+               self._contactColumn.set_visible(True)
+
+               self._onContactsviewRowActivatedId = 0
+               self._onAddressbookComboChangedId = 0
+               self._window = gtk_toolbox.find_parent_window(self._contactsview)
+               self._phoneTypeSelector = PhoneTypeSelector(widgetTree, self._backend)
+
+               self._updateSink = gtk_toolbox.threaded_stage(
+                       gtk_toolbox.comap(
+                               self._idly_populate_contactsview,
+                               gtk_toolbox.null_sink(),
+                       )
+               )
+
+       def enable(self):
+               assert self._backend.is_authed(), "Attempting to enable backend while not logged in"
+
+               self._contactsview.set_model(self._contactsmodel)
+               self._contactsview.append_column(self._contactColumn)
+               self._contactsviewselection = self._contactsview.get_selection()
+               self._contactsviewselection.set_mode(gtk.SELECTION_SINGLE)
+
+               self._booksList.clear()
+               for (factoryId, bookId), (factoryName, bookName) in self.get_addressbooks():
+                       if factoryName and bookName:
+                               entryName = "%s: %s" % (factoryName, bookName)
+                       elif factoryName:
+                               entryName = factoryName
+                       elif bookName:
+                               entryName = bookName
+                       else:
+                               entryName = "Bad name (%d)" % factoryId
+                       row = (str(factoryId), bookId, entryName)
+                       self._booksList.append(row)
+
+               self._booksSelectionBox.set_model(self._booksList)
+               cell = gtk.CellRendererText()
+               self._booksSelectionBox.pack_start(cell, True)
+               self._booksSelectionBox.add_attribute(cell, 'text', 2)
+
+               self._onContactsviewRowActivatedId = self._contactsview.connect("row-activated", self._on_contactsview_row_activated)
+               self._onAddressbookComboChangedId = self._booksSelectionBox.connect("changed", self._on_addressbook_combo_changed)
+
+               if len(self._booksList) <= self._selectedComboIndex:
+                       self._selectedComboIndex = 0
+               self._booksSelectionBox.set_active(self._selectedComboIndex)
+
+       def disable(self):
+               self._contactsview.disconnect(self._onContactsviewRowActivatedId)
+               self._booksSelectionBox.disconnect(self._onAddressbookComboChangedId)
+
+               self.clear()
+
+               self._booksSelectionBox.clear()
+               self._booksSelectionBox.set_model(None)
+               self._contactsview.set_model(None)
+               self._contactsview.remove_column(self._contactColumn)
+
+       def number_selected(self, action, number, message):
+               """
+               @note Actual dial function is patched in later
+               """
+               raise NotImplementedError("Horrible unknown error has occurred")
+
+       def get_addressbooks(self):
+               """
+               @returns Iterable of ((Factory Id, Book Id), (Factory Name, Book Name))
+               """
+               for i, factory in enumerate(self._addressBookFactories):
+                       for bookFactory, bookId, bookName in factory.get_addressbooks():
+                               yield (str(i), bookId), (factory.factory_name(), bookName)
+
+       def open_addressbook(self, bookFactoryId, bookId):
+               bookFactoryIndex = int(bookFactoryId)
+               addressBook = self._addressBookFactories[bookFactoryIndex].open_addressbook(bookId)
+
+               forceUpdate = True if addressBook is not self._addressBook else False
+
+               self._addressBook = addressBook
+               self.update(force=forceUpdate)
+
+       def update(self, force = False):
+               if not force and self._isPopulated:
+                       return False
+               self._updateSink.send(())
+               return True
+
+       def clear(self):
+               self._isPopulated = False
+               self._contactsmodel.clear()
+               for factory in self._addressBookFactories:
+                       factory.clear_caches()
+               self._addressBook.clear_caches()
+
+       def append(self, book):
+               self._addressBookFactories.append(book)
+
+       def extend(self, books):
+               self._addressBookFactories.extend(books)
+
+       @staticmethod
+       def name():
+               return "Contacts"
+
+       def load_settings(self, config, sectionName):
+               try:
+                       self._selectedComboIndex = config.getint(sectionName, "selectedAddressbook")
+               except ConfigParser.NoOptionError:
+                       self._selectedComboIndex = 0
+
+       def save_settings(self, config, sectionName):
+               config.set(sectionName, "selectedAddressbook", str(self._selectedComboIndex))
+
+       def _idly_populate_contactsview(self):
+               addressBook = None
+               while addressBook is not self._addressBook:
+                       addressBook = self._addressBook
+                       with gtk_toolbox.gtk_lock():
+                               self._contactsview.set_model(None)
+                               self.clear()
+
+                       try:
+                               contacts = addressBook.get_contacts()
+                       except StandardError, e:
+                               contacts = []
+                               self._isPopulated = False
+                               self._errorDisplay.push_exception_with_lock()
+                       for contactId, contactName in contacts:
+                               contactType = (addressBook.contact_source_short_name(contactId), )
+                               self._contactsmodel.append(contactType + (contactName, "", contactId) + ("", ))
+
+                       with gtk_toolbox.gtk_lock():
+                               self._contactsview.set_model(self._contactsmodel)
+
+               self._isPopulated = True
+               return False
+
+       def _on_addressbook_combo_changed(self, *args, **kwds):
+               itr = self._booksSelectionBox.get_active_iter()
+               if itr is None:
+                       return
+               self._selectedComboIndex = self._booksSelectionBox.get_active()
+               selectedFactoryId = self._booksList.get_value(itr, 0)
+               selectedBookId = self._booksList.get_value(itr, 1)
+               self.open_addressbook(selectedFactoryId, selectedBookId)
+
+       def _on_contactsview_row_activated(self, treeview, path, view_column):
+               model, itr = self._contactsviewselection.get_selected()
+               if not itr:
+                       return
+
+               contactId = self._contactsmodel.get_value(itr, 3)
+               contactName = self._contactsmodel.get_value(itr, 1)
+               try:
+                       contactDetails = self._addressBook.get_contact_details(contactId)
+               except StandardError, e:
+                       contactDetails = []
+                       self._errorDisplay.push_exception()
+               contactPhoneNumbers = [phoneNumber for phoneNumber in contactDetails]
+
+               if len(contactPhoneNumbers) == 0:
+                       return
+
+               action, phoneNumber, message = self._phoneTypeSelector.run(
+                       contactPhoneNumbers,
+                       message = contactName,
+                       parent = self._window,
+               )
+               if action == PhoneTypeSelector.ACTION_CANCEL:
+                       return
+               assert phoneNumber, "A lack of phone number exists"
+
+               self.number_selected(action, phoneNumber, message)
+               self._contactsviewselection.unselect_all()