*j S r SSKrSSKrSSKrSSKJr SSKJr SSKJ r
SSKJ r SSKJ r Sr
\" \
5 r\\" S 5 - r\" S
5 r\\- r\\" S 5 -
r\\" S 5 -
r\\" S
5 - \" S 5 -
r\\- r\\" S5 - r\\- r\\" S5 -
rSS1r\\- rS r S r S r \R> " S\R@ \RB - 5 r" " S S\#5 r$ " S S\$5 r% " S S\$5 r& " S S \$5 r' " S S \$5 r( " S S!\%5 r) " S" S#\$5 r* " S$ S%\$5 r+ " S& S'\$5 r, " S( S)\$5 r- " S* S+\-5 r. " S, S-\%5 r/ " S. S/\$5 r0 " S0 S1\$5 r1 " S2 S3\$5 r2 " S4 S5\$5 r3 " S6 S7\$5 r4 " S8 S9\$5 r5 " S: S;\$5 r6 " S< S=\$5 r7 " S> S?\$5 r8 " S@ SA\$5 r9 " SB SC\$5 r: " SD SE\$5 r; " SF SG\$5 r< " SH SI\$5 r= " SJ SK\$5 r> " SL SM\$5 r? " SN SO\'5 r@ " SP SQ\$5 rA " SR SS\$5 rB " ST SU\$5 rC " SV SW\$5 rD " SX SY\D5 rE " SZ S[\$5 rF " S\ S]\$5 rG " S^ S_\$5 rH " S` Sa\$5 rI " Sb Sc\$5 rJ " Sd Se\J5 rK " Sf Sg\J5 rL " Sh Si\$5 rM " Sj Sk\$5 rN " Sl Sm\$5 rO " Sn So\O5 rP " Sp Sq\P5 rQ " Sr Ss\$5 rR " St Su\$5 rS " Sv Sw\T5 rU " Sx Sy\U5 rV " Sz S{\U5 rW " S| S}\V5 rX " S~ S\ R 5 rZ\W" S S5 r[\W" SS5 r\S\\l] S\\l^ \W" SS5 r_\R> " SR SR \5 5 5 R rc\R> " SR \R " SR \5 5 5 5 R rf\R> " S5 R rh\R> " SR \R " SR \5 5 5 5 R ri\R> " SR \R " SR \5 5 5 5 R rj\R> " SR \R " SR \5 5 5 5 R rkS rlS rmS rnSS jroS rpS rqS rrS rsS rtS ruS rvS rwS rxS ryS rzS r{S r|S r}S r~S rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rS rg)al Header value parser implementing various email-related RFC parsing rules.
The parsing methods defined in this module implement various email related
parsing rules. Principal among them is RFC 5322, which is the followon
to RFC 2822 and primarily a clarification of the former. It also implements
RFC 2047 encoded word decoding.
RFC 5322 goes to considerable trouble to maintain backward compatibility with
RFC 822 in the parse phase, while cleaning up the structure on the generation
phase. This parser supports correct RFC 5322 generation by tagging white space
as folding white space only when folding is allowed in the non-obsolete rule
sets. Actually, the parser is even more generous when accepting input than RFC
5322 mandates, following the spirit of Postel's Law, which RFC 5322 encourages.
Where possible deviations from the standard are annotated on the 'defects'
attribute of tokens that deviate.
The general structure of the parser follows RFC 5322, and uses its terminology
where there is a direct correspondence. Where the implementation requires a
somewhat different structure than that used by the formal grammar, new terms
that mimic the closest existing terms are used. Thus, it really helps to have
a copy of RFC 5322 handy when studying this code.
Input to the parser is a string that has already been unfolded according to
RFC 5322 rules. According to the RFC this unfolding is the very first step, and
this parser leaves the unfolding step to a higher level message parser, which
will have already detected the line breaks that need unfolding while
determining the beginning and end of each header.
The output of the parser is a TokenList object, which is a list subclass. A
TokenList is a recursive data structure. The terminal nodes of the structure
are Terminal objects, which are subclasses of str. These do not correspond
directly to terminal objects in the formal grammar, but are instead more
practical higher level combinations of true terminals.
All TokenList and Terminal objects have a 'value' attribute, which produces the
semantically meaningful value of that part of the parse subtree. The value of
all whitespace tokens (no matter how many sub-tokens they may contain) is a
single space, as per the RFC rules. This includes 'CFWS', which is herein
included in the general class of whitespace tokens. There is one exception to
the rule that whitespace tokens are collapsed into single spaces in values: in
the value of a 'bare-quoted-string' (a quoted-string with no leading or
trailing whitespace), any whitespace that appeared between the quotation marks
is preserved in the returned value. Note that in all Terminal strings quoted
pairs are turned into their unquoted values.
All TokenList and Terminal objects also have a string value, which attempts to
be a "canonical" representation of the RFC-compliant form of the substring that
produced the parsed subtree, including minimal use of quoted pair quoting.
Whitespace runs are not collapsed.
Comment tokens also have a 'content' attribute providing the string found
between the parens (including any nested comments) with whitespace preserved.
All TokenList and Terminal objects have a 'defects' attribute which is a
possibly empty list all of the defects found while creating the token. Defects
may appear on any token in the tree, and a composite list of all defects in the
subtree is available through the 'all_defects' attribute of any node. (For
Terminal notes x.defects == x.all_defects.)
Each object in a parse tree is called a 'token', and each has a 'token_type'
attribute that gives the name from the RFC 5322 grammar that it represents.
Not all RFC 5322 nodes are produced, and there is one non-RFC 5322 node that
may be produced: 'ptext'. A 'ptext' is a string of printable ascii characters.
It is returned in place of lists of (ctext/quoted-pair) and
(qtext/quoted-pair).
XXX: provide complete list of token types.
N) hexdigits)
itemgetter)_encoded_words)errors)utilsz (z
()<>@,:;.\"[].z."(z/?=z*'%%
c X [ U 5 R SS5 R SS5 $ )z;Escape dquote and backslash for use within a quoted-string.\\\"z\"strreplacevalues A/opt/alt/python313/lib64/python3.13/email/_header_value_parser.pymake_quoted_pairsr d s& u: dF + 3 3C ?? c x [ U 5 R SS5 R SS5 R SS5 $ )z:Escape parenthesis and backslash for use within a comment.r r r \()\)r r s r make_parenthesis_pairsr i s2 u: dF + e WWS% 01r c $ [ U 5 nSU S3$ )Nr )r )r escapeds r quote_stringr o s &G
wiq>r z
=\? # literal =?
[^?]* # charset
\? # literal ?
[qQbB] # literal 'q' or 'b', case insensitive
\? # literal ?
.*? # encoded word
\?= # literal ?=
c ^ \ rS rSrSrSrSrU 4S jrS rU 4S jr \
S 5 r \
S 5 r S r
\
S
5 r\
S 5 rS rSS
jrSS jrSS jrSrU =r$ ) TokenList NTc 4 > [ TU ] " U0 UD6 / U l g N)super__init__defects)selfargskw __class__s r r' TokenList.__init__ s
$%"% r c 2 SR S U 5 5 $ )N c 3 8 # U H n[ U5 v M g 7fr% r .0xs r $TokenList.__str__.. ,t!s1vvt joinr) s r __str__TokenList.__str__ s ww,t,,,r c h > SR U R R [ TU ] 5 5 $ Nz{}({})formatr, __name__r& __repr__r) r, s r rC TokenList.__repr__ s+ t~~ 6 6 "W - /1 1r c 2 SR S U 5 5 $ )Nr/ c 3 ^ # U H# oR ( d M UR v M% g 7fr% r r2 s r r5 "TokenList.value.. s 81wqwws --r9 r; s r r TokenList.value s ww8888r c < [ S U 5 U R 5 $ )Nc 3 8 # U H oR v M g 7fr% ) all_defectsr2 s r r5 (TokenList.all_defects.. s 04aMM4r8 )sumr( r; s r rL TokenList.all_defects s 040$,,??r c ( U S R 5 $ Nr )startswith_fwsr; s r rR TokenList.startswith_fws s Aw%%''r c & [ S U 5 5 $ )zATrue if all top level tokens of this part may be RFC2047 encoded.c 3 8 # U H oR v M g 7fr% )
as_ew_allowed)r3 parts r r5 *TokenList.as_ew_allowed.. s 7$$%%$r8 )allr; s r rV TokenList.as_ew_allowed s 7$777r c R / nU H nUR UR 5 M U$ r% )extendcomments)r) r] tokens r r] TokenList.comments s& E OOENN + r c [ XS9$ )Npolicy)_refold_parse_treer) rb s r foldTokenList.fold s
!$66r c 4 [ U R US95 g )Nindent)printppstrr) ri s r pprintTokenList.pprint s
djjj'(r c > SR U R US95 $ )Nr rh )r: _pprl s r rk TokenList.ppstr s yy011r c # # SR UU R R U R 5 v U HH n[ US5 ( d USR U5 - v M, UR US- 5 S h vN MJ U R ( a SR U R 5 nOSnSR X5 v g NK7f)Nz{}{}/{}(rp z* !! invalid element in token list: {!r}z z Defects: {}r/ z{}){})rA r, rB
token_typehasattrrp r( )r) ri r^ extras r rp
TokenList._pp s NN # # OO E5%(( !55;VE]C D !99VF]333 <<"))$,,7EEnnV++ 4s A9C ;C. s #9DqCFFDr8 )r r: r; s r r< BareQuotedString.__str__ s BGG#9D#9 9::r c 2 SR S U 5 5 $ )Nr/ c 3 8 # U H n[ U5 v M g 7fr% r1 r2 s r r5 )BareQuotedString.value.. r7 r8 r9 r; s r r BareQuotedString.value ww,t,,,r r N) rB rx ry rz rs r< r} r r~ r r r r r s %J; - -r r c D \ rS rSrSrS rS r\S 5 r\S 5 r Sr
g) Commenti r c SR [ S/U Vs/ s H oR U5 PM snS/// 5 5 $ s snf )Nr/ r r )r: rN quoter s r r< Comment.__str__ sI wws E48 9DqZZ]D 9 E " # $ $ 9s A c UR S:X a [ U5 $ [ U5 R SS5 R SS5 R SS5 $ )Nr r r r r r r )rs r r )r) r s r r
Comment.quote# sR y (u: 5z!!$/77"%u..5g"%u/. .r c 2 SR S U 5 5 $ )Nr/ c 3 8 # U H n[ U5 v M g 7fr% r1 r2 s r r5 "Comment.content.., r7 r8 r9 r; s r r Comment.content* r r c U R /$ r% )r r; s r r] Comment.comments. s ~ r r N) rB rx ry rz rs r< r r} r r] r~ r r r r r s9 J$. - - r r c H \ rS rSrSr\S 5 r\S 5 r\S 5 rSr g) AddressListi2 z address-listc T U Vs/ s H oR S:X d M UPM sn$ s snf )Naddressrs r s r addressesAddressList.addresses6 # ;4a<<#:4;;; %%c ( [ S U 5 / 5 $ )Nc 3 \ # U H" oR S :X d M UR v M$ g7fr Nrs mailboxesr2 s r r5 (AddressList.mailboxes..< s& > !\\9%< AKK ! ,,rN r; s r r AddressList.mailboxes: ! > !>?AC Cr c ( [ S U 5 / 5 $ )Nc 3 \ # U H" oR S :X d M UR v M$ g7fr rs
all_mailboxesr2 s r r5 ,AddressList.all_mailboxes..A s& > !\\9%< $AOO !r r r; s r r AddressList.all_mailboxes? r r r N)
rB rx ry rz rs r} r r r r~ r r r r r 2 sE J
< < C C C Cr r c H \ rS rSrSr\S 5 r\S 5 r\S 5 rSr g)AddressiE r c H U S R S:X a U S R $ g )Nr grouprs display_namer; s r r Address.display_nameI s) 7 (7'' ' )r c | U S R S:X a U S /$ U S R S:X a / $ U S R $ Nr mailboxinvalid-mailboxr r; s r r Address.mailboxesN sH 7 *G9
!W
#4
4IAw r c U S R S:X a U S /$ U S R S:X a U S /$ U S R $ r r r; s r r Address.all_mailboxesV sO 7 *G9
!W
#4
4G9 Aw$$$r r N)
rB rx ry rz rs r} r r r r~ r r r r r E sA J
( ( ! ! % %r r c 8 \ rS rSrSr\S 5 r\S 5 rSrg) MailboxListi^ mailbox-listc T U Vs/ s H oR S:X d M UPM sn$ s snf )Nr r r s r r MailboxList.mailboxesb r r c V U Vs/ s H nUR S; d M UPM sn$ s snf )N)r r r r s r r MailboxList.all_mailboxesf s2 ?4a|| == 4 ? ? ?s &&r N rB rx ry rz rs r} r r r~ r r r r r ^ s- J
< < ? ?r r c 8 \ rS rSrSr\S 5 r\S 5 rSrg) GroupListil
group-listc X U ( a U S R S:w a / $ U S R $ Nr r r r; s r r GroupList.mailboxesp s+ tAw))^;IAw r c X U ( a U S R S:w a / $ U S R $ r r r; s r r GroupList.all_mailboxesv s+ tAw))^;IAw$$$r r Nr
r r r r r l s- J
! !
% %r r c H \ rS rSrSr\S 5 r\S 5 r\S 5 rSr g)Groupi} r c J U S R S:w a / $ U S R $ N r
r r; s r r Group.mailboxes s) 7 -IAw r c J U S R S:w a / $ U S R $ r r r; s r r Group.all_mailboxes s) 7 -IAw$$$r c U S R $ rQ )r r; s r r Group.display_name s Aw###r r N)
rB rx ry rz rs r} r r r r~ r r r r r } sA J
! !
% %
$ $r r c h \ rS rSrSr\S 5 r\S 5 r\S 5 r\S 5 r \S 5 r
Sr g )
NameAddri name-addrc @ [ U 5 S:X a g U S R $ N r )lenr r; s r r NameAddr.display_name s t9>Aw###r c U S R $ N
local_partr; s r r) NameAddr.local_part s Bx"""r c U S R $ r& domainr; s r r- NameAddr.domain s Bx r c U S R $ r& )router; s r r0 NameAddr.route s Bx~~ r c U S R $ r& addr_specr; s r r4 NameAddr.addr_spec s Bx!!!r r N rB rx ry rz rs r} r r) r- r0 r4 r~ r r r r r si J
$ $
# # " "r r c X \ rS rSrSr\S 5 r\S 5 r\S 5 r\S 5 r Sr
g) AngleAddri z
angle-addrc R U H! nUR S:X d M UR s $ g N addr-spec)rs r) r s r r) AngleAddr.local_part s" A||{*||# r c R U H! nUR S:X d M UR s $ g r: rs r- r s r r- AngleAddr.domain s! A||{*xx r c R U H! nUR S:X d M UR s $ g )N obs-route)rs domainsr s r r0 AngleAddr.route s" A||{*yy r c U HV nUR S:X d M UR ( a UR s $ [ UR 5 UR - s $ g)Nr; z<>)rs r) r4 r r s r r4 AngleAddr.addr_spec sF A||{*<< ;;&' 5 CC r r N) rB rx ry rz rs r} r) r- r0 r4 r~ r r r r8 r8 sU J
$ $
! !
r r8 c ( \ rS rSrSr\S 5 rSrg)ObsRoutei rA c h U Vs/ s H oR S:X d M UR PM" sn$ s snf )Nr- r> r s r rB ObsRoute.domains s) "&C$Q,,(*B$CCCr r N)rB rx ry rz rs r} rB r~ r r r rG rG s J
D Dr rG c h \ rS rSrSr\S 5 r\S 5 r\S 5 r\S 5 r \S 5 r
Sr g )
Mailboxi r c H U S R S:X a U S R $ g Nr r r r; s r r Mailbox.display_name s) 7 ,7'' ' -r c U S R $ rQ r( r; s r r) Mailbox.local_part Aw!!!r c U S R $ rQ r, r; s r r- Mailbox.domain s Aw~~ r c H U S R S:X a U S R $ g rM )rs r0 r; s r r0
Mailbox.route s' 7 ,7== -r c U S R $ rQ r3 r; s r r4 Mailbox.addr_spec s Aw r r Nr6 r r r rK rK si J
( ( " " ! ! ! !r rK c 8 \ rS rSrSr\S 5 r\=r=r=r r
Sr g)InvalidMailboxi r c g r% r r; s r r InvalidMailbox.display_name r r Nr6 r r r rY rY s/ "J
/;:J::%)r rY c : ^ \ rS rSrSrSr\U 4S j5 rSrU =r $ )Domaini r- Fc R > SR [ TU ] R 5 5 $ Nr/ r: r& r splitrD s r r-
Domain.domain wwuw}**,--r r )
rB rx ry rz rs rV r} r- r~ r r s @r r^ r^ s JM
. .r r^ c \ rS rSrSrSrg)DotAtomi dot-atomr Nr r r r rf rf s Jr rf c \ rS rSrSrSrSrg) DotAtomTexti z
dot-atom-textTr NrB rx ry rz rs rV r~ r r r ri ri s JMr ri c \ rS rSrSrSrSrg)
NoFoldLiterali zno-fold-literalFr Nrj r r r rl rl s "JMr rl c \ \ rS rSrSrSr\S 5 r\S 5 r\S 5 r \S 5 r
Sr g )
AddrSpeci r; Fc U S R $ rQ r( r; s r r) AddrSpec.local_part rQ r c @ [ U 5 S: a g U S R $ )N r' )r# r- r; s r r- AddrSpec.domain s t9q=Bx r c [ U 5 S: a U S R $ U S R R 5 U S R - U S R R 5 - $ )Nrr r r" r )r# r rstriplstripr; s r r AddrSpec.value% sU t9q=7== Aw}}##%d1gmm3DGMM4H4H4JJJr c [ U R 5 n[ U5 [ U[ -
5 : a [ U R 5 nO U R nU R
b US- U R
- $ U$ )N@)setr) r#
DOT_ATOM_ENDSr r- )r) namesetlps r r4 AddrSpec.addr_spec+ s_ doo& w<#gm 34 4 doo.B B ;; "8dkk) ) r r N) rB rx ry rz rs rV r} r) r- r r4 r~ r r r rn rn s\ JM
" "
K K
r rn c \ rS rSrSrSrSrg) ObsLocalParti7 zobs-local-partFr Nrj r r r r r 7 s !JMr r c J ^ \ rS rSrSrSr\S 5 r\U 4S j5 rSr U =r
$ ) DisplayNamei= z display-nameFc [ U 5 n[ U5 S:X a UR $ US R S:X a UR S5 OB[ US [ 5 ( a* US S R S:X a [ US SS 5 US' US R S:X a UR 5 UR $ [ US [ 5 ( a* US S R S:X a [ US S S 5 US' UR $ )Nr r r" r' )r" r# r rs pop
isinstance)r) r s r r DisplayName.display_nameB s o s8q=99 q6 & GGAJ3q69--F1I((F2"3q6!":.A r7 ' GGI
yy 3r7I..GBK**f4#CGCRL1Byyr c > SnU R ( a SnO U H nUR S:X d M SnM [ U 5 S:w a U( a S=p4U S R S:X d. [ U S [ 5 ( a U S S R S:X a SnU S R S:X d. [ U S [ 5 ( a U S S R S:X a SnU[ U R 5 - U- $ [ TU ] $ ) NFTr r r/ r r r' ) r( rs r# r r" r r r& r )r) r r4 prepostr, s r r DisplayName.valueU s <<E<eOCQ""f,47I..Q
%%/R##v-48Y//R ''61|D$5$566t; ;7= r r ) rB rx ry rz rs r| r} r r r~ r r s @r r r = s4 J
$ ! !r r c < \ rS rSrSrSr\S 5 r\S 5 rSr g) LocalPartim z
local-partFc d U S R S:X a U S R $ U S R $ )Nr r )rs r r r; s r r LocalPart.valuer s2 7 07'' '7== r c [ /n[ nSnU S [ /- H nUR S:X a M U( a; UR S:X a+ U( a$ US R S:X a [ US S 5 US' [ U[ 5 nU( aH UR S:X a8 U( a1 US R S:X a UR [ USS 5 5 OUR U5 US nUnM [ USS 5 nUR
$ )NFr r dotr' r" )DOTrs r" r r r )r) r last
last_is_tltokis_tls r r) LocalPart.local_party s e
7cU?C~~'s~~ 64H''61#D"I.B sI.E$//U2sF%%/
9SW-.
3r7D J # Ab "yyr r N)
rB rx ry rz rs rV r} r r) r~ r r r r r m s2 JM
! ! r r c J ^ \ rS rSrSrSr\U 4S j5 r\S 5 rSr U =r
$ )
DomainLiterali zdomain-literalFc R > SR [ TU ] R 5 5 $ r` ra rD s r r- DomainLiteral.domain rd r c R U H! nUR S:X d M UR s $ g )Nptextr r s r ipDomainLiteral.ip s! A||w&ww r r ) rB rx ry rz rs rV r} r- r r~ r r s @r r r s3 !JM
. . r r c \ rS rSrSrSrSrSrg) MIMEVersioni z mime-versionNr )rB rx ry rz rs majorminorr~ r r r r r s J E Er r c D \ rS rSrSrSrSrSr\S 5 r \S 5 r
Sr g) Parameteri parameterFus-asciic F U R ( a U S R $ S$ r! ) sectionednumberr; s r section_numberParameter.section_number s "& tAw~~6Q6r c U Hy nUR S:X a UR s $ UR S:X d M3 U H@ nUR S:X d M U H% nUR S:X d M UR s s s $ MB M{ g)Nr r r r/ )rs r r s r param_valueParameter.param_value sx E 7* +++ ?2 "E ''+??%*E $ / /7 :',';'; ; &+ # r r N) rB rx ry rz rs r extendedr r} r r r~ r r r r r s< JIHG
7 7
r r c \ rS rSrSrSrg)InvalidParameteri invalid-parameterr Nr r r r r r s $Jr r c ( \ rS rSrSr\S 5 rSrg) Attributei attributec r U H1 nUR R S5 ( d M% UR s $ g )Nattrtext)rs endswithr r s r r Attribute.stripped_value s- E ((44 {{" r r NrB rx ry rz rs r} r r~ r r r r r s J
# #r r c \ rS rSrSrSrSrg)Sectioni sectionNr )rB rx ry rz rs r r~ r r r r r s J
Fr r c ( \ rS rSrSr\S 5 rSrg)Valuei r c U S nUR S:X a U S nUR R S5 ( a UR $ U R $ )Nr r r" )r r zextended-attribute)rs r r r r s r r Value.stripped_value sV Q v %GE $ $D F F'' 'zzr r Nr r r r r r s J
r r c 2 \ rS rSrSrSr\S 5 rS rSr g)MimeParametersi mime-parametersFc # # 0 nU H nUR R S5 ( d M% US R S:w a M: US R R 5 nX1; a / X' X R UR
U45 M UR
5 GH u p4[ U[ S5 S9nUS S nUR nUR ( dU [ U5 S: aF US S S:X a: US S R R [ R " S5 5 US S n/ nSnU GH+ u pX:w aq U
R ( d1 U
R R [ R " S5 5 MM U
R R [ R " S5 5 US-
nU
R n U
R ( a| [ R" R% U 5 n U R' US 5 n [, R. " U 5 ( a. U
R R [ R0 " 5 5 UR U 5 GM. S
R5 U5 n X;4v GM g ! [( [* 4 a U R' S
S 5 n Nf = f! [* a! [ R" R3 U S S 9n Nf = f7f)Nr r r )keyr" z.duplicate parameter name; duplicate(s) ignoredz+duplicate parameter name; duplicate ignoredz(inconsistent RFC2231 parameter numberingsurrogateescaper zlatin-1)encodingr/ )rs r r stripr r itemssortedr r r r# r( r InvalidHeaderDefectr urllibparseunquote_to_bytesdecode LookupErrorUnicodeEncodeErrorr _has_surrogatesUndecodableBytesDefectunquoter: ) r) paramsr^ nameparts first_paramr value_partsir paramr s r r MimeParameters.params s E##,,[99Qx""k18>>'')D! ! L !5!5u = > "<<>KD5jm4E (1+K!))G ''CJN8A;!#!HQK''..v/I/IH0J K !"1IE KA).%!& !>>
,,V-G-G I.K L
,,V-G-G F.H IQ ))>>R & = =e DP$)LL:K$LE !0077 !MM 0 01N1N1P Q""5)C */D GGK(E+ g *R !,-? @ P
%*LL=N$OE P . P !' 4 4UY 4 O PsI GK J'2I?A;K?"J$!K#J$$K'(KKKKc / nU R HI u p#U( a, UR SR U[ U5 5 5 M8 UR U5 MK SR U5 nU( a SU- $ S$ )N{}={}z; r r/ )r r rA r r: )r) r r r s r r< MimeParameters.__str__3 sc ;;KD
gnnT<3F GH
d# '
6" %sV|-2-r r N)
rB rx ry rz rs r{ r} r r< r~ r r r r r s& "JO
C C J.r r c ( \ rS rSrSr\S 5 rSrg)ParameterizedHeaderValuei> Fc f [ U 5 H! nUR S:X d M UR s $ 0 $ )Nr )reversedrs r r s r r ParameterizedHeaderValue.paramsD s0 d^E #44 ||# $ r r N)rB rx ry rz r{ r} r r~ r r r r r > s O
r r c $ \ rS rSrSrSrSrSrSrg) ContentTypeiL z content-typeFtextplainr N) rB rx ry rz rs rV maintypesubtyper~ r r r r r L s JMHGr r c \ rS rSrSrSrSrSrg)ContentDispositioniS zcontent-dispositionFNr )rB rx ry rz rs rV content_dispositionr~ r r r r r S s &JM r r c \ rS rSrSrSrSrSrg)ContentTransferEncodingiY zcontent-transfer-encodingF7bitr N)rB rx ry rz rs rV r r~ r r r r r Y s ,JM
Cr r c \ rS rSrSrSrSrg) HeaderLabeli_ z header-labelFr Nrj r r r r r _ s JMr r c " \ rS rSrSrSrS rSrg)MsgIDid msg-idFc 2 [ U 5 UR - $ r% )r lineseprd s r re
MsgID.foldh s 4y6>>))r r N)rB rx ry rz rs rV re r~ r r r r r d s JM*r r c \ rS rSrSrSrg) MessageIDim z
message-idr Nr r r r r r m s Jr r c \ rS rSrSrSrg)InvalidMessageIDiq zinvalid-message-idr Nr r r r r r q s %Jr r c ( \ rS rSrSr\S 5 rSrg)
MessageIDListit zmessage-id-listc T U Vs/ s H oR S:X d M UPM sn$ s snf )Nr r r s r message_idsMessageIDList.message_idsw s# :4a<<#94:::r r N)rB rx ry rz rs r} r r~ r r r r r t s "J
; ;r r c \ rS rSrSrSrg)Headeri{ headerr Nr r r r r r { r r r c ^ \ rS rSrSrSrSrU 4S jrU 4S jrS r \
S 5 r S U 4S jjr S r
\
S 5 rS
rS rU =r$ )
Terminali Tc @ > [ TU ] X5 nX#l / Ul U$ r% )r& __new__rs r( )clsr rs r) r, s r r Terminal.__new__ s" ws*$ r c h > SR U R R [ TU ] 5 5 $ r? r@ rD s r rC Terminal.__repr__ s& t~~ 6 68H8JKKr c b [ U R R S- U R - 5 g )N/)rj r, rB rs r; s r rm Terminal.pprint s"
dnn%%+doo=>r c , [ U R 5 $ r% )listr( r; s r rL Terminal.all_defects s DLL!!r c > SR UU R R U R [ TU ] 5 U R ( d S5 /$ SR U R 5 5 /$ )Nz
{}{}/{}({}){}r/ z {})rA r, rB rs r& rC r( )r) ri r, s r rp Terminal._pp sg && NN # # OO G llB
). T\\(B r c g r% r r; s r pop_trailing_wsTerminal.pop_trailing_ws r\ r c / $ r% r r; s r r] Terminal.comments s r c 0 [ U 5 U R 4$ r% )r rs r; s r __getnewargs__Terminal.__getnewargs__ s 4y$//**r )r( rs rw )rB rx ry rz rV r| r{ r rC rm r} rL rp r r] r r~ r r s @r r r s_ M O L? " " + +r r c * \ rS rSr\S 5 rS rSrg)WhiteSpaceTerminali c gr r r; s r r WhiteSpaceTerminal.value r r c , U =( a U S [ ; $ rQ )WSPr; s r rR !WhiteSpaceTerminal.startswith_fws s &Q3&r r NrB rx ry rz r} r rR r~ r r r r r s
'r r c * \ rS rSr\S 5 rS rSrg)
ValueTerminali c U $ r% r r; s r r ValueTerminal.value s r c g)NFr r; s r rR ValueTerminal.startswith_fws s r r Nr% r r r r' r' s
r r' c * \ rS rSr\S 5 rS rSrg)EWWhiteSpaceTerminali c gr` r r; s r r EWWhiteSpaceTerminal.value s r c gr` r r; s r r< EWWhiteSpaceTerminal.__str__ s r r N)rB rx ry rz r} r r< r~ r r r r- r- s
r r- c \ rS rSrSrSrg)_InvalidEwErrori z1Invalid encoded word found while parsing headers.r N)rB rx ry rz __doc__r~ r r r r3 r3 s ;r r3 r ,zlist-separatorFry zroute-component-markerz([{}]+)r/ z[^{}]+z[\x00-\x20\x7F]c [ U 5 nU( a/ U R R [ R " U5 5 [
R " U 5 ( a0 U R R [ R " S5 5 gg)z@If input token contains ASCII non-printables, register a defect.z*Non-ASCII characters found in header tokenN)_non_printable_finderr( r r NonPrintableDefectr r r )xtextnon_printabless r _validate_xtextr; sf +51N
V 6 6~ FG U##
V : : 8 : ; $r c H U ( d g[ U S5 tp#/ nSnSn[ [ U5 5 HB nX' S:X a U( a SnSnOSnM U( a SnO
X' U; a O UR X' 5 MD WS- nSR U5 SR X'S /U- 5 U4$ )aW Scan printables/quoted-pairs until endchars and return unquoted ptext.
This function turns a run of qcontent, ccontent-without-comments, or
dtext-with-quoted-printables into a single string by unquoting any
quoted printables. It returns the string, the remaining value, and
a flag that is True iff there were any quoted printables decoded.
)r/ r/ Fr" Fr Tr/ N)
_wsp_splitterranger# r r: )r endcharsfragment remaindervcharsescapehad_qpposs r _get_ptext_to_endcharsrF s (2H
F
F
FS]# =D F
]h
&
hm$ $ Ag
776?BGGXd^$4y$@ A6 IIr c p U R 5 n[ U S[ U 5 [ U5 -
S5 nX!4$ )zFWS = 1*WSP
This isn't the RFC definition. We're using fws to represent tokens where
folding can be done, but when we are parsing the *un*folding has already
been done so we don't need to watch out for CRLF.
Nfws)rv r r# )r newvaluerH s r get_fwsrJ # s8 ||~H
U#@ @ABioodA.OC
ABi%% 0 7 7 >@ @
WWY
F F aq Y q Y #!<<a0Dj4
399;!
&44 ,. /
F GGI E@'*zz$*t2C'D$t JGJJg
7c>!$-KE IIe )$ 2 e3
%wwy! $
q$
&44 <> ?
9)
! @ / 6 6rvv >@ @@s I% %5Jc l [ 5 nU ( Gaz U S [ ; a [ U 5 u p UR U5 M5 SnU R S5 ( a [ U S5 u p Sn[
U5 S: aD US R S:w a1 UR R [ R " S5 5 SnU( a4 [
U5 S : a% US
R S :X a [ US S5 US' UR U5 M [ U S 5 tpVU( a, [ R! U5 ( a U R# S5 tpV[% US5 n[' U5 UR U5 S R) U5 n U ( a GMz U$ ! [ a Sn N[ R a Nf = f)
a unstructured = (*([FWS] vchar) *WSP) / obs-unstruct
obs-unstruct = *((*LF *CR *(obs-utext) *LF *CR)) / FWS)
obs-utext = %d0 / obs-NO-WS-CTL / LF / CR
obs-NO-WS-CTL is control characters except WSP/CR/LF.
So, basically, we have printable runs, plus control characters or nulls in
the obsolete syntax, separated by whitespace. Since RFC 2047 uses the
obsolete syntax in its specification, but requires whitespace on either
side of the encoded words, I can see no reason to need to separate the
non-printable-non-whitespace from the printable runs if they occur, so we
parse this into xtext tokens separated by WSP tokens.
Because an 'unstructured' value must by definition constitute the entire
value, this 'get' routine does not return a remaining value, only the
parsed TokenList.
r TrL utextr' rH z&missing whitespace before encoded wordFr" r r/ )r r# rJ r rN rZ r# rs r( r r r- r3 rO r= rfc2047_matchersearch partitionr' r; r: )r r r^ valid_ewhave_wsr rA rY s r get_unstructuredrc ` s . )*L
8s?"5>LE & D ! !
/w ? |$q(#B'22e;$,,33F4N4N D5F G"'s< 01 4#B'22nD+? ( ,e,5 R( ##E*'q1 ..s33 #ood 3OC c7+ E" "Q %R A #
! **
s F F3 F32F3c T [ U S5 u pn[ US5 n[ U5 X4$ )a ctext =
This is not the RFC ctext, since we are handling nested comments in comment
and unquoting quoted-pairs here. We allow anything except the '()'
characters, but if we find any ASCII other than the RFC defined printable
ASCII, a NonPrintableDefect is added to the token's defects list. Since
quoted pairs are converted to their unquoted values, what is returned is
a 'ptext' token. In this case it is a WhiteSpaceTerminal, so it's value
is ' '.
z()r )rF r r; r r _s r get_qp_ctextrg s0 -UD9OE! ug .EE <r c T [ U S5 u pn[ US5 n[ U5 X4$ )aW qcontent = qtext / quoted-pair
We allow anything except the DQUOTE character, but if we find any ASCII
other than the RFC defined printable ASCII, a NonPrintableDefect is
added to the token's defects list. Any quoted pairs are converted to their
unquoted values, so what is returned is a 'ptext' token. In this case it
is a ValueTerminal.
r r )rF r' r; re s r get_qcontentri s0 -UC8OE! % )EE <r c [ U 5 nU( d% [ R " SR U 5 5 eUR 5 nU [ U5 S n [
US5 n[ U5 X 4$ )zatext =
We allow any non-ATOM_ENDS in atext, but add an InvalidATextDefect to
the token's defects list if we find non-atext characters.
z expected atext but found '{}'Natext)_non_atom_end_matcherr rO rA r r# r' r; )r mrk s r get_atextrn si e$A %% + 2 25 9; ;
GGIE #e*+ E % )EE <r c j U ( a U S S:w a% [ R " SR U 5 5 e[ 5 nU SS n U ( a U S S:X a XSS 4$ U ( a U S S:w a U S [ ; a [ U 5 u p OU SS S:X a Sn [
U 5 u p UR R [ R " S 5 5 S
nU( aG [ U5 S: a8 US R S :X a% US
R S:X a [ US S 5 US ' O
[ U 5 u p UR U5 U ( a U S S:w a M U ( d2 UR R [ R " S5 5 X4$ XSS 4$ ! [ R a [ U 5 u p Nf = f)zbare-quoted-string = DQUOTE *([FWS] qcontent) [FWS] DQUOTE
A quoted-string without the leading or trailing white space. Its
value is the text between the quote marks, with whitespace
preserved and quoted pairs decoded.
r r zexpected '"' but found '{}'r" Nr rL Fz!encoded word inside quoted stringTr' rH r] r z"end of header inside quoted string)r rO rA r r# rJ rZ r( r r ri r# rs r- )r bare_quoted_stringr^ ra s r get_bare_quoted_stringrq s E!HO%% * 1 1% 8: :)+ !"IE qS !9,,
E!HO 8s?"5>LE5
2AY$
H
3 / 6 "**11&2L2L739 :
C 2 3a 7&r*55>*2.99^K-A*2..7&r* (.LE!!%(+ E!HO, ""))&*D*D 0+2 3!(( QRy ((! **
3 +E 2 u
3s >F !F21F2c U ( a. U S S:w a% [ R " SR U 5 5 e[ 5 nU SS n U ( ak U S S:w ab U S [ ; a [ U 5 u p O$U S S:X a [
U 5 u p O
[ U 5 u p UR U5 U ( a U S S:w a Mb U ( d2 UR R [ R " S5 5 X4$ XSS 4$ )zcomment = "(" *([FWS] ccontent) [FWS] ")"
ccontent = ctext / quoted-pair / comment
We handle nested comments here, and quoted-pair in our qp-ctext routine.
r r zexpected '(' but found '{}'r" Nr z end of header inside comment) r rO rA r r# rJ get_commentrg r r( r )r r r^ s r rs rs s
qS %% ) 0 0 79 9iG !"IE
E!HO 8s?"5>LE5
1X_&u-LE5'.LEu E!HO v 9 9 * , -~ !"I r c [ 5 nU ( a\ U S [ ; aO U S [ ; a [ U 5 u p O
[ U 5 u p UR U5 U ( a U S [ ; a MO X4$ )z,CFWS = (1*([FWS] comment) [FWS]) / FWS
r )r CFWS_LEADERr# rJ rs r )r r r^ s r get_cfwsrv sc :D
E!H + 8s?"5>LE5&u-LE E E!H + ;r c [ 5 nU ( a+ U S [ ; a [ U 5 u p UR U5 [ U 5 u p UR U5 U ( a+ U S [ ; a [ U 5 u p UR U5 X4$ )zquoted-string = [CFWS] [CFWS]
'bare-quoted-string' is an intermediate class defined by this
parser and not by the RFC grammar. It is the quoted string
without any attached CFWS.
r )r ru rv r rq )r
quoted_stringr^ s r get_quoted_stringry # s| !NM q[( U#)%0LE q[( U# r c * [ 5 nU ( a+ U S [ ; a [ U 5 u p UR U5 U ( a2 U S [ ; a% [
R " SR U 5 5 eU R S5 ( a [ U 5 u p O
[ U 5 u p UR U5 U ( a+ U S [ ; a [ U 5 u p UR U5 X4$ ! [
R a [ U 5 u p Nif = f)zHatom = [CFWS] 1*atext [CFWS]
An atom could be an rfc2047 encoded word.
r z expected atom but found '{}'rL ) r ru rv r ATOM_ENDSr rO rA rN rZ rn )r r r^ s r get_atomr| 5 s
6D q[( E qY&%% * 1 1% 8: : ,+E2LE5 !' KK q[( E ; && , %U+LE5 ,s
C. .!DDc [ 5 nU ( a
U S [ ; a% [ R " SR U 5 5 eU ( ak U S [ ; a^ [ U 5 u p UR
U5 U ( a# U S S:X a UR
[ 5 U SS n U ( a U S [ ; a M^ US [ L a( [ R " SR SU - 5 5 eX4$ )z'dot-text = 1*atext *("." 1*atext)
r z8expected atom at a start of dot-atom-text but found '{}'r r" Nr' z4expected atom at end of dot-atom-text but found '{}')ri r{ r rO rA rn r r )r
dot_atom_textr^ s r get_dot_atom_textr P s MM E!H )%% '++16%=: :
E!HI- ' U# U1X_ %!"IE E!HI- RC %% ' #VCI .0 0 r c [ 5 nU S [ ; a [ U 5 u p UR U5 U R S5 ( a [ U 5 u p O
[ U 5 u p UR U5 U ( a+ U S [ ; a [ U 5 u p UR U5 X4$ ! [ R a [ U 5 u p Nif = f)zydot-atom = [CFWS] dot-atom-text [CFWS]
Any place we can have a dot atom, we could instead have an rfc2047 encoded
word.
r rL ) rf ru rv r rN rZ r rO r )r dot_atomr^ s r get_dot_atomr c s yH Qx; 4+E2LE5 )/ OOE q[( ? && 4 -U3LE5 4s
B. .!CCc : U S [ ; a [ U 5 u pOSnU ( d [ R " S5 eU S S:X a [ U 5 u p O?U S [
; a% [ R " SR
U 5 5 e[ U 5 u p Ub U/USS& X 4$ )a` word = atom / quoted-string
Either atom or quoted-string may start with CFWS. We have to peel off this
CFWS first to determine which type of word to parse. Afterward we splice
the leading CFWS, if any, into the parsed sub-token.
If neither an atom or a quoted-string is found before the next special, a
HeaderParseError is raised.
The token returned is either an Atom or a QuotedString, as appropriate.
This means the 'word' level of the formal grammar is not represented in the
parse tree; this is because having that extra layer when manipulating the
parse tree is more confusing than it is helpful.
r Nz5Expected 'atom' or 'quoted-string' but found nothing.r z1Expected 'atom' or 'quoted-string' but found '{}')ru rv r rO ry SPECIALSrA r| )r leaderr^ s r get_wordr | s
Qx;
%% CE E Qx}(/ u qX %% '77=ve}F F
Hbq <r c " [ 5 n [ U 5 u p UR U5 U ( Ga. U S [ ; Ga U S S:X aJ UR [ 5 UR
R [ R " S5 5 U SS n O [ U 5 u p US R S:X a U( a} US R S :X aj [ US 5 S: aX US S
R S:X aB US S R S :X a, US S R ( d [ US S 5 US S' UR U5 U ( a U S [ ; a GM X4$ ! [ R a3 UR
R [ R " S5 5 GNf = f! [ R aM U S [ ; a> [ U 5 u p UR
R [ R " S
5 5 Ne f = f)a phrase = 1*word / obs-phrase
obs-phrase = word *(word / "." / CFWS)
This means a phrase can be a sequence of words, periods, and CFWS in any
order as long as it starts with at least one word. If anything other than
words is detected, an ObsoleteHeaderDefect is added to the token's defect
list. We also accept a phrase that starts with CFWS followed by a dot;
this is registered as an InvalidHeaderDefect, since it is not supported by
even the obsolete grammar.
z phrase does not start with wordr r zperiod in 'phrase'r" Nr r' r r] r rH zcomment found without atom)r r r r rO r( r PHRASE_ENDSr ObsoleteHeaderDefectrs r# r] r- ru rv )r r r^ s r
get_phraser s XF0
e E!HK/ 8S= MM# NN ! !&"="=$#&
'!"IE
' !H''>9 r
--7F2J!+ r
211^C r
211V; "2JrN 3 3 &:&*e%LF2JrN
MM% 5 E!HK/6 == " " 0 f 8 8 - / 00, **
8{*#+E?LENN))&*E*E4+6 7
s& E# B$F- #AF*)F*-A H Hc [ 5 nSnU ( a U S [ ; a
[ U 5 u p U ( d% [ R " SR U 5 5 e [
U 5 u p0Ub U/USS& UR U5 U ( a U S S:X d
U S [ ; a [ [ U5 U - 5 u p@UR S:X a0 UR R [ R " S5 5 O/UR R [ R " S5 5 XAS' UR" R% S5 X4$ ! [ R aO [ U 5 u p0 GN! [ R a& U S S:w a U S [ ; a e [ 5 n GN@f = ff = f! [& a4 UR R [ R( " S 5 5 X4$ f = f)
z@ @ #E* Hbq e %(D.E!HK$? 23z?U3J K $ $(@ @ % %f&@&@N'P
Q
% %f&A&A>'@
A&1
> ( 1 " " #E?LE5&& Qx4 E!H $; KE * >!!&"@"@;#= > >s<
E
,F0
F-
E//5F)$F-(F))F-09G.-G.c [ 5 nSnU ( Ga` U S S:X d U S [ ; GaI U S S:X aT U( a/ UR R [ R
" S5 5 UR [ 5 SnU SS n M| U S S:X aV UR [ U S S 5 5 U SS n UR R [ R
" S
5 5 SnM U( aB US R S :w a/ UR R [ R
" S
5 5 [ U 5 u p0SnUR U5 U ( a U S S:X a GM9 U S [ ; a GMI U( d% [ R " SR U 5 5 eUS R S :X d5 US R S:X aQ [ U5 S: aB US R S :X a/ UR R [ R
" S5 5 US R S :X d5 US R S:X aQ [ U5 S: aB US R S :X a/ UR R [ R
" S5 5 UR ( a SUl X4$ ! [ R a U S [ ; a e [ U 5 u p0 GNf = f)z&obs-local-part = word *("." word)
Fr r r zinvalid repeated '.'Tr" Nmisplaced-specialz/'\' character outside of quoted-string/ccontentr' r zmissing '.' between wordsz&expected obs-local-part but found '{}'r z!Invalid leading '.' in local partr] z"Invalid trailing '.' in local partr )r r r( r r r r r' rs r rO ru rv rA r# )r r last_non_ws_was_dotr^ s r r r s "^N
U1Xt^uQx{'B 8s?" &&--f.H.H*/, - ! !# &"& !"IE
1Xt^ ! !-a0C#E
F!"IE " " ) )&*D*DB+D
E"' nR 0 ; ;u D " " ) )&*D*D++-
. +#E?LE"'
e$7 U1Xt^uQx{'B8 %% 4 ; ;E BD Dq$$- 1 ( (& 0 ! # 1 ( (% / %%f&@&@ /'1 2r%%. 2 ) )6 1 ! # 2 ) )5 0 %%f&@&@ 0'2 3 $<! - && +Qx{*#E?LE5 +s 2J* */K K c [ U S5 u pn[ US5 nU( a/ UR R [ R
" S5 5 [
U5 X4$ )a dtext = / obs-dtext
obs-dtext = obs-NO-WS-CTL / quoted-pair
We allow anything except the excluded characters, but if we find any
ASCII other than the RFC defined printable ASCII, a NonPrintableDefect is
added to the token's defects list. Quoted pairs are converted to their
unquoted values, so what is returned is a ptext token, in this case a
ValueTerminal. If there were quoted-printables, an ObsoleteHeaderDefect is
added to the returned token's defect list.
z[]r z(quoted printable found in domain-literal)rF r' r( r r r r; )r r rD s r get_dtextr ) sV 2%>E& % )E
V 8 8 6 8 9E <r c U ( a gUR R [ R " S5 5 UR [ SS5 5 g)NFz"end of input inside domain-literal]domain-literal-endT)r( r r r r' )r domain_literals r _check_for_early_dl_endr = sE !!&"<"<,#. /--ABC r c [ 5 nU S [ ; a [ U 5 u p UR U5 U ( d [ R
" S5 eU S S:w a% [ R
" SR
U 5 5 eU SS n UR [ SS5 5 [ X5 ( a X4$ U S [ ; a [ U 5 u p UR U5 [ U 5 u p UR U5 [ X5 ( a X4$ U S [ ; a [ U 5 u p UR U5 [ X5 ( a X4$ U S S:w a% [ R
" S R
U 5 5 eUR [ SS
5 5 U SS n U ( a+ U S [ ; a [ U 5 u p UR U5 X4$ ) zAdomain-literal = [CFWS] "[" *([FWS] dtext) [FWS] "]" [CFWS]
r zexpected domain-literal[z6expected '[' at start of domain-literal but found '{}'r" Nzdomain-literal-startr z4expected ']' at end of domain-literal but found '{}'r ) r ru rv r r rO rA r' r r# rJ r )r r r^ s r get_domain_literalr E s #_N Qx; e$ %%&?@@ Qx3%% '!!' 0 0 !"IE--CDE u55 $$ Qx3 u~ e$ U#LE% u55 $$ Qx3 u~ e$ u55 $$ Qx3%% '!!' 0 0--ABC !"IE q[( e$ r c p [ 5 nSnU ( a U S [ ; a
[ U 5 u p U ( d% [ R " SR U 5 5 eU S S:X a* [
U 5 u p0Ub U/USS& UR U5 X4$ [ U 5 u p0U ( a U S S:X a [ R " S5 eUb U/USS& UR U5 U ( a U S S:X a UR R [ R " S5 5 US R S :X a US USS& U ( aQ U S S:X aH UR [ 5 [ U S
S 5 u p0UR U5 U ( a U S S:X a MH X4$ ! [ R a [ U 5 u p0 GNf = f) zPdomain = dot-atom / domain-literal / obs-domain
obs-domain = atom *("." atom))
Nr z expected domain but found '{}'r ry zInvalid Domainr z(domain is not a dot-atom (contains CFWS)rg r" )r^ ru rv r rO rA r r r r| r( r rs r )r r- r r^ s r
get_domainr l s
XF
F q[(
%% , 3 3E :< < Qx3)%0 E"1I
e } '#E*
qS %%&677
Hbq
MM% qS f 9 9 6 8 9 !9 : - q F1IaC MM# #E!"I.LE MM% aC =! " " ' u's
F !F54F5c T [ 5 n[ U 5 u p UR U5 U ( a U S S:w a2 UR R [ R
" S5 5 X4$ UR [
SS5 5 [ U SS 5 u p UR U5 X4$ )z'addr-spec = local-part "@" domain
r ry z#addr-spec local part with no domainaddress-at-symbolr" N)rn r r r( r r r' r )r r4 r^ s r
get_addr_specr s
I!%(LE
U E!HO !;!; 1"3 4
]3(;<= eABi(LE
U r c J [ 5 nU ( a U S S:X d
U S [ ; ap U S [ ; a [ U 5 u p UR U5 O#U S S:X a UR [ 5 U SS n U ( a U S S:X a Ma U S [ ; a Mp U ( a U S S:w a% [
R " SR U 5 5 eUR [ 5 [ U SS 5 u p UR U5 U ( a U S S:X a UR [ 5 U SS n U ( d OU S [ ; a [ U 5 u p UR U5 U ( d OQU S S:X a6 UR [ 5 [ U SS 5 u p UR U5 U ( a U S S:X a M U ( d [
R " S5 eU S S:w a% [
R " S R U 5 5 eUR [ SS
5 5 XSS 4$ ) zobs-route = obs-domain-list ":"
obs-domain-list = *(CFWS / ",") "@" domain *("," [CFWS] ["@" domain])
Returns an obs-route token with the appropriate sub-tokens (that is,
there is no obs-domain-list in the parse tree).
r r5 r" Nry z(expected obs-route domain but found '{}'z%end of header while parsing obs-route:z4expected ':' marking end of obs-route but found '{}'zend-of-obs-route-marker) rG ru rv r
ListSeparatorr rO rA RouteComponentMarkerr r' )r obs_router^ s r
get_obs_router s
I
U1Xs]eAh+&= 8{ "#E?LE U #
1X_ ] +!"IE
U1Xs]eAh+&= E!HO%% 6 = =e DF F
)* eABi(LE
U
E!HcM 'ab 8{ "#E?LE U # 8s? 1 2%eABi0LE U # E!HcM %%&MNN Qx3%% (''-ve}6 6
]3(ABC ABi r c [ 5 nU ( a+ U S [ ; a [ U 5 u p UR U5 U ( a U S S:w a% [ R
" SR
U 5 5 eUR [ SS5 5 U SS n U ( a[ U S S:X aR UR [ SS5 5 UR R [ R " S 5 5 U SS n X4$ [ U 5 u p UR U5 U ( a U S S:X a U SS n O/UR R [ R " S 5 5 UR [ SS5 5 U ( a+ U S [ ; a [ U 5 u p UR U5 X4$ ! [ R
a [ U 5 u p UR R [ R " S
5 5 O=! [ R
a& [ R
" S R
U 5 5 ef = fUR U5 [ U 5 u p GNVf = f)
zzangle-addr = [CFWS] "<" addr-spec ">" [CFWS] / obs-angle-addr
obs-angle-addr = [CFWS] "<" obs-route addr-spec ">" [CFWS]
r zangle-addr-endz null addr-spec in angle-addrz*obsolete route specification in angle-addrz.expected addr-spec or obs-route but found '{}'z"missing trailing '>' on angle-addr)
r8 ru rv r r rO rA r' r( r r r r )r
angle_addrr^ s r get_angle_addrr s(
J q[( % E!HO%% 0 7 7 >@ @mC);<= !"IE
qS --=>?!!&"<"< *#, -ab ,$U+ e qS ab !!&"<"< 0#2 3mC)9:; q[( % ) " " , P(/LE % %f&A&A<'>
?&& P))@GGNP
P P % $U+ u ,s* 5
F( (I=.= s' 3 11 a33 4 4 1 ')r )
rK r r rO r rA anyrL rs r )r r r^ s r get_mailboxr . s iGA$U+ 3 % 1 1 3 3 3 . NN5 > " " A A(/LE5&& A))188?A
A AAs
A B7*
A99:B33B7c [ 5 nU ( aj U S U; aa U S [ ; a$ UR [ U S S5 5 U SS n O [ U 5 u p0UR U5 U ( a U S U; a Ma X 4$ )zRead everything up to one of the chars in endchars.
This is outside the formal grammar. The InvalidMailbox TokenList that is
returned acts like a Mailbox, but the data attributes are None.
r r r" N)rY r r r' r )r r? invalid_mailboxr^ s r get_invalid_mailboxr C s %&O
E!HH, 8{ " " "=q1D$F
G!"IE%e,LE " "5 ) E!HH, !!r c [ 5 nU ( a U S S:w a [ U 5 u p UR U5 U ( ac U S S; aZ US nS Ul [ U S5 u p UR U5 UR R [ R " S5 5 U ( a# U S S:X a UR [ 5 U S
S n U ( a U S S:w a M X4$ ! [ R Ga_ SnU S [
; a [
U 5 u p0U ( a U S S; aC UR U5 UR R [ R " S5 5 GN-[ U S5 u p Ub U/USS& UR U5 UR R [ R " S5 5 GNU S S:X a2 UR R [ R " S5 5 GN[ U S5 u p Ub U/USS& UR U5 UR R [ R " S5 5 GN f = f) a) mailbox-list = (mailbox *("," mailbox)) / obs-mbox-list
obs-mbox-list = *([CFWS] ",") mailbox *("," [mailbox / CFWS])
For this routine we go outside the formal grammar in order to improve error
handling. We recognize the end of the mailbox list only at the end of the
value or at a ';' (the group terminator). This is so that we can turn
invalid mailboxes into InvalidMailbox tokens and continue parsing any
remaining valid mailboxes. We also allow all mailbox entries to be null,
and this condition is handled appropriately at a higher level.
r ;Nz,;z empty element in mailbox-listz invalid mailbox in mailbox-listr5 r' r r" )r r r r rO ru rv r( r r r rs r\ r )r mailbox_listr^ r r s r get_mailbox_listr U s( =L
E!HO 8&u-LE &4 U1XT) #2&G!2G .ud;LE NN5 ! ' '(B(B1)3
4 U1X_
.!"IEQ E!HOR K && 8FQx;& (
aD 0 ''/ ((//0K0K719 : $7ud#CLE )%+Hbq ''. ((//0J0J91; <qS $$++F,G,G3-5 6 35$ ? %!'E"1I ##E* $$++F,F,F5-7 8/ 8s& C# #BI'AI8I >u EG G LL s$678 !"IE q[(
U <r c $ [ 5 n [ U 5 u p UR
U5 X4$ ! [ R aN [ U 5 u p N8! [ R a& [ R " SR U 5 5 ef = ff = f)a address = mailbox / group
Note that counter-intuitively, an address can be either a single address or
a list of addresses (a group). This is why the returned Address object has
a 'mailboxes' attribute which treats a single address as a list of length
one. When you need to differentiate between to two cases, extract the single
element, which is either a mailbox or a group token.
z expected address but found '{}')r r r rO r rA r )r r r^ s r get_addressr s " iGA ' NN5 > " " A A&u-LE5&& A))188?A
A AAs
- B
A:B Bc [ 5 nU ( a [ U 5 u p UR U5 U ( aa U S S:w aX [ U S5 u p UR [ U/5 5 UR R [ R " S5 5 U ( a UR [ 5 U SS n U ( a M X4$ ! [ R Gas SnU S [
; a [
U 5 u p0U ( a U S S:X aC UR U5 UR R [ R " S5 5 GN[ U S5 u p Ub U/USS& UR [ U/5 5 UR R [ R " S5 5 GN}U S S:X a2 UR R [ R " S5 5 GN[ U S5 u p Ub U/USS& UR [ U/5 5 UR R [ R " S5 5 GN f = f)a address_list = (address *("," address)) / obs-addr-list
obs-addr-list = *([CFWS] ",") address *("," [address / CFWS])
We depart from the formal grammar here by continuing to parse until the end
of the input, assuming the input to be entirely composed of an
address-list. This is always true in email parsing, and allows us
to skip invalid addresses to parse additional valid ones.
Nr r5 z"address-list entry with no contentz invalid address in address-listz empty element in address-listr" )
r r r r rO ru rv r( r r r r r )r address_listr^ r s r get_address_listr s =L
8&u-LE &4 U1X_ /uc:LE 0 1 ' '(B(B1)3
4
.!"IEM %N G && 8FQx;& (
aC ''/ ((//0K0K<1> ? $7uc#BLE )%+Hbq ''(89 ((//0J0J91; <qS $$++F,G,G3-5 6 35# > %!'E"1I ##GUG$45 $$++F,F,F5-7 8/ 8s& C BI
A!I.8I)A!I
Ic [ 5 nU ( d% [ R " SR U 5 5 eU S S:w a% [ R " SR U 5 5 eUR [ SS5 5 U SS n [
U 5 u p UR U5 U ( a U S S:w a% [ R " S R U 5 5 eUR [ SS
5 5 XSS 4$ ) z%no-fold-literal = "[" *dtext "]"
z'expected no-fold-literal but found '{}'r r z;expected '[' at the start of no-fold-literal but found '{}'zno-fold-literal-startr" Nr z9expected ']' at the end of no-fold-literal but found '{}'zno-fold-literal-end)rl r rO rA r r' r )r no_fold_literalr^ s r get_no_fold_literalr # s $oO %% 5 < " [CFWS]
id-left = dot-atom-text / obs-id-left
id-right = dot-atom-text / no-fold-literal / obs-id-right
no-fold-literal = "[" *dtext "]"
r r z expected msg-id but found '{}'z msg-id-startr" Nzobsolete id-left in msg-idz4expected dot-atom-text or obs-id-left but found '{}'ry zmsg-id with no id-rightr z
msg-id-endr zobsolete id-right in msg-idzFexpected dot-atom-text, no-fold-literal or obs-id-right but found '{}'z missing trailing '>' on msg-id)r ru rv r r rO rA r' r r r( r r r r )r msg_idr^ s r
get_msg_idr 9 s WF q[(
e E!HO%% , 3 3E :< <
MM-^45 !"IE 1(/ MM% E!HO f 8 8 % ' (
U1X_ MM-\: ;!"IE}
MM-%89: !"IE
5(/ MM% qS ab f 8 8 , . /
MM-\23 q[(
e =a " " 1 1-e4LE NN ! !&"="=,#.
/&& 1))""(&-1
1 1
14 " " 5
5.u5LE5&& 5
5 )% 0 %%f&A&A1'3 4 4**
5 --&&,fUm5 5
5 5 5sT
G7
J 7J UR R [ R
" SR
U 5 5 5 U$ ! [ R a_ n[ U 5 n[ U5 nUR R [ R
" SR
U5 5 5 SnAU$ SnAff = f)z2message-id = "Message-ID:" msg-id CRLF
zUnexpected {!r}Invalid msg-id: {!r}N)
r r r r( r r rA rO rc r )r
message_idr^ exs r parse_message_idr ~ s J 2!%( % % %f&@&@!((/'1
2 " " K '%e,
!! & &'='D'DR'H I K K Ks A1 1C$AC C$c 6 [ 5 nU ( a U S S:X aQ UR R [ R " S5 5 UR [ SS5 5 U SS n Ma [
U 5 u p UR U5 U ( a M U$ ! [ R an n[ U 5 nUR [ U5 5 UR R [ R " SR U5 5 5 SnAU$ SnAff = f) zain-reply-to = "In-Reply-To:" 1*msg-id CRLF
references = "References:" 1*msg-id CRLF
r r5 zcomma in msg-id listr zinvalid-comma-replacementr" Nr ) r r( r r r r r rO rc r rA )r message_id_listr^ r s r parse_message_idsr s $oO
8s?
# # * ***+AB
D " ""3(CD
F!"IE %e,LE " "5 ) %&
&& $U+E " "#3E#: ; # # * ***+A+H+H+LM
O
s - B D*A#DDc 0 [ 5 nU ( d1 UR R [ R " S5 5 U$ U S [
; aT [
U 5 u p UR U5 U ( d/ UR R [ R " S5 5 SnU ( aA U S S:w a8 U S [
; a+ X0S -
nU SS n U ( a U S S:w a U S [
; a M+ UR 5 ( dZ UR R [ R " SR U5 5 5 UR [ US 5 5 O+[ U5 Ul UR [ US
5 5 U ( a+ U S [
; a [
U 5 u p UR U5 U ( a U S S:w a` UR b/ UR R [ R " S 5 5 U ( a UR [ U S 5 5 U$ UR [ SS 5 5 U SS n U ( a+ U S [
; a [
U 5 u p UR U5 U ( d> UR b/ UR R [ R " S 5 5 U$ SnU ( a/ U S [
; a" X0S -
nU SS n U ( a U S [
; a M" UR 5 ( dZ UR R [ R " S
R U5 5 5 UR [ US 5 5 O+[ U5 Ul
UR [ US
5 5 U ( a+ U S [
; a [
U 5 u p UR U5 U ( aJ UR R [ R " S5 5 UR [ U S 5 5 U$ )zDmime-version = [CFWS] 1*digit [CFWS] "." [CFWS] 1*digit [CFWS]
z%Missing MIME version number (eg: 1.0)r z0Expected MIME version number but found only CFWSr/ r r" Nz1Expected MIME major version number but found {!r}r9 digitsz0Incomplete MIME version; found only major numberzversion-separatorz1Expected MIME minor version number but found {!r}z'Excess non-CFWS text after MIME version)r r( r r HeaderMissingRequiredValueru rv isdigitr rA r' intr r )r mime_versionr^ r s r parse_mime_versionr sj =L ##F$E$E 3%5 6 Qx; E" ' '(I(IB)D
E
F
E!HOa (C(ab E!HOa (C >> ##F$>$> ? F Fv N%P QM&' :; [ M&( ;< q[( E" E!HO ) ' '(B(BB)D
E
eW = >
c+>?@ !"IE q[( E" ) ' '(B(BB)D
E
F
E!HK/(ab E!HK/ >> ##F$>$> ? F Fv N%P QM&' :; [ M&( ;< q[( E" ##F$>$> 5%7 8M% 9: r c [ 5 nU ( aj U S S:w aa U S [ ; a$ UR [ U S S5 5 U SS n O [ U 5 u p UR U5 U ( a U S S:w a Ma X4$ )zRead everything up to the next ';'.
This is outside the formal grammar. The InvalidParameter TokenList that is
returned acts like a Parameter, but the data attributes are None.
r r r r" N)r r r r' r )r invalid_parameterr^ s r get_invalid_parameterr s )*
E!HO 8{ " $ $]583F&H
I!"IE%e,LE $ $U + E!HO ##r c [ U 5 nU( d% [ R " SR U 5 5 eUR 5 nU [ U5 S n [
US5 n[ U5 X 4$ )a$ ttext =
We allow any non-TOKEN_ENDS in ttext, but add defects to the token's
defects list if we find non-ttext characters. We also register defects for
*any* non-printables even though the RFC doesn't exclude all of them,
because we follow the spirit of RFC 5322.
z expected ttext but found '{}'Nttext)_non_token_end_matcherr rO rA r r# r' r; )r rm r s r get_ttextr
si u%A %% + 2 25 9; ;
GGIE #e*+ E % )EE <r c [ 5 nU ( a+ U S [ ; a [ U 5 u p UR U5 U ( a2 U S [ ; a% [
R " SR U 5 5 e[ U 5 u p UR U5 U ( a+ U S [ ; a [ U 5 u p UR U5 X4$ )ztoken = [CFWS] 1*ttext [CFWS]
The RFC equivalent of ttext is any US-ASCII chars except space, ctls, or
tspecials. We also exclude tabs even though the RFC doesn't.
The RFC implies the CFWS but is not explicit about it in the BNF.
r expected token but found '{}') r ru rv r
TOKEN_ENDSr rO rA r )r mtokenr^ s r get_tokenr s WF q[(
e qZ'%% + 2 25 9; ; U#LE
MM% q[(
e =r c [ U 5 nU( d% [ R " SR U 5 5 eUR 5 nU [ U5 S n [
US5 n[ U5 X 4$ )a= attrtext = 1*(any non-ATTRIBUTE_ENDS character)
We allow any non-ATTRIBUTE_ENDS in attrtext, but add defects to the
token's defects list if we find non-attrtext characters. We also register
defects for *any* non-printables even though the RFC doesn't exclude all of
them, because we follow the spirit of RFC 5322.
z expected attrtext but found {!r}Nr )_non_attribute_end_matcherr rO rA r r# r' r; r rm r s r get_attrtextr 4 si #5)A %% . 5 5e <> >wwyH #h-. !E Xz2HH ?r c [ 5 nU ( a+ U S [ ; a [ U 5 u p UR U5 U ( a2 U S [ ; a% [
R " SR U 5 5 e[ U 5 u p UR U5 U ( a+ U S [ ; a [ U 5 u p UR U5 X4$ )a3 [CFWS] 1*attrtext [CFWS]
This version of the BNF makes the CFWS explicit, and as usual we use a
value terminal for the actual run of characters. The RFC equivalent of
attrtext is the token characters, with the subtraction of '*', "'", and '%'.
We include tab in the excluded set just as we do for token.
r r ) r ru rv r ATTRIBUTE_ENDSr rO rA r r r r^ s r
get_attributer G s I q[( q^+%% + 2 25 9; ; &LE
U q[( r c [ U 5 nU( d% [ R " SR U 5 5 eUR 5 nU [ U5 S n [
US5 n[ U5 X 4$ )zattrtext = 1*(any non-ATTRIBUTE_ENDS character plus '%')
This is a special parsing routine so that we get a value that
includes % escapes as a single string (which we decode as a single
string later).
z)expected extended attrtext but found {!r}Nextended-attrtext)#_non_extended_attribute_end_matcherr rO rA r r# r' r; r s r get_extended_attrtextr ^ sl ,E2A %% 7 > >u EG GwwyH #h-. !E X':;HH ?r c [ 5 nU ( a+ U S [ ; a [ U 5 u p UR U5 U ( a2 U S [ ; a% [
R " SR U 5 5 e[ U 5 u p UR U5 U ( a+ U S [ ; a [ U 5 u p UR U5 X4$ )z[CFWS] 1*extended_attrtext [CFWS]
This is like the non-extended version except we allow % characters, so that
we can pick up an encoded value as a single string.
r r ) r ru rv r EXTENDED_ATTRIBUTE_ENDSr rO rA r r s r get_extended_attributer p s I q[( q 44%% + 2 25 9; ;(/LE
U q[( r c [ 5 nU ( a U S S:w a% [ R " SR U 5 5 eUR [ SS5 5 U SS n U ( a U S R
5 ( d% [ R " SR U 5 5 eSnU ( aE U S R
5 ( a- X S -
nU SS n U ( a U S R
5 ( a M- US S :X a5 US :w a/ UR R [ R " S
5 5 [ U5 Ul
UR [ US 5 5 X4$ ) a! '*' digits
The formal BNF is more complicated because leading 0s are not allowed. We
check for that and add a defect. We also assume no CFWS is allowed between
the '*' and the digits, though the RFC is not crystal clear on that.
The caller should already have dealt with leading CFWS.
r *z Expected section but found {}zsection-markerr" Nz$Expected section number but found {}r/ 0z'section number has an invalid leading 0r ) r r rO rA r r' r r( r r r )r r r s r get_sectionr s7 iG E!HO%%&E&L&L(-'/ 0 0 NN=&678 !"IE a((**%% '117 @ @
F
E!H$$&&(ab E!H$$&& ayCFcM v 9 99 ; <[GN NN=23 >r c b [ 5 nU ( d [ R " S5 eSnU S [ ; a
[ U 5 u p U ( d% [ R " SR U5 5 eU S S:X a [
U 5 u p0O
[ U 5 u p0Ub U/USS& UR U5 X4$ )z quoted-string / attribute
z&Expected value but found end of stringNr z Expected value but found only {}r ) r r rO ru rv rA ry r r )r vr r^ s r get_valuer s A %%&NOO
F Qx;
%% '006v@ @ Qx3(/ u-e4
Hbq HHUO 8Or c & [ 5 n[ U 5 u p UR U5 U ( a U S S:X aA UR R [ R
" SR
U5 5 5 X4$ U S S:X as [ U 5 u p SUl UR U5 U ( d [ R " S5 eU S S:X a' UR [ SS5 5 U SS n SUl U S S
:w a [ R " S 5 eUR [ S
S 5 5 U SS n U ( a+ U S [ ; a [ U 5 u p UR U5 S nUnUR ( Ga$ U ( Ga U S S
:X Ga [ U 5 u pSUR nSnUR S:X a3 U( a US S:X a SnO7[# U5 u p(U( a US S:X a SnO [% U5 u p(U( d SnU( ae UR R [ R
" S5 5 UR U5 U H n U R& S:X d M / U S S & U n O Un O1S nUR R [ R
" S5 5 U ( a U S S:X a S nO
[) U 5 u p UR ( a UR S: af U ( a U S S:w a' UR U5 Ub U ( a U 5 eUn X4$ UR R [ R
" S5 5 U ( dH UR R [ R
" S5 5 UR U5 Uc X4$ GO1UbL U H n U R& S:X d M O W R& S:H UR U 5 U R* Ul U S S:w a% [ R " SR
U 5 5 eUR [ SS5 5 U SS n U ( am U S S:w ad [# U 5 u p UR U5 UR* Ul U ( a U S S:w a% [ R " SR
U 5 5 eUR [ SS5 5 U SS n Ubq [1 5 n
U ( a] U S [2 ; a [5 U 5 u p O(U S S
:X a [ S
S5 nU SS n O
[7 U 5 u p U
R U5 U ( a M] U
nO
[) U 5 u p UR U5 Ub U ( a U 5 eUn X4$ ! [ R a GNf = f! GN= f)aD attribute [section] ["*"] [CFWS] "=" value
The CFWS is implied by the RFC but not made explicit in the BNF. This
simplified form of the BNF from the RFC is made to conform with the RFC BNF
through some extra checks. We do it this way because it makes both error
recovery and working with the resulting parse tree easier.
r r z)Parameter contains name ({}) but no valuer TzIncomplete parameterzextended-parameter-markerr" N=z Parameter not followed by '='parameter-separatorr F'z5Quoted string value for extended parameter is invalidr zZParameter marked as extended but appears to have a quoted string value that is non-encodedzcApparent initial-extended-value but attribute was not marked as extended or was not initial sectionz(Missing required charset/lang delimitersr r z=Expected RFC2231 char/lang encoding delimiter, but found {!r}zRFC2231-delimiterz;Expected RFC2231 char/lang encoding delimiter, but found {}DQUOTE) r r r r( r r rA r r rO r' r ru rv ry r r r r rs r r r r r r# rJ ri ) r r r^ rA appendtoqstring inner_value
semi_validrW tr s r
get_parameterr
s
KE 'LE LL E!HO
V 7 7 9%%+VE] 4 5| Qx3 &u-LE "EO LL ))*@A A 8s? LL s,GH I!"IE !EN Qx3%%&EFF LL s$9:; !"IE q[(
UIH ~~~%E!HO /u 5 ,,
1 ${1~ 4 !
*; 7 DGsN!%J
& 3K @ !%J MM !;!;G"I
J LL ! <<#77 AaD H
E I MM !;!;:";
<
qS ' >>U 1 1A 5aC OOE "$ '%'y!<
V 7 7
D E F
V 7 7 6 8 9 < <<#66
LLJ & OOA GGEM 8s?)) +FFLfUmU
U
c+>?@ab U1X_'.LE OOE " EJE!HO -- /<?@ab GQx3 &u~ uqS %c84 ab +E 2
HHUO e ' OOE % y <i && D
s %U0 .
V 0VV Vc [ 5 nU ( a [ U 5 u p UR U5 U ( aq U S S:w ah US nSUl [ U 5 u p UR U5 UR R [ R " SR U5 5 5 U ( a UR [ SS 5 5 U S
S n U ( a M U$ ! [ R a SnU S [
; a
[
U 5 u p0U ( d UR U5 Us $ U S S:X aF Ub UR U5 UR R [ R " S5 5 GNE[ U 5 u p U( a U/USS& UR U5 UR R [ R " SR U5 5 5 GNf = f) a parameter *( ";" parameter )
That BNF is meant to indicate this routine should only be called after
finding and handling the leading ';'. There is no corresponding rule in
the formal RFC grammar, but it is more convenient for us for the set of
parameters to be treated as its own TokenList.
This is 'parse' routine because it consumes the remaining value, but it
would never be called to parse a full header. Instead it is called to
parse everything after the non-parameter value of a specific MIME header.
Nr r z parameter entry with no contentzinvalid parameter {!r}r' r z)parameter with invalid trailing text {!r}r r" )r r
r r rO ru rv r( r r rA rs r\ r' )r mime_parametersr^ r r s r parse_mime_parametersr G
s %&O
=(/LE " "5 )( U1X_ $B'E 2E 07LE LL # # * *6+E+E;BB5I,K
L " "=6K#L M!"IEG %H A && =FQx;& (
&&v.&&Qx3%#**62 ''..v/I/I507 8 5U ; !'E"1I &&u- ''..v/I/I,33E:0< =# =s C A
G#'A G#6A)G#"G#c f U( aj US S:w aa US [ ; a$ U R [ US S5 5 USS nO [ U5 u p!U R U5 U( a US S:w a Ma U( d gU R [ SS5 5 U R [ USS 5 5 g)zBDo our best to find the parameters in an invalid MIME header
r r r r" Nr )r r r' r r ) tokenlistr r^ s r _find_mime_parametersr {
s E!HO 8{ " ]585H I J!"IE%e,LE U #
E!HO
]3(=>?
*5956r c f [ 5 nU ( d1 UR R [ R " S5 5 U$ [ U 5 u p UR U5 U ( a U S S:w aC UR R [ R " S5 5 U ( a [ X5 U$ UR R 5 R 5 Ul
UR [ SS5 5 U SS n [ U 5 u p UR U5 UR R 5 R 5 Ul U ( d U$ U S S
:w aO UR R [ R " S R U 5 5 5 U?
U?[ X5 U$ UR [ S
S 5 5 UR [! U SS 5 5 U$ ! [ R aN UR R [ R " SR U 5 5 5 [ X5 Us $ f = f! [ R aN UR R [ R " S R U 5 5 5 [ X5 Us $ f = f)
zmaintype "/" subtype *( ";" parameter )
The maintype and substype are tokens. Theoretically they could
be checked against the official IANA list + x-token, but we
don't do that.
z"Missing content type specificationz(Expected content maintype but found {!r}r r zInvalid content typezcontent-type-separatorr" Nz'Expected content subtype but found {!r}r z > 0 2 3 '
LL E!HO
V 7 7 " $ % !% / [[&&(..0EN LL s$<=> !"IE '
LLKK%%'--/EM Qx3
V 7 7
( )
NEM e+ LL s$9:; LL&uQRy12 LQ " "
V 7 7 6 = =e D F G e+ & " "
V 7 7 5 < .< s' . ,q a!>!>?? ,r unknown-8bitTr ra r' r r r r r r r )$max_line_lengthsysmaxsizeutf8r r r r rs
SPECIALSNL
isdisjointNLSETr r r rL _fold_mime_parametersrV r{ re r# r r! r rt _fold_as_ewr| boolr _WSPrR r' r r insertr: )
parse_treerb maxlenr r last_word_is_ewlast_ew last_charsetr$
want_encodingend_ew_not_allowedr rW tstrr encoded_partnewlinenewpartsps r rc rc s
#
#
2s{{F ++w:H
DEOGLM!"&:; E
yy| % ! # 4y "44$.$9$9$$? ?
%*$4$4T$: :
! KK ! G ?? / / !$v @ #O !3%% %
''#'99F9#;Q=Q#RL ~~\9 |,vE"I/FF&CE&JG !LL 1 b \1 */
4** T
U* %
## '+!^3!W,J1F "G%++# #' & %
%
t9U2Y / / "I I - Ld4::d;K6L2LO
D A
'3E:G$--// Wt^,#2 $G+/b 0E+F'F tX&&DzH"66
#301 &( & ##4Q#7A &(( #3012
)+"301 '( & / ##9!#> u % 66{ " ! . , ,. . .( " M !~( (s T % T971T> 2T65T6c Ub0 U( a) [ [ US US U - 5 5 n US SU US' OU( aE [ US R [ 5 5 nUS US nUS SU U( a SOS- US' X- n OPU S [
; aC U S n U SS n [ US 5 U:X a UR
[ U5 5 US== U -
ss' Sn
U S [
; a
U S n
U SS n Uc [ US 5 OUn US:X a SOUn [ U 5 S - n
U
S- U: a [ R " S
5 eU ( a U[ US 5 -
nX-
nUS:: a5 [ U5 nUR
U=( d S5 [ US 5 n MW U SU n[ R " UU S 9n[ U5 U-
nUS: a0 USS n[ R " UU S 9n[ U5 U-
nUS: a M0 US== U-
ss' U [ U5 S n U ( a UR
S5 [ US 5 n U ( a M US== U
-
ss' U( a U $ S$ ) a Fold string to_encode into lines as encoded word, combining if allowed.
Return the new value for last_ew, or None if ew_combine_allowed is False.
If there is already an encoded word in the last line of lines (indicated by
a non-None value for last_ew) and ew_combine_allowed is true, decode the
existing ew, combine it with to_encode, and re-encode. Otherwise, encode
to_encode. In either case, split to_encode as necessary so that the
encoded segments fit within maxlen.
Nr' r r/ r r" r r# z3max_line_length is too small to fit an encoded word)r ) r rc r# ru r2 r# r r! r rO rQ r ) to_encoder r5 r7 r| r r6 len_without_wspleading_whitespace leading_wsp trailing_wsp new_last_ew encode_as
chrome_lenremaining_space
text_spacer= to_encode_word encoded_wordexcesss r r0 r0 s 1 U2Ywx 09 < =? "Ihw'b
eBi . .t 45 "2Y'7 82Y /0 1r;b &2 1 l abM b Nf $ LL6u= >
b [ L} } crN $+O#eBi.K"j0gI Y !#JQ6!%% AC C 3uRy>1$1
?3E:G LL C ( eBi.K ";J/zz.)D \"_4qj ,CR 0N ::niHL & 8F qj b \! c. 1 23 LL eBi.K/ )0
"I I,;6$6r c @ U R GH u pEUS R 5 R S5 ( d
US== S-
ss' UnSn UR U5 SnU( a2 [ R R US US
9n S R XFU 5 n
OS R U[ U5 5 n
[ US 5 [ U
5 - S
- U: a US S- U
- US' M [ U
5 S- U:: a UR SU
- 5 M Sn US- n U( d GM [ U5 [ [ U 5 5 - S- [ U 5 - n
X-S- :: a SnX--
S-
=p USU n[ R R US US
9n [ U 5 U:: a OUS
- nM; UR SR XKX5 5 S n U S
-
n X^S nU( a
US== S-
ss' U( a M GM g! [ a* Sn[
R " U5 ( a SnSn GNSn GNf = f)a* Fold TokenList 'part' into the 'lines' list as mime parameters.
Using the decoded list of parameters and values, format them according to
the RFC rules, including using RFC2231 encoding if the value cannot be
expressed in 'encoding' and/or the parameter+value is too long to fit
within 'maxlen'.
r' r strictFTr' r r# r/ )safer z
{}*={}''{}r r" r r r z''rr N Nz {}*{}*={}{})r ru r r r r r r r r rA r r# r r )rW r r5 r r r r
error_handlerencoding_required
encoded_valuer; r extra_chromerI
splitpointmaxcharspartials r r/ r/ s: {{ Ry !**3// "I I
" LL " % "LL . .B} / 6M &&tmDD>>$ U(;CI % )F 2 b C$.E"I
Y]f
$ LLt $ ~ e TSW %66:S =NNJa '
$*$7!$; ;J , & 2 2"] !3 !<
}%1a
LL ..|<
= L qLG+&Eb S - eI # " " $ $$U++( 1
!
"s G))+H H H )rY )r4 rer) r stringr operatorr emailr rQ r r r2 rz r# ru r r{ r{ r TSPECIALSr ASPECIALSr r r. r, r r r compileVERBOSE MULTILINEr^ r r" r r r r r r r r r r r r r r r r r r8 rG rK rY r^ rf ri rl rn r r r r r r r r r r r r r r r r r r r r r r r r r' r- rO r3 r r rV r{ r rA r: rb r= rC matchrl findallr7 r r r r; rF rJ rZ rc rg ri rn rq rs rv ry r| r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r
r r r r r r! rc r0 r/ r r r re s< CJ
'
$iCHn sN CH$
U#
E
"c#h .
_
E
" S (3s83
t
@
1 ** ZZ",, @, @,FD) D I Y 9 " 9 I
) #9 #6 -| - ! 4C) C&%i %2 ?) ? % %"$I $*"y "6 DDy D!i !6;Y ;.Y . i )
I
y B9 -!& -!`! !H
I
) 8%y %
# #i I S.Y S.l y * 1 i )
*I * &y &;I ;Y (+s (+V' 'H - > I$4$4IIbggj!"%$ %%*U ZZ (8(8IIbggn%&)( )). &(jj1A1AIIbgg-./21 '227% $; J@
/bAF"
()T 2 $6 &2 D.`% N2!h(%!N$L ) V, \ " H*"$6 r# J <:2 j&,BJ(DBH$$&.& .$ ,<,KZ2h7 6p < ^]7~L7\I!r