mò
‚=5Dc@südZd
k
Z
dklZ
dklZ
dZdZdZe
i	dƒ
Z
e
i	dƒ
Zd	„Zd
„Z
d„Zd„Zd
d„
Zd„Zd„Zdeded„Zeded„ZeZeZed„
ZeZeZd„Zd„Zd
S(sFQuoted-printable content transfer encoding per RFCs 2045-2047.

This module handles the content transfer encoding method defined in RFC 2045
to encode US ASCII-like 8-bit data called `quoted-printable'.  It is used to
safely encode text that is in a character set similar to the 7-bit US ASCII
character set, but that includes some 8-bit characters that are normally not
allowed in email bodies or headers.

Quoted-printable is very space-inefficient for encoding binary files; use the
email.base64MIME module for that instead.

This module provides an interface to encode and decode both headers and bodies
with quoted-printable encoding.

RFC 2045 defines a method for including character set information in an
`encoded-word' in a header.  This method is commonly used for 8-bit real names
in To:/From:/Cc: etc. fields, as well as Subject: lines.

This module does not do the line wrapping or end-of-line character
conversion necessary for proper internationalized headers; it only
does dumb encoding and decoding.  To deal with the various line
wrapping issues, use the email.Header module.
N(
s	hexdigits(
sfix_eolss
s

is[^-a-zA-Z0-9!*+/ ]s[^ !-<>-~\t]c

Cstt
i|ƒ
ƒ
S(sBReturn True if the character should be escaped with header quopri.N(tboolthqretmatcht
c(
R((t&/usr/lib/python2.4/email/quopriMIME.pytheader_quopri_check-s

c

Cstt
i|ƒ
ƒ
S(s@Return True if the character should be escaped with body quopri.N(RtbqreRR(
R((Rtbody_quopri_check2s

c
CsCd
}
x6|D].}ti|ƒ
o
|
d7}
q

|
d7}
q
W|
S(s?Return the length of str when it is encoded with header quopri.iii
N(tcountt
sRR
R(R	RR((Rtheader_quopri_len7s





c
CsCd
}
x6|D].}ti|ƒ
o
|
d7}
q

|
d7}
q
W|
S(s=Return the length of str when it is encoded with body quopri.iii
N(RtstrRRR(RRR((Rtbody_quopri_lenBs





tcCsn|p
|i
|
iƒƒ

nM
t|d
ƒ
t|
ƒ
|j
o
|d
c||
7<n
|i
|
iƒƒ

dS(Niÿÿÿÿ(t
LtappendR	tlstriptlentmaxlentextra(RR	RR((Rt_max_appendMs



!
c

Cstt
|d
d!dƒƒ
S(sDTurn a string in the form =AB to the ASCII character with value 0xabi
iiN(tchrtintR	(
R	((RtunquoteVs

c

Csd
t|ƒ
S(Ns=%02X(tordR(
R((Rtquote[s
s
iso-8859-1iLcCs
|p
|Sn

|p
t|ƒ
}n

g}|djo

d
}n
|t|
ƒ
t	d}xm|D]e}|djo
t|d|ƒ
qb
ti
|ƒ
p
t|||ƒ
qb
t|dt|ƒ
|ƒ
qbW|d}
|
ig}	|D]}|	d|
|fqæ~	ƒ
S(s…Encode a single header line with quoted-printable (like) encoding.

    Defined in RFC 2045, this `Q' encoding is similar to quoted-printable, but
    used specifically for email header fields to allow charsets with mostly 7
    bit characters (and some 8 bit) to remain more or less readable in non-RFC
    2045 aware mail clients.

    charset names the character set to use to encode the header.  It defaults
    to iso-8859-1.

    The resulting string will be in the form:

    "=?charset?q?I_f=E2rt_in_your_g=E8n=E8ral_dire=E7tion?\n
      =?charset?q?Silly_=C8nglish_Kn=EEghts?="

    with each line wrapped safely at, at most, maxlinelen characters (defaults
    to 76 characters).  If maxlinelen is None, the entire string is encoded in
    one chunk with no splitting.

    End-of-line characters (\r, \n, \r\n) will be automatically converted
    to the canonical email line separator \r\n unless the keep_eols
    parameter is True (the default is False).

    Each line of the header will be terminated in the value of eol, which
    defaults to "\n".  Set this to "\r\n" if you are using the result of
    this function directly in email.
    i †
i
t
 t
_s=%02Xs=?%s?q?%s?=N(theadert	keep_eolstfix_eolstquotedt
maxlinelentNonetmax_encodedRtcharsettMISC_LENRRR
RRteoltjoinertjoint_[1]tline(RR#RR R%RR)RR"R(R&((Rt
header_encode`s$









c
Csc|p
|Sn

|
p
t|ƒ
}n

d
}d}	|idƒ
}x|D]}
|
it	ƒ
o
|
d }
n 
|
dt	jo
|
d }
n

|	d7}	d
}d}t
|
ƒ
}xÀt|ƒ
D]²}|
|}|}ti|ƒ
o
t|ƒ
}n:
|d|jo(
|djo
||7}n

|}qºn

t
|ƒ
t
|ƒ
|jo
||d|7}d
}n

||7}qºW|o™
|djoŒ
|	dt
|ƒ
joU
t|ƒ
}t
|ƒ
t
|ƒ
|jo
||d||7}q
|||7}n
|||d|7}d
}n

||	it	ƒ
p
||	dt	jo
|||7}n
||7}d
}qHW|S(s¥Encode with quoted-printable, wrapping at maxlinelen characters.

    If binary is False (the default), end-of-line characters will be converted
    to the canonical email end-of-line sequence \r\n.  Otherwise they will
    be left verbatim.

    Each line of encoded text will end with eol, which defaults to "\n".  Set
    this to "\r\n" if you will be using the result of this function directly
    in an email.

    Each line will be wrapped at, at most, maxlinelen characters (defaults to
    76 characters).  Long lines will have the `soft linefeed' quoted-printable
    character "=" appended to them, so the decoded text will be identical to
    the original text.
    R
iÿÿÿÿi
iþÿÿÿs 	t
=N(tbodytbinaryRtencoded_bodytlinenot
splitlinestlinesR)tendswithtCRLFtencoded_lineR!tprevRtlinelentranget
jRRRRR R%(
R,R-R R%R.R1RR4R8R/R)R5R6((Rtencode s\































)




cCsŽ
|p
|Sn

d
}xC
|iƒD]5
}|iƒ}|p
||
7}q"n

d}t|ƒ
}xö||joè
||}|djo
||7}|d7}n›
|d|jo
|d7}qany
|d|joS
||dt
jo>
||dt
jo)
|t|||d!ƒ
7}|d7}n
||7}|d7}||jo
||
7}qa
qa
Wq"W|i|
ƒ
o
|i|
ƒ
o
|d }n

|S(	s_Decode a quoted-printable string.

    Lines are separated with eol, which defaults to \n.
    R
iR+i
iiiÿÿÿÿN(
tencodedtdecodedR0R)trstripR%t
iRt
nRt	hexdigitsRR2(R:R%R;RR=R>R)((Rtdecodeús>




















;






!

c
Cs|i
d
ƒ
}
t|
ƒ
S(sCTurn a match in the form =AB to the ASCII character with value 0xabiN(RtgroupR	R(RR	((Rt_unquote_match/
s


c

Cs%|i
d
dƒ}tidt|ƒS(s
Decode a string encoded with RFC 2045 MIME header `Q' encoding.

    This function does not parse a full MIME header value encoded with
    quoted-printable (like =?iso-8895-1?q?Hello_World?=) -- please use
    the high level email.Header class for that functionality.
    RRs=\w{2}N(R	treplacetretsubRB(
R	((Rt
header_decode6
s

(t__doc__RDtstringR?temail.UtilsRR3tNLR$tcompileR
RRRR
RRRRtFalseR*R9tbody_encodetencodestringR@tbody_decodetdecodestringRBRF(RRBRR
R
RFRRJRR$R@RDROR*R9RPRR?R3RMRNRRR((Rt
?s0	





							@S
0