Ñò
§ÚêLc @ s~ d Z d d k l Z e d d d ƒ[ d Z d Z d Z d Z d d
k Z d d
k Z d d
k Z d d
k
Z
d d
k Z d d
k Z d d k
l
Z
d d
d d g Z d
e f d „ ƒ YZ d f d „ ƒ YZ e i d ƒ Z d „ Z d f d „ ƒ YZ d e
i f d „ ƒ YZ d e f d „ ƒ YZ d f d „ ƒ YZ d d „ Z d d „ Z d „ Z e d j o e ƒ n d
S( sŸ MH interface -- purely object-oriented (well, almost)
Executive summary:
import mhlib
mh = mhlib.MH() # use default mailbox directory and profile
mh = mhlib.MH(mailbox) # override mailbox location (default from profile)
mh = mhlib.MH(mailbox, profile) # override mailbox and profile
mh.error(format, ...) # print error message -- can be overridden
s = mh.getprofile(key) # profile entry (None if not set)
path = mh.getpath() # mailbox pathname
name = mh.getcontext() # name of current folder
mh.setcontext(name) # set name of current folder
list = mh.listfolders() # names of top-level folders
list = mh.listallfolders() # names of all folders, including subfolders
list = mh.listsubfolders(name) # direct subfolders of given folder
list = mh.listallsubfolders(name) # all subfolders of given folder
mh.makefolder(name) # create new folder
mh.deletefolder(name) # delete folder -- must have no subfolders
f = mh.openfolder(name) # new open folder object
f.error(format, ...) # same as mh.error(format, ...)
path = f.getfullname() # folder's full pathname
path = f.getsequencesfilename() # full pathname of folder's sequences file
path = f.getmessagefilename(n) # full pathname of message n in folder
list = f.listmessages() # list of messages in folder (as numbers)
n = f.getcurrent() # get current message
f.setcurrent(n) # set current message
list = f.parsesequence(seq) # parse msgs syntax into list of messages
n = f.getlast() # get last message (0 if no messagse)
f.setlast(n) # set last message (internal use only)
dict = f.getsequences() # dictionary of sequences in folder {name: list}
f.putsequences(dict) # write sequences back to folder
f.createmessage(n, fp) # add message from file f as number n
f.removemessages(list) # remove messages in list from folder
f.refilemessages(list, tofolder) # move messages in list to other folder
f.movemessage(n, tofolder, ton) # move one message to a given destination
f.copymessage(n, tofolder, ton) # copy one message to a given destination
m = f.openmessage(n) # new open message object (costs a file descriptor)
m is a derived class of mimetools.Message(rfc822.Message), with:
s = m.getheadertext() # text of message's headers
s = m.getheadertext(pred) # text of message's headers, filtered by pred
s = m.getbodytext() # text of message's body, decoded
s = m.getbodytext(0) # text of message's body, not decoded
iÿÿÿÿ( t warnpy3ksO the mhlib module has been removed in Python 3.0; use the mailbox module insteadt
stackleveli s
~/.mh_profiles ~/Mails
.mh_sequencesiÀ N( t bisectt MHt Errort Foldert Messagec B s e Z RS( ( t __name__t
__module__( ( ( s /usr/lib64/python2.6/mhlib.pyR [ s c B s’ e Z d Z d d d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z
d „ Z d „ Z d
„ Z
d „ Z d „ Z d
„ Z d „ Z RS( s< Class representing a particular collection of folders.
Optional constructor arguments are the pathname for the directory
containing the collection, and the MH profile to use.
If either is omitted or empty a default is used; the default
directory is taken from the MH profile if it is specified there.c C sÚ | d j o
t } n t i i | ƒ | _ | d j o | i d ƒ } n | p
t } n t i i | ƒ o* | d d j o t i i d | ƒ } n t i i | ƒ } t i i
| ƒ p
t d ‚ n | | _ d S( s Constructor.t Pathi t ~s MH() path not foundN( t Nonet
MH_PROFILEt ost patht
expandusert profilet
getprofilet PATHt isabst joint isdirR ( t selfR R ( ( s /usr/lib64/python2.6/mhlib.pyt __init__f s
%
c C s d | i | i f S( s String representation.s
MH(%r, %r)( R R ( R ( ( s /usr/lib64/python2.6/mhlib.pyt __repr__r s c G s t i i d | | ƒ d S( sA Routine to print an error. May be overridden by a derived class.s
MH error: %s
N( t syst stderrt write( R t msgt args( ( s /usr/lib64/python2.6/mhlib.pyt errorv s c C s t | i | ƒ S( s* Return a profile entry, None if not found.( t picklineR ( R t key( ( s /usr/lib64/python2.6/mhlib.pyR z s c C s | i S( s9 Return the path (the name of the collection's directory).( R ( R ( ( s /usr/lib64/python2.6/mhlib.pyt getpath~ s c C s9 t t i i | i ƒ d ƒ d ƒ } | p
d } n | S( s& Return the name of the current folder.t contexts Current-Foldert inbox( R R
R R R! ( R R" ( ( s /usr/lib64/python2.6/mhlib.pyt
getcontext‚ s
c C sI t i i | i ƒ d ƒ } t | d ƒ } | i d | ƒ | i ƒ d S( s# Set the name of the current folder.R" t ws Current-Folder: %s
N( R
R R R! t openR t close( R R" t fnt f( ( s /usr/lib64/python2.6/mhlib.pyt
setcontext‰ s c C ss g } | i ƒ } xP t i | ƒ D]? } t i i | | ƒ } t i i | ƒ o | i | ƒ q" q" W| i ƒ | S( s* Return the names of the top-level folders.( R! R
t listdirR R R t appendt sort( R t foldersR t namet fullname( ( s /usr/lib64/python2.6/mhlib.pyt listfolders s
c C sÚ t i i | i | ƒ } t i | ƒ i } | d j o g Sg } t i | ƒ } xx | D]p } t i i | | ƒ } t i i | ƒ oB t i i | | ƒ } | i | ƒ | d } | d j o PqÈ qX qX W| i ƒ | S( sc Return the names of the subfolders in a given folder
(prefixed with the given folder name).i i ( R
R R t statt st_nlinkR+ R R, R- ( R R/ R0 t nlinkst
subfolderst subnamest subnamet fullsubnamet name_subname( ( s /usr/lib64/python2.6/mhlib.pyt listsubfolders› s"
c C s
| i d ƒ S( s< Return the names of all folders and subfolders, recursively.t ( t listallsubfolders( R ( ( s /usr/lib64/python2.6/mhlib.pyt listallfolders³ s c
C s/ t i i | i | ƒ } t i | ƒ i } | d j o g Sg } t i | ƒ } xÍ | D]Å } | d d j p
t | ƒ o qX n t i i | | ƒ } t i i | ƒ or t i i | | ƒ } | i | ƒ t i i | ƒ p | i
| ƒ } | | } n | d } | d j o Pq qX qX W| i ƒ | S( s> Return the names of subfolders in a given folder, recursively.i i t ,i ( R
R R R2 R3 R+ t isnumericR R, t islinkR< R- (
R R/ R0 R4 R5 R6 R7 R8 R9 t
subsubfolders( ( s /usr/lib64/python2.6/mhlib.pyR< · s.
c C s
t | | ƒ S( s0 Return a new Folder object for the named folder.( R ( R R/ ( ( s /usr/lib64/python2.6/mhlib.pyt
openfolderÓ s c C sh t | i d ƒ } | o t | ƒ o t | d ƒ } n t } t i t i i | i ƒ | ƒ | ƒ d S( s@ Create a new folder (or raise os.error if it cannot be created).s Folder-Protecti N(
R R R? t intt FOLDER_PROTECTR
t mkdirR R R! ( R R/ t protectt mode( ( s /usr/lib64/python2.6/mhlib.pyt
makefolder× s
c C s– t i i | i ƒ | ƒ } xg t i | ƒ D]V } t i i | | ƒ } y t i | ƒ Wq+ t i j
o | i d | ƒ q+ Xq+ Wt i | ƒ d S( s‡ Delete a folder. This removes files in the folder but not
subdirectories. Raise os.error if deleting the folder itself fails.s %s not deleted, continuing...N( R
R R R! R+ t unlinkR t rmdir( R R/ R0 R7 R8 ( ( s /usr/lib64/python2.6/mhlib.pyt deletefolderà s N( R R t __doc__R R R R R R! R$ R* R1 R: R= R< RB RH RK ( ( ( s /usr/lib64/python2.6/mhlib.pyR _ s s
^[1-9][0-9]*$c C s t i | ƒ d j S( N( t numericprogt matchR ( t str( ( s /usr/lib64/python2.6/mhlib.pyR? ï s c B sò e Z d Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z
d „ Z d
„ Z d „ Z
d „ Z d
„ Z d „ Z d „ Z d „ Z d „ Z d d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z RS( s' Class representing a particular folder.c C s@ | | _ | | _ t i i | i ƒ ƒ p t d | ‚ n d S( s Constructor.s no folder %sN( t mhR/ R
R R t getfullnameR ( R RP R/ ( ( s /usr/lib64/python2.6/mhlib.pyR õ s c C s d | i | i f S( s String representation.s Folder(%r, %r)( RP R/ ( R ( ( s /usr/lib64/python2.6/mhlib.pyR ü s c G s | i i | Œ d S( s Error message handler.N( RP R ( R R ( ( s /usr/lib64/python2.6/mhlib.pyR s c C s t i i | i i | i ƒ S( s' Return the full pathname of the folder.( R
R R RP R/ ( R ( ( s /usr/lib64/python2.6/mhlib.pyRQ s c C s t i i | i ƒ t ƒ S( s8 Return the full pathname of the folder's sequences file.( R
R R RQ t MH_SEQUENCES( R ( ( s /usr/lib64/python2.6/mhlib.pyt getsequencesfilename s c C s t i i | i ƒ t | ƒ ƒ S( s4 Return the full pathname of a message in the folder.( R
R R RQ RO ( R t n( ( s /usr/lib64/python2.6/mhlib.pyt getmessagefilename s c C s | i i | i ƒ S( s! Return list of direct subfolders.( RP R: R/ ( R ( ( s /usr/lib64/python2.6/mhlib.pyR: s c C s | i i | i ƒ S( s Return list of all subfolders.( RP R< R/ ( R ( ( s /usr/lib64/python2.6/mhlib.pyR< s c C s‘ g } t i } | i } x8 t i | i ƒ ƒ D]! } | | ƒ o | | ƒ q. q. Wt t | ƒ } | i ƒ | o | d | _ n
d | _ | S( s€ Return the list of messages currently present in the folder.
As a side effect, set self.last to the last message (or 0).iÿÿÿÿi (
RM RN R, R
R+ RQ t mapRC R- t last( R t messagesRN R, R/ ( ( s /usr/lib64/python2.6/mhlib.pyt listmessages s
c C sÚ h } | i ƒ } y t | d ƒ } Wn t j
o | SXx— | i ƒ } | p Pn | i d ƒ } t | ƒ d j o! | i d | | i ƒ f ƒ n | d i ƒ } t | d i ƒ d ƒ i ƒ } | | | i i s multiple errors:N( RU RO R
RI R t renameR, t removefromallsequencesR` ( R t listt errorst deletedRT R t commapathR ( ( s /usr/lib64/python2.6/mhlib.pyt removemessagesÑ s* i c C s’ g } h } xü | D]ô } | i ƒ d } | i | ƒ } | i | ƒ } y t i | | ƒ Wn’ t i j
oƒ y! t i | | ƒ t i | ƒ Wqð t t i f j
oC }
| i |
ƒ y t i | ƒ Wq t i j
o q Xq qð Xn X| i
| ƒ | | | Rx c C s7 g | _ | | _ | | _ | o | i | ƒ n d S( N( t pairst sept rngt
fromstring( R t dataRã Rä ( ( s /usr/lib64/python2.6/mhlib.pyR s
c C s
g | _ d S( N( Râ ( R ( ( s /usr/lib64/python2.6/mhlib.pyt reset s c C s t | i | i ƒ S( N( t cmpRâ ( R t other( ( s /usr/lib64/python2.6/mhlib.pyt __cmp__# s c C s
t | i ƒ S( N( t hashRâ ( R ( ( s /usr/lib64/python2.6/mhlib.pyt __hash__& s c C s d | i ƒ | i | i f S( Ns IntSet(%r, %r, %r)( Rk Rã Rä ( R ( ( s /usr/lib64/python2.6/mhlib.pyR ) s c C s¨ | i i ƒ d } xŽ | t | i ƒ j ow | i | d \ } } | i | \ } } | | d j o. | t | | ƒ f g | i | d | d +q | d } q Wd S( Ni ( Râ R- R` Rp ( R R~ t alot ahit blot bhi( ( s /usr/lib64/python2.6/mhlib.pyt normalize, s
.c C s€ d } xs | i D]h \ } } | | j o t | ƒ } n t | ƒ | i t | ƒ } | o | | i | } q | } q W| S( NR; ( Râ R» Rä Rã ( R Rm t lot hit t( ( s /usr/lib64/python2.6/mhlib.pyRk 7 s
c C sA g } x4 | i D]) \ } } t | | d ƒ } | | } q W| S( Ni ( Râ t range( R t lRò Ró t m( ( s /usr/lib64/python2.6/mhlib.pyRc @ s
c C s" x | D] } | i | ƒ q Wd S( N( R, ( R R‘ R~ ( ( s /usr/lib64/python2.6/mhlib.pyRj G s c C s t ƒ } | i | _ | S( N( Rb Râ ( R R© ( ( s /usr/lib64/python2.6/mhlib.pyt cloneK s
c C s | i d d S( Ni ( Râ ( R ( ( s /usr/lib64/python2.6/mhlib.pyt minP s c C s | i d d S( Niÿÿÿÿ( Râ ( R ( ( s /usr/lib64/python2.6/mhlib.pyRp S s c C sA x: | i D]/ \ } } | | j o
| j n o t Sq
Wt S( N( Râ t Truet False( R t xRò Ró ( ( s /usr/lib64/python2.6/mhlib.pyt containsV s
c C s~ xt t | i ƒ ƒ D]ê } | i | \ } } | | j o² | d | j o | | f | i | /dev/nulls <-- picks f.listmessages()( s firsts lasts curR‰ s prevs nexts first:3s last:3s cur:3s cur:-3s prev:3s next:3s 1:3s 1:-3s 100:3s 100:-3s 10000:3s 10000:-3s all( R
t systemR RP RB R) Rh Rb Rc Rn t reversedR$ R t popenR¯ RV RC R_ ( R t testfoldersRô Rs R" Rl R t stuffR‘ ( ( s /usr/lib64/python2.6/mhlib.pyt test sV
t __main__( RL t warningsR R R RR RD R
R R R¹ RÔ R— R t __all__t ExceptionR R R RM R? R R R× Rb R Ru R R ( ( ( s /usr/lib64/python2.6/mhlib.pyt 6 s<
ÿ ¦M ‰ " *