git.maemo.org Git - gc-dialer/blob - src/evo_backend.py

   1 #!/usr/bin/python
   2
   3 # GC Dialer - Front end for Google's Grand Central service.
   4 # Copyright (C) 2008  Eric Warnke ericew AT gmail DOT com
   5 #
   6 # This library is free software; you can redistribute it and/or
   7 # modify it under the terms of the GNU Lesser General Public
   8 # License as published by the Free Software Foundation; either
   9 # version 2.1 of the License, or (at your option) any later version.
  10 #
  11 # This library is distributed in the hope that it will be useful,
  12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 # Lesser General Public License for more details.
  15 #
  16 # You should have received a copy of the GNU Lesser General Public
  17 # License along with this library; if not, write to the Free Software
  18 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  19
  20
  21 """
  22 Evolution Contact Support
  23 """
  24
  25
  26 try:
  27         import evolution
  28 except ImportError:
  29         evolution = None
  30
  31
  32 class EvolutionAddressBook(object):
  33         """
  34         @note Combined the factory and the addressbook for "simplicity" and "cutting down" the number of allocations/deallocations
  35         """
  36
  37         def __init__(self, bookId = None):
  38                 if not self.is_supported():
  39                         return
  40
  41                 self._phoneTypes = None
  42                 self._bookId = bookId if bookId is not None else self.get_addressbooks().next()[1]
  43                 self._book = evolution.ebook.open_addressbook(self._bookId)
  44
  45         @classmethod
  46         def is_supported(cls):
  47                 return evolution is not None
  48
  49         def get_addressbooks(self):
  50                 """
  51                 @returns Iterable of (Address Book Factory, Book Id, Book Name)
  52                 """
  53                 if not self.is_supported():
  54                         return
  55
  56                 for bookId in evolution.ebook.list_addressbooks():
  57                         yield self, bookId[1], bookId[0]
  58
  59         def open_addressbook(self, bookId):
  60                 self._bookId = bookId
  61                 self._book = evolution.ebook.open_addressbook(self._bookId)
  62                 return self
  63
  64         @staticmethod
  65         def factory_short_name():
  66                 return "Evo"
  67
  68         @staticmethod
  69         def factory_name():
  70                 return "Evolution"
  71
  72         def get_contacts(self):
  73                 """
  74                 @returns Iterable of (contact id, contact name)
  75                 """
  76                 if not self.is_supported():
  77                         return
  78
  79                 for contact in self._book.get_all_contacts():
  80                         yield contact.get_uid(), contact.props.full_name
  81
  82         def get_contact_details(self, contactId):
  83                 """
  84                 @returns Iterable of (Phone Type, Phone Number)
  85                 """
  86                 contact = self._book.get_contact(contactId)
  87
  88                 if self._phoneTypes is None and contact is not None:
  89                         self._phoneTypes = [pt for pt in dir(contact.props) if "phone" in pt.lower()]
  90
  91                 for phoneType in self._phoneTypes:
  92                         phoneNumber = getattr(contact.props, phoneType)
  93                         if isinstance(phoneNumber, str):
  94                                 yield phoneType, phoneNumber
  95
  96 def print_addressbooks():
  97         """
  98         Included here for debugging.
  99
 100         Either insert it into the code or launch python with the "-i" flag
 101         """
 102         if not EvolutionAddressBook.is_supported():
 103                 print "No Evolution Support"
 104                 return
 105
 106         eab = EvolutionAddressBook()
 107         for book in eab.get_addressbooks():
 108                 eab = eab.open_addressbook(book[1])
 109                 print book
 110                 for contact in eab.get_contacts():
 111                         print "\t", contact
 112                         for details in eab.get_contact_details(contact[0]):
 113                                 print "\t\t", details