code.delx.au - offlineimap/blob - head/offlineimap/imapserver.py

   1 # IMAP server support
   2 # Copyright (C) 2002 John Goerzen
   3 # <jgoerzen@complete.org>
   4 #
   5 #    This program is free software; you can redistribute it and/or modify
   6 #    it under the terms of the GNU General Public License as published by
   7 #    the Free Software Foundation; either version 2 of the License, or
   8 #    (at your option) any later version.
   9 #
  10 #    This program is distributed in the hope that it will be useful,
  11 #    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 #    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 #    GNU General Public License for more details.
  14 #
  15 #    You should have received a copy of the GNU General Public License
  16 #    along with this program; if not, write to the Free Software
  17 #    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  18
  19 from imapsync import imaplib, imaputil
  20
  21 class IMAPServer:
  22     def __init__(self, username, password, hostname, port = None, ssl = 1):
  23         self.username = username
  24         self.password = password
  25         self.hostname = hostname
  26         self.port = port
  27         self.usessl = ssl
  28         self.delim = None
  29         self.root = None
  30         if port == None:
  31             if ssl:
  32                 self.port = 993
  33             else:
  34                 self.port = 143
  35
  36     def getdelim(self):
  37         """Returns this server's folder delimiter.  Can only be called
  38         after one or more calls to makeconnection."""
  39         return self.delim
  40
  41     def getroot(self):
  42         """Returns this server's folder root.  Can only be called after one
  43         or more calls to makeconnection."""
  44         return self.root
  45
  46     def makeconnection(self):
  47         """Opens a connection to the server and returns an appropriate
  48         object."""
  49
  50         imapobj = None
  51         if self.usessl:
  52             imapobj = imaplib.IMAP4_SSL(self.hostname, self.port)
  53         else:
  54             imapobj = imaplib.IMAP4(self.hostname, self.port)
  55
  56         imapobj.login(self.username, self.password)
  57
  58         if self.delim == None:
  59             self.delim, self.root = \
  60                         imaputil.imapsplit(imapobj.list('""', '""')[1][0])[1:]
  61
  62         return imapobj
  63
  64