*jS S r / SQrSSKrSSKrSSKrSSKrSSKJr SSKJ r J
r
SSK J r SSK
Jr SrS r\R" " S
5 r\R" " S \R& 5 r\R" " S 5 r\R" " S
5 r " S S5 r " S S\5 rSr " S S\5 r\" \ " \R: S-
5 5 r S\ - r \R@ r g)z:Classes to generate plain text from a message object tree.) GeneratorDecodedGeneratorBytesGenerator N)deepcopy)StringIOBytesIO)_has_surrogates)HeaderWriteError_
z
\r\n|\r|\nz^From z \r\n[^ \t]|\r[^ \n\t]|\n[^ \t]s \r\n[^ \t]|\r[^ \n\t]|\n[^ \t]c \ rS rSrSrSSS.S jjrS rSS jrS rS r S
r
S r S r S
r
S rS r\rS rS rS rS r\SS j5 r\S 5 rSrg)r z~Generates output from a Message object tree.
This basic generator writes the message to the given file object as plain
text.
Npolicyc \ Uc Uc SO UR nXl X l X0l X@l g)a Create the generator for message flattening.
outfp is the output file-like object for writing the message to. It
must have a write() method.
Optional mangle_from_ is a flag that, when True (the default if policy
is not set), escapes From_ lines in the body of the message by putting
a `>' in front of them.
Optional maxheaderlen specifies the longest length for a non-continued
header. When a header line is longer (in characters, with tabs
expanded to 8 spaces) than maxheaderlen, the header will split as
defined in the Header class. Set maxheaderlen to zero to disable
header wrapping. The default is 78, as recommended (but not required)
by RFC 5322 section 2.1.1.
The policy keyword specifies a policy object that controls a number of
aspects of the generator's operation. If no policy is specified,
the policy associated with the Message object passed to the
flatten method is used.
NT) mangle_from__fp
_mangle_from_ maxheaderlenr )selfoutfpr r r s 6/opt/alt/python313/lib64/python3.13/email/generator.py__init__Generator.__init__& s1 2 #)>4v7J7JL ) ( c : U R R U5 g N)r writer ss r r Generator.writeF s qr c U R c UR O U R nUb UR US9nU R b UR U R S9nUR U l U R U R 5 U l SU l U R U R 5 U l U R nUR n X@l XAl U( a` UR 5 nU( d, S[ R " [ R " 5 5 - nU R XpR - 5 U R U5 XPl Xal g! XPl Xal f = f)a Print the message object tree rooted at msg to the output file
specified when the Generator instance was created.
unixfrom is a flag that forces the printing of a Unix From_ delimiter
before the first object in the message tree. If the original message
has no From_ delimiter, a `standard' one is crafted. By default, this
is False to inhibit the printing of any From_ delimiter.
Note that for subobjects, no From_ line is printed.
linesep specifies the characters used to indicate a new line in
the output. The default value is determined by the policy specified
when the Generator instance was created or, if none was specified,
from the policy associated with the msg.
N)linesepmax_line_length z From nobody )r cloner r# _NL_encode _encoded_NL_EMPTY_encoded_EMPTY get_unixfromtimectimer _write)r msgunixfromr# r old_gen_policyold_msg_policyufroms r flattenGenerator.flattenJ s * ${{ 2 \\'\2F (\\$2C2C\DF>> <<1 "ll4;; 7
( K J((* *TZZ -D DE
588+, KK (K'J )K'Js
BE E.c N U R UU R SU R S9$ )z1Clone this generator with the exact same options.Nr ) __class__r r )r fps r r' Generator.clone{ s- ~~b " 0 0 "%)[[ 2 2r c [ 5 $ r )r r s r _new_bufferGenerator._new_buffer s
zr c U$ r r s r r) Generator._encode s r c U( d g [ R U5 nUS S H/ nU R U5 U R U R 5 M1 US ( a U R US 5 g g )N)NLCREsplitr r( )r lineslines r _write_linesGenerator._write_lines s` E"#2JD JJt JJtxx 9 JJuRy ! r c * U R n S U l U R 5 =U l nU R U5 X l U R nU ?U( aP [ U5 nUR S5 c US US' OUR
SUS 5 UR
SUS 5 [ USS 5 nUc U R U5 OU" U 5 U R R UR 5 5 g ! X l U R nU ?f = f)Ncontent-transfer-encodingr Content-Transfer-Encoding content-type _write_headers) r
_munge_cter> _dispatchr getreplace_headergetattrrP r getvalue)r r1 oldfpsfp munge_ctemeths r r0 Generator._write s "DO ! - - / /DHs NN3 H I 3-Cww23;3 ! M ~y| < s ,d3 < $ J s||~&' H Is /C< <Dc ( UR 5 nUR 5 n[ R X#45 R SS5 n[ U SU- S 5 nUc1 UR SS5 n[ U SU- S 5 nUc U R nU" U5 g )N-r _handle_)get_content_maintypeget_content_subtype
UNDERSCOREjoinreplacerU
_writeBody)r r1 mainsubspecificrZ generics r rR Generator._dispatch s
'')%%' ??D;/77SAtZ( 2D9 <ll3,G4g!5tFrom ) get_payload
isinstancestr TypeErrortyper _payload get_paramr set_payloadrQ r fcrerf rI )r r1 payloadry s r _handle_textGenerator._handle_text s //# ? '3'' 9DM IJ J 3<< ( (mmI.G" sm34 g6 //+#&'B#C#&~#6#8 hhx1G '"r c t / nUR 5 nUc / nO?[ U[ 5 ( a U R U5 g [ U[ 5 ( d U/nU H^ nU R 5 nU R
U5 nUR USU R S9 UR UR 5 5 M` UR 5 nU( d= U R R U5 nU R U5 nUR U5 UR bj U R" ( a! [$ R' SUR 5 n O UR n U R) U 5 U R U R 5 U R SU- U R - 5 U( a* U R* R UR- S5 5 U HL n
U R U R S- U- U R - 5 U R* R U
5 MN U R U R S- U- S- U R - 5 UR. bP U R" ( a! [$ R' SUR. 5 n O UR. n U R) U 5 g g )NFr2 r# rz z--r )r{ r| r} r listr> r' r6 r( appendrV get_boundaryr* rb _make_boundary set_boundarypreambler r rf rI r popepilogue) r r1 msgtextssubpartspartr gboundaryalltextr body_partr s r _handle_multipartGenerator._handle_multipart
s ??$ H
#
&
& JJx Hd++ zH D "A
1
A
IIdUDHHI = OOAJJL ) ##% &&++H5G**73H X & << #!! 88Hcll; << h ' JJtxx
4(?TXX-. HHNN8<<? + "I JJtxx$1DHH< = HHNN9 % "
488d?X-4txx?@ << #!! 88Hcll; << h ' $r c U R nUR SS9U l U R U5 X l g ! X l f = f)Nr r$ )r r' r )r r1 ps r _handle_multipart_signed"Generator._handle_multipart_signedG s=
KKggag0 " "3 'K!Ks : Ac / nUR 5 H nU R 5 nU R U5 nUR USU R S9 UR 5 nUR
U R 5 nU( aB US U R :X a/ UR U R R US S 5 5 M UR U5 M U R R U R R U5 5 g )NFr rD )
r{ r> r' r6 r( rV rF r* r, r rb r r )r r1 blocksr r r textrG s r _handle_message_delivery_status)Generator._handle_message_delivery_statusR s OO%D "A
1
A
IIdUDHHI =:: r' r r| r r6 r{ r( rV r) r r )r r1 r r r s r _handle_messageGenerator._handle_messageg s} JJqM ,, gt $ $
IIcooa(5$((I KjjlGll7+G w r c R [ R " [ R 5 nS[ U- - S- nUc U$ UnSn U R S[ R " U5 - S- [ R 5 nUR U5 ( d U$ US- [ U5 - nUS-
nMk )Nz===============z==r z^--z(--)?
?$.rO ) random randrangesysmaxsize_fmt _compile_rereescape MULTILINErq r} )clsr tokenr bcountercres r r Generator._make_boundary s - .5 <O //%"))A,"6"DbllSC::d## 3W -A qLG r c . [ R " X5 $ r )r compiler r flagss r r Generator._compile_re s zz!##r ) r+ r( r, r* r r rQ r r )NN)FNr )__name__
__module__ __qualname____firstlineno____doc__r r r6 r' r> r) rI r0 rR rP r rd r r r r classmethodr r __static_attributes__rA r r r r s @/(b2( " %'N(
&#, J8(t 6* 2 " $ $r r c X ^ \ rS rSrSrS rS rS rS rU 4S jr \ r
\ S 5 r S r
U =r$ )
r i a Generates a bytes version of a Message object tree.
Functionally identical to the base Generator except that the output is
bytes and not string. When surrogates were used in the input to encode
bytes, these are decoded back to bytes for output. If the policy has
cte_type set to 7bit, then the message is transformed such that the
non-ASCII bytes are properly content transfer encoded, using the charset
unknown-8bit.
The outfp object must accept bytes in its write method.
c Z U R R UR SS5 5 g )Nasciisurrogateescape)r r encoder s r r BytesGenerator.write s qxx):; BytesGenerator._new_buffer s
yr c $ UR S5 $ Nr )r r s r r) BytesGenerator._encode s xx r c UR 5 H u p#U R R X#5 nU R R ( a U R R R 5 nUR
U5 ( d [ SU< SU< 35 e[ R UR U5 5 ( a [ SU< 35 eU R R U5 M U R U R 5 g rk )rl r fold_binaryrn r# r ro r
NEWLINE_WITHOUT_FWSP_BYTESrq rr r r r( rs s r rP BytesGenerator._write_headers s MMODA[[,,Q2F{{33 ++--446 w//*:7+RzRT T-44V5H5H5QRR*:6*EG G HHNN6 " $
488 r c T > UR c g [ UR 5 ( al U R R S:X dR U R ( a% [
R
SUR 5 Ul U R UR 5 g [ [ U ]+ U5 g )N7bitrz ) r r r cte_typer r rf rI superr r )r r1 r9 s r r BytesGenerator._handle_text sr << 3<< ( (1E1Ev1M!! #xx#,, ? cll + . 3C 8r c N [ R " UR S5 U5 $ r )r r r r s r r BytesGenerator._compile_re s zz!((7+U33r rA )r r r r r r r> r) rP r rd r r r
__classcell__)r9 s @r r r s:
=! "
9 J4 4r r zD[Non-text (%(type)s) part of message omitted, filename %(filename)s]c 0 \ rS rSrSrSSS.S jjrS rSrg) r i zGenerates a text representation of a message.
Like the Generator base class, except that non-text parts are substituted
with a format string representing the part.
Nr c X [ R XX#US9 Uc [ U l gX@l g)a Like Generator.__init__() except that an additional optional
argument is allowed.
Walks through all subparts of a message. If the subpart is of main
type `text', then it prints the decoded payload of the subpart.
Otherwise, fmt is a format string that is used instead of the message
payload. fmt is expanded with the following keywords (in
%(keyword)s format):
type : Full MIME type of the non-text part
maintype : Main MIME type of the non-text part
subtype : Sub-MIME type of the non-text part
filename : Filename of the non-text part
description: Description associated with the non-text part
encoding : Content transfer encoding of the non-text part
The default value for fmt is None, meaning
[Non-text (%(type)s) part of message omitted, filename %(filename)s]
r N)r r _FMTr )r r r r fmtr s r r DecodedGenerator.__init__ s/ . 4 "( * ; DIIr c
UR 5 H nUR 5 nUS:X a [ UR SS9U S9 M2 US:X a M: [ U R UR 5 UR 5 UR
5 UR S5 UR SS5 UR S S
5 S .- U S9 M g ) Nr F)decode)file multipartz
[no filename]zContent-Descriptionz[no description]rM z
[no encoding])r maintypesubtypefilename descriptionencoding) walkr_ printr{ r get_content_typer` get_filenamerS )r r1 r r s r rR DecodedGenerator._dispatch s HHJD002H6!d&&e&44@[(dii#'#8#8#:#'#<#<#>#'#;#;#=#'#4#4_#E#'88,A,>$@#'88,G,;$= # ! " r )r )NNN)r r r r r r rR r rA r r r r s
<"r r rO z%%0%dd)!r __all__r r r. r copyr ior r email.utilsr email.errorsr
ra NLr rE r r rp r r r r r lenreprr _widthr r rA r r r s
A
=
' )
=! zz)R\\*zz"CD ZZ(J K x$ x$v 84Y 84v N6"y 6"t
T#++a-
!& ))r