/
/
usr/
lib64/
lib64/
/
lib64/
lib64/
python2.7/ó
ÙœSec @ s| d Z d d l m Z e d d d ƒ[ d Z d Z d Z d Z d d
l Z d d
l Z d d
l Z d d
l
Z
d d
l Z d d
l Z d d l
m
Z
d d
d d g Z d
e f d „ ƒ YZ d f d „ ƒ YZ e j d ƒ Z d „ Z d f d „ ƒ YZ d e
j f d „ ƒ YZ d e f d „ ƒ YZ d f d „ ƒ YZ d d „ Z d d „ Z d „ Z e d k rxe ƒ 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.7/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 k r t } n t j j | ƒ | _ | d k rH | j d ƒ } n | sW t } n t j j | ƒ r’ | d d k r’ t j j d | ƒ } n t j j | ƒ } t j j
| ƒ s 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.7/mhlib.pyt __init__f s # c C s d | j | j f S( s String representation.s
MH(%r, %r)( R R ( R ( ( s /usr/lib64/python2.7/mhlib.pyt __repr__r s c G s t j j 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.7/mhlib.pyt errorv s c C s t | j | ƒ S( s* Return a profile entry, None if not found.( t picklineR ( R t key( ( s /usr/lib64/python2.7/mhlib.pyR z s c C s | j S( s9 Return the path (the name of the collection's directory).( R ( R ( ( s /usr/lib64/python2.7/mhlib.pyt getpath~ s c C s7 t t j j | j ƒ d ƒ d ƒ } | s3 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.7/mhlib.pyt
getcontext‚ s
c C sI t j j | j ƒ d ƒ } t | d ƒ } | j d | ƒ | j ƒ 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.7/mhlib.pyt
setcontext‰ s c C sq g } | j ƒ } xN t j | ƒ D]= } t j j | | ƒ } t j j | ƒ r" | j | ƒ q" q" W| j ƒ | 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.7/mhlib.pyt listfolders s
c C sÔ t j j | j | ƒ } t j | ƒ j } | d k r: g Sg } t j | ƒ } xt | D]l } t j j | | ƒ } t j j | ƒ rV t j j | | ƒ } | j | ƒ | d } | d k r Pq qV qV W| j ƒ | 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.7/mhlib.pyt listsubfolders› s
c C s
| j d ƒ S( s< Return the names of all folders and subfolders, recursively.t ( t listallsubfolders( R ( ( s /usr/lib64/python2.7/mhlib.pyt listallfolders³ s c
C s$ t j j | j | ƒ } t j | ƒ j } | d k r: g Sg } t j | ƒ } xÄ | D]¼ } | d d k sV t | ƒ r~ qV n t j j | | ƒ } t j j | ƒ rV t j j | | ƒ } | j | ƒ t j j | ƒ sõ | j
| ƒ } | | } n | d } | d k rPqqV qV W| j ƒ | 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.7/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.7/mhlib.pyt
openfolderÓ s c C se t | j d ƒ } | r6 t | ƒ r6 t | d ƒ } n t } t j t j j | j ƒ | ƒ | ƒ 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.7/mhlib.pyt
makefolder× s
c C s” t j j | j ƒ | ƒ } xe t j | ƒ D]T } t j j | | ƒ } y t j | ƒ Wq+ t j k
r~ | j d | ƒ q+ Xq+ Wt j | ƒ 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.7/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.7/mhlib.pyR _ s s
^[1-9][0-9]*$c C s t j | ƒ d k S( N( t numericprogt matchR ( t str( ( s /usr/lib64/python2.7/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 j j | j ƒ ƒ s: 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.7/mhlib.pyR õ s c C s d | j | j f S( s String representation.s Folder(%r, %r)( RP R/ ( R ( ( s /usr/lib64/python2.7/mhlib.pyR ü s c G s | j j | Œ d S( s Error message handler.N( RP R ( R R ( ( s /usr/lib64/python2.7/mhlib.pyR s c C s t j j | j j | j ƒ S( s' Return the full pathname of the folder.( R
R R RP R/ ( R ( ( s /usr/lib64/python2.7/mhlib.pyRQ s c C s t j j | j ƒ 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.7/mhlib.pyt getsequencesfilename s c C s t j j | j ƒ 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.7/mhlib.pyt getmessagefilename s c C s | j j | j ƒ S( s! Return list of direct subfolders.( RP R: R/ ( R ( ( s /usr/lib64/python2.7/mhlib.pyR: s c C s | j j | j ƒ S( s Return list of all subfolders.( RP R< R/ ( R ( ( s /usr/lib64/python2.7/mhlib.pyR< s c C s g } t j } | j } x6 t j | j ƒ ƒ D] } | | ƒ r. | | ƒ q. q. Wt t | ƒ } | j ƒ | r€ | 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.7/mhlib.pyt listmessages s
c C sÔ i } | j ƒ } y t | d ƒ } Wn t k
r9 | SXx“ | j ƒ } | sS Pn | j d ƒ } t | ƒ d k r” | j d | | j ƒ f ƒ n | d j ƒ } t | d j ƒ d ƒ j ƒ } | | |
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.7/mhlib.pyt removemessagesÑ s(
i c C s„ g } i } xö | D]î } | j ƒ d } | j | ƒ } | j | ƒ } y t j | | ƒ WnŒ t j k
ré y! t j | | ƒ t j | ƒ Wqê t t j f k
rå }
| j |
ƒ y t j | ƒ Wq t j k
rÞ q Xq qê Xn X| j
| ƒ | | | Rx c C s5 g | _ | | _ | | _ | r1 | j | ƒ n d S( N( t pairst sept rngt
fromstring( R t dataRã Rä ( ( s /usr/lib64/python2.7/mhlib.pyR s
c C s
g | _ d S( N( Râ ( R ( ( s /usr/lib64/python2.7/mhlib.pyt reset s c C s t | j | j ƒ S( N( t cmpRâ ( R t other( ( s /usr/lib64/python2.7/mhlib.pyt __cmp__# s c C s
t | j ƒ S( N( t hashRâ ( R ( ( s /usr/lib64/python2.7/mhlib.pyt __hash__& s c C s d | j ƒ | j | j f S( Ns IntSet(%r, %r, %r)( Rk Rã Rä ( R ( ( s /usr/lib64/python2.7/mhlib.pyR ) s c C s¤ | j j ƒ d } xŠ | t | j ƒ k rŸ | j | d \ } } | j | \ } } | | d k r’ | t | | ƒ f g | j | d | d +q | d } q Wd S( Ni ( Râ R- R` Rp ( R R~ t alot ahit blot bhi( ( s /usr/lib64/python2.7/mhlib.pyt normalize, s
-c C s| d } xo | j D]d \ } } | | k r7 t | ƒ } n t | ƒ | j t | ƒ } | rn | | j | } q | } q W| S( NR; ( Râ R» Rä Rã ( R Rm t lot hit t( ( s /usr/lib64/python2.7/mhlib.pyRk 7 s
c C sA g } x4 | j D]) \ } } t | | d ƒ } | | } q W| S( Ni ( Râ t range( R t lRò Ró t m( ( s /usr/lib64/python2.7/mhlib.pyRc @ s
c C s" x | D] } | j | ƒ q Wd S( N( R, ( R R‘ R~ ( ( s /usr/lib64/python2.7/mhlib.pyRj G s
c C s t ƒ } | j | _ | S( N( Rb Râ ( R R© ( ( s /usr/lib64/python2.7/mhlib.pyt cloneK s
c C s | j d d S( Ni ( Râ ( R ( ( s /usr/lib64/python2.7/mhlib.pyt minP s c C s | j d d S( Niÿÿÿÿ( Râ ( R ( ( s /usr/lib64/python2.7/mhlib.pyRp S s c C s> x7 | j D], \ } } | | k o- | k n r
t Sq
Wt S( N( Râ t Truet False( R t xRò Ró ( ( s /usr/lib64/python2.7/mhlib.pyt containsV s c C sq xø t t | j ƒ ƒ D]á } | j | \ } } | | k rç | d | k ra | | f | j | /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.7/mhlib.pyt test sP
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.7/mhlib.pyt 6 s<
ÿ ¦M ‰ " *