z fc @ s d Z d d l Z d d l m Z e d d d d d d d
d g Z d d
f Z d f d YZ d Z d Z d Z d f d YZ
d e
f d YZ d Z d d d d d d d d d d d d! d" d# d$ d% d d& d' d( d) d* d+ d, g Z
d- d. d/ d0 d1 d2 d3 g Z i d4 d5 6d4 d6 6d4 d7 6d4 d8 6d9 d: 6d; d< 6d= d> 6d9 d? 6d@ dA 6d= dB 6dC dD 6d@ dE 6dF dG 6dC dH 6Z dI Z dJ Z dK Z e dL Z e dM k rd d l Z d d l Z e j j e j dN dO Z e j dP re j dP Z n e e dQ Z e e Z dR Ge j dS GHdT Ge j! dU GHdV Ge j" dW GHdX Ge j" dY GHe j# dY Z$ e$ d Z% e j& e e$ Z$ e$ rdZ Ge j' e$ Ge% Z( e) e( d[ \ Z* Z+ e) e* d[ \ Z, Z- d\ e, e- f Ge+ rd] e+ Gn Hn dZ Ge GHe j. d4 Z/ x e j0 r8e/ dP 7Z/ q Wd^ Ge/ GHd_ d` GHda Ge1 e GHdb e k rvdc Ge db GHn dd e k rn de Ge j2 GHdf Ge j3 GHdg Ge j4 GHn d S(h s* RFC 2822 message manipulation.
Note: This is only a very rough sketch of a full RFC-822 parser; in particular
the tokenizing of addresses does not adhere to all the quoting rules.
Note: RFC 2822 is a long awaited update to RFC 822. This module should
conform to RFC 2822, and is thus mis-named (it's not worth renaming it). Some
effort at RFC 2822 updates have been made, but a thorough audit has not been
performed. Consider any RFC 2822 non-conformance to be a bug.
RFC 2822: http://www.faqs.org/rfcs/rfc2822.html
RFC 822 : http://www.faqs.org/rfcs/rfc822.html (obsolete)
Directions for use:
To create a Message object: first open a file, e.g.:
fp = open(file, 'r')
You can use any other legal way of getting an open file object, e.g. use
sys.stdin or call os.popen(). Then pass the open file object to the Message()
constructor:
m = Message(fp)
This class can work with any input object that supports a readline method. If
the input object has seek and tell capability, the rewindbody method will
work; also illegal lines will be pushed back onto the input stream. If the
input object lacks seek but has an `unread' method that can push back a line
of input, Message will use that to push back illegal lines. Thus this class
can be used to parse messages coming from a buffered stream.
The optional `seekable' argument is provided as a workaround for certain stdio
libraries in which tell() discards buffered data before discovering that the
lseek() system call doesn't work. For maximum portability, you should set the
seekable argument to zero to prevent that initial \code{tell} when passing in
an unseekable object such as a file object created from a socket object. If
it is 1 on entry -- which it is by default -- the tell() method of the open
file object is called once; if this raises an exception, seekable is reset to
0. For other nonzero values of seekable, this test is not made.
To get the text of a particular header there are several methods:
str = m.getheader(name)
str = m.getrawheader(name)
where name is the name of the header, e.g. 'Subject'. The difference is that
getheader() strips the leading and trailing whitespace, while getrawheader()
doesn't. Both functions retain embedded whitespace (including newlines)
exactly as they are specified in the header, and leave the case of the text
unchanged.
For addresses and address lists there are functions
realname, mailaddress = m.getaddr(name)
list = m.getaddrlist(name)
where the latter returns a list of (realname, mailaddr) tuples.
There is also a method
time = m.getdate(name)
which parses a Date-like field and returns a time-compatible tuple,
i.e. a tuple such as returned by time.localtime() or accepted by
time.mktime().
See the class definition for lower level access methods.
There are also some utility functions here.
iN( t warnpy3ks= in 3.x, rfc822 has been removed in favor of the email packaget
stackleveli t Messaget AddressListt parsedatet parsedate_tzt mktime_tzs
s
c B s e Z d Z d d Z d Z d Z d Z d Z d Z d Z d Z
d
Z d d Z
e
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/ Represents a single RFC 2822-compliant message.i c C s | d k r= y | j Wq= t t f k
r9 d } q= Xn | | _ | | _ d | _ d | _ | j r y | j j | _ Wq t k
r d | _ q Xn | j | j r y | j j | _ Wq t k
r d | _ q Xn d S( s3 Initialize the class instance and read the headers.i i N( t tellt AttributeErrort IOErrort fpt seekablet Nonet startofheaderst startofbodyt readheaders( t selfR
R ( ( s /usr/lib64/python2.7/rfc822.pyt __init__X s(
c C s, | j s t d n | j j | j d S( s7 Rewind the file to the start of the body (if seekable).s unseekable fileN( R R R
t seekR ( R ( ( s /usr/lib64/python2.7/rfc822.pyt
rewindbodyt s c C sK i | _ d | _ g | _ } d | _ d } d } d } } } t | j d rc | j j } n | j r{ | j j } n x| r y
| } Wq t
k
r d } } d | _ q Xn | j j } | s d | _ Pn | r| j d r| j | | _ q~ n d } | re| d d k re| j
| | j | d | j } | j | j | Delete all occurrences of a specific header, if it is present.NR) i i ( R+ R R" t rangeR R/ R t reversed( R R0 R1 R# R2 R, R' ( ( s /usr/lib64/python2.7/rfc822.pyt __delitem__ s$
R c C sw | j } | | j k r& | j | S| d | } x+ | j d D] } | j j | d qD W| | j | <| Sd S( Ns : s
( R+ R RN R R ( R R0 R8 t lowernameRP R' ( ( s /usr/lib64/python2.7/rfc822.pyt
setdefault s
c C s | j | j k S( s6 Determine whether a message contains the named header.( R+ R ( R R0 ( ( s /usr/lib64/python2.7/rfc822.pyt has_key s c C s | j | j k S( s6 Determine whether a message contains the named header.( R+ R ( R R0 ( ( s /usr/lib64/python2.7/rfc822.pyt __contains__ s c C s
t | j S( N( t iterR ( R ( ( s /usr/lib64/python2.7/rfc822.pyt __iter__ s c C s
| j j S( s* Get all of a message's header field names.( R t keys( R ( ( s /usr/lib64/python2.7/rfc822.pyR[ s c C s
| j j S( s+ Get all of a message's header field values.( R t values( R ( ( s /usr/lib64/python2.7/rfc822.pyR\ s c C s
| j j S( sW Get all of a message's headers.
Returns a list of name, value tuples.
( R t items( R ( ( s /usr/lib64/python2.7/rfc822.pyR] s c C s d j | j S( NR ( R5 R ( R ( ( s /usr/lib64/python2.7/rfc822.pyt __str__ s N( t __name__t
__module__t __doc__R R R R! R R R3 R4 R6 R R9 R7 R> RA R? RJ RK RL RM RQ RT RV RW RX RZ R[ R\ R] R^ ( ( ( s /usr/lib64/python2.7/rfc822.pyR U s: P
c C s t | d k r | j d rS | j d rS | d d !j d d j d d S| j d r | j d r | d d !Sn | S( s Remove quotes from a string.i t "is \\s \s \"t ( R" R t endswitht replace( R= ( ( s /usr/lib64/python2.7/rfc822.pyt unquote s # c C s | j d d j d d S( s Add quotes around a string.s \s \\Rb s \"( Rf ( R= ( ( s /usr/lib64/python2.7/rfc822.pyt quote s c C s' t | } | j } | s d S| d S( s3 Parse an address into a (realname, mailaddr) tuple.i N( NN( R RB R ( t addressRG R# ( ( s /usr/lib64/python2.7/rfc822.pyt parseaddr s
t
AddrlistClassc B s e 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 d
Z d Z RS( s) Address parser class by Ben Escoto.
To understand what this class does, it helps to have a copy of
RFC 2822 in front of you.
http://www.faqs.org/rfcs/rfc2822.html
Note: this class interface is deprecated and may be removed in the future.
Use rfc822.AddressList instead.
c C sl d | _ d | _ d | _ d | _ | j | j | j | _ | j j d d | _ | | _ g | _ d S( s Initialize a new instance.
`field' is an unparsed address header field, containing one or more
addresses.
s ()<>@,:;."[]i s s
t .R N( t specialst post LWSt CRt atomendsRf t
phraseendst fieldt commentlist( R Rs ( ( s /usr/lib64/python2.7/rfc822.pyR s c C s x| | j t | j k r~ | j | j | j d k rK | j d | _ q | j | j d k rz | j j | j q Pq Wd S( s* Parse up to the start of the next address.s
i t (N( Rn R" Rs Ro Rt R t
getcomment( R ( ( s /usr/lib64/python2.7/rfc822.pyt gotonext s c C s9 g } | j } x | r4 | | 7} | j } q W| S( sV Parse all addresses.
Returns a list containing all of the addresses.
( t
getaddress( R R: t ad( ( s /usr/lib64/python2.7/rfc822.pyR? s
c C s g | _ | j | j } | j } | j } | j g } | j t | j k r | rPd j | j | d f g } qPn| j | j d k r | | _ | | _ | j } d j | j | f g } nz| j | j d k rg } t | j } | j d 7_ x=| j t | j k r| j | j | k rm| j | j d k rm| j d 7_ Pn | | j } qWn | j | j d k r| j } | j rd j | d d j | j d | f g } qPd j | | f g } nS | r%d j | j | d f g } n+ | j | j | j
k rP| j d 7_ n | j | j t | j k r| j | j d
k r| j d 7_ n | S( s Parse the next address.t i s .@R) i t ;Rc s (t )t ,( Rt Rw Rn t
getphraselistR" Rs R5 t getaddrspecRx t getrouteaddrRm ( R t oldpost oldclt plistt
returnlistt addrspect fieldlent routeaddr( ( s /usr/lib64/python2.7/rfc822.pyRx ( sL
%
% 3"
.c C s | j | j d k r d Sd } | j d 7_ | j d } x | j t | j k r| rs | j d } n | j | j d k r | j d 7_ Pnr | j | j d k r | j d 7_ d } nD | j | j d k r | j d 7_ n | j } | j d 7_ P| j qB W| S( s Parse a route address (Return-path value).
This method just skips all the route stuff and returns the addrspec.
Rc Ni i R Rd t @R) ( Rs Rn Rw R" t getdomainR ( R t expectroutet adlist( ( s /usr/lib64/python2.7/rfc822.pyR b s.
c C sF g } | j x | j t | j k r | j | j d k r` | j d | j d 7_ n` | j | j d k r | j d | j n0 | j | j | j k r Pn | j | j | j q W| j t | j k s | j | j d k r d j | S| j d | j d 7_ | j d j | | j S( s Parse an RFC 2822 addr-spec.Rl i Rb s "%s"R R (
Rw Rn R" Rs R t getquoteRq t getatomR5 R ( R t aslist( ( s /usr/lib64/python2.7/rfc822.pyR s$
.
c C s g } x| j t | j k r| j | j | j k rL | j d 7_ q | j | j d k r{ | j j | j q | j | j d k r | j | j q | j | j d k r | j d 7_ | j d q | j | j | j k r Pq | j | j q Wd j
| S( s- Get the complete domain name from an address.i Ru t [Rl R ( Rn R" Rs Ro Rt R Rv t getdomainliteralRq R R5 ( R t sdlist( ( s /usr/lib64/python2.7/rfc822.pyR s i c C s3 | j | j | k r d Sd g } d } | j d 7_ x | j t | j k r%| d k r | j | j | j d } n | j | j | k r | j d 7_ Pnk | r | j | j d k r | j | j q; n6 | j | j d k r d } n | j | j | j | j d 7_ q; Wd j | S( s Parse a header fragment delimited by special characters.
`beginchar' is the start character for the fragment. If self is not
looking at an instance of `beginchar' then getdelimited returns the
empty string.
`endchars' is a sequence of allowable end-delimiting characters.
Parsing stops when one of these is encountered.
If `allowcomments' is non-zero, embedded RFC 2822 comments are allowed
within the parsed fragment.
R i i Ru s \( Rs Rn R" R Rv R5 ( R t beginchart endcharst
allowcommentst slistRh ( ( s /usr/lib64/python2.7/rfc822.pyt getdelimited s(
c C s | j d d d S( s1 Get a quote-delimited fragment from self's field.Rb s "
i ( R ( R ( ( s /usr/lib64/python2.7/rfc822.pyR s c C s | j d d d S( s7 Get a parenthesis-delimited fragment from self's field.Ru s )
i ( R ( R ( ( s /usr/lib64/python2.7/rfc822.pyRv s c C s d | j d d d S( s! Parse an RFC 2822 domain-literal.s [%s]R s ]
i ( R ( R ( ( s /usr/lib64/python2.7/rfc822.pyR s c C s d g } | d k r! | j } n x\ | j t | j k r | j | j | k rV Pn | j | j | j | j d 7_ q$ Wd j | S( s Parse an RFC 2822 atom.
Optional atomends specifies a different set of end token delimiters
(the default is to use self.atomends). This is used e.g. in
getphraselist() since phrase endings must not include the `.' (which
is legal in phrases).R i N( R Rq Rn R" Rs R R5 ( R Rq t atomlist( ( s /usr/lib64/python2.7/rfc822.pyR s c C s g } x | j t | j k r | j | j | j k rL | j d 7_ q | j | j d k rx | j | j q | j | j d k r | j j | j q | j | j | j k r Pq | j | j | j q W| S( s Parse a sequence of RFC 2822 phrases.
A phrase is a sequence of words, which are in turn either RFC 2822
atoms or quoted-strings. Phrases are canonicalized by squeezing all
runs of continuous whitespace into one space.
i Rb Ru (
Rn R" Rs Ro R R Rt Rv Rr R ( R R ( ( s /usr/lib64/python2.7/rfc822.pyR~ s N( R_ R` Ra R Rw R? Rx R R R R R Rv R R R R~ ( ( ( s /usr/lib64/python2.7/rfc822.pyRk s
: % c B sV e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
RS( s@ An AddressList encapsulates a list of parsed RFC 2822 addresses.c C s5 t j | | | r( | j | _ n g | _ d S( N( Rk R R? RB ( R Rs ( ( s /usr/lib64/python2.7/rfc822.pyR s c C s
t | j S( N( R" RB ( R ( ( s /usr/lib64/python2.7/rfc822.pyRL s c C s d j t t | j S( Ns , ( R5 t mapt dump_address_pairRB ( R ( ( s /usr/lib64/python2.7/rfc822.pyR^ s c C sS t d } | j | _ x3 | j D]( } | | j k r# | j j | q# q# W| S( N( R R RB R ( R t othert newaddrR( ( ( s /usr/lib64/python2.7/rfc822.pyt __add__ s
c C s: x3 | j D]( } | | j k r
| j j | q
q
W| S( N( RB R ( R R R( ( ( s /usr/lib64/python2.7/rfc822.pyt __iadd__ s c C sF t d } x3 | j D]( } | | j k r | j j | q q W| S( N( R R RB R ( R R R R( ( ( s /usr/lib64/python2.7/rfc822.pyt __sub__& s
c C s: x3 | j D]( } | | j k r
| j j | q
q
W| S( N( RB t remove( R R R( ( ( s /usr/lib64/python2.7/rfc822.pyt __isub__. s c C s | j | S( N( RB ( R t index( ( s /usr/lib64/python2.7/rfc822.pyRM 5 s ( R_ R` Ra R RL R^ R R R R RM ( ( ( s /usr/lib64/python2.7/rfc822.pyR s c C s2 | d r& d | d d | d d S| d Sd S( s4 Dump a (name, address) pair in a canonicalized form.i Rb s " G s
2 U