먐ݐ > d Z ddlmZ ddlmZ ddlmZ ddlmZmZmZm Z m
Z
m Z g dZ ddl
Z
ddlZddlmZmZmZ d Zd
Zd Z ed e
d
D Ze Z ed ej d z ej d z D ]Z ee ee< de ed < ed D ]Z ee ee< d Z d Z d Z d Z d#dZ d Z!d Z"d$dZ# G d d ej$ Z%d efd Z&efd Z'e'Z(e'Z)d! Z*d" Z+dS )%aF Quoted-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.
)unicode_literals)division)absolute_import)byteschrdictintrangesuper)
body_decode body_encode body_lengthdecode decodestring
header_decode
header_encode
header_lengthquoteunquoteN)
ascii_lettersdigits hexdigits
c # $ K | ] }|d |z fV dS )=%02XN ).0cs s/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/future/backports/email/quoprimime.py r" < s+ ??q1gk*?????? s -!*+/ascii_ s_ !"#$%&'()*+,-./0123456789:;<>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ c > t | t | k S )z>Return True if the octet should be escaped with header quopri.)r _QUOPRI_HEADER_MAPoctets r! header_checkr, N s u::+E2 22r# c > t | t | k S )z.b s0 EE%s%e,--EEEEEEr# sum bytearrays r! r r X s! EE9EEE E EEr# c 4 t d | D S )zReturn a body quoted-printable encoding length.
:param bytearray: An array of bytes (a.k.a. octets).
:return: The length in bytes of the byte array when it is encoded with
quoted-printable for bodies.
c 3 J K | ] }t t | V d S r2 )r3 r. r4 s r! r" z body_length..l s0 CCs#E*++CCCCCCr# r5 r7 s r! r r e s! CCCCC C CCr# c n t |t st | }| s)| | d S t | d t | z |k r| dxx ||z z
cc< d S | | d S )N)
isinstancestrr appendlstripr3 )Lsmaxlenextras r! _max_appendrE o s a FF QrUc!ff & & " r# c L t t | dd d S )zDTurn a string in the form =AB to the ASCII character with value 0xab )r r rB s r! r r z s s1QqS62 r# c & dt | z S )Nr )ord)r s r! r r s SVV r#
iso-8859-1c | sdS g }| D ]"}| t | #d|dt | dS )a 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 in the RFC 2046 header. It
defaults to iso-8859-1.
r z=?z?q?z?=)r? r) EMPTYSTRINGjoin) header_bytescharsetencodedr+ s r! r r sj rG 2 2)%011112 $GG[%5%5g%>%>%>%> ??r# c > e Zd Z fdZd Zd Zd ZddZd Z xZ S ) _body_accumulatorc d t j |i | || _ |x| _ | _ d S r2 )r __init__eol
maxlinelenroom)selfrY rX argskw __class__s r! rW z_body_accumulator.__init__ s8 $%"%%%&00$)))r# c j | | | xj t | z c_ dS )z%Add string s to the accumulated body.N)writerZ r3 )r[ rB s r! write_strz_body_accumulator.write_str s+
1
SVV r# c R | | j | j | _ dS )z Write eol, then start new line.N)ra rX rY rZ r[ s r! newlinez_body_accumulator.newline s# tx O r# c X | d | dS )z*Write a soft break, then start a new line.=N)ra rd rc s r! write_soft_breakz"_body_accumulator.write_soft_break s% s r# r c | j t | |z k r| | | dS )z.Add a soft line break if needed, then write s.N)rZ r3 rg ra )r[ rB
extra_rooms r!
write_wrappedz _body_accumulator.write_wrapped sD 9s1vv
* * * ! ! # # # qr# c |s| |d d S |dvr| | d S | j dk r$| t | d S | j dk r+| | | d S | | t | d S )NrG )ri z rH )rj rZ r` r rg )r[ r is_last_chars r!
write_charz _body_accumulator.write_char s !
qQ / / / / /
e^^
q ! ! ! ! !
Y!^^
JJuQxx
Y!^^ JJqMMM ! ! # # # # #
! ! # # # JJuQxx r# )r )
__name__
__module__ __qualname__rW ra rd rg rj rn
__classcell__)r^ s @r! rU rU s 1 1 1 1 1
$ $ $
! ! ! ! ! ! !r# rU L c |dk rt d | s| S | d dv }t || }| }t | dz
}t | D ]\ }}t | dz
} t | D ]J\ }
} t t
| rt | } | | |
| k K||k s|r| |
S )a Encode with quoted-printable, wrapping at maxlinelen characters.
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 before the
eol string (maxlinelen defaults to 76 characters, the maximum value
permitted by RFC 2045). Long lines will have the 'soft line break'
quoted-printable character "=" appended to them, so the decoded text will
be identical to the original text.
The minimum maxlinelen is 4 to have room for a quoted character ("=XX")
followed by a soft line break. Smaller values will generate a
ValueError.
z maxlinelen must be at least 4r< r rG )
ValueErrorrU
splitlinesr3 enumerater/ rL r rn rd getvalue) bodyrY rX last_has_eol encoded_bodylines last_line_noline_nolinelast_char_indexir s r! r
r
s! & A~~8999 H&L %Z55L OO Eu::>L"5)) # #
d))a- dOO ; ;DAq#a&&!!
!HH # #Aq/'9 : : : : \ ! !\ ! " " " " ""r# c | s| S d}| D ]}| }|s||z
} d}t | }||k r|| }|dk r ||z
}|dz
}ni|dz |k r|dz
}.|dz |k rG||dz t v r5||dz t v r#|t |||dz z
}|dz
}n
||z
}|dz
}||k r||z
}||k | d dvr | | r
|d d }|S )
z_Decode a quoted-printable string.
Lines are separated with eol, which defaults to \n.
r r rf rG rl rH r< r N)rw rstripr3 r r endswith)rS rX decodedr r nr s r! r r sp
G""$$ {{}} sNG
II!eeQACxx1 Q 1Q1qT!A#Y) 3 3QqS Y8N8N74!A#;///Q 1 QAvv3) !ee, r{& W%5%5c%:%: #2#, Nr# c J | d }t | S )zCTurn a match in the form =AB to the ASCII character with value 0xabr )groupr )matchrB s r! _unquote_matchr 7 s
AA 1::r# c z | dd } t j dt | t j S )a 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.
r& r' z=[a-fA-F0-9]{2})replaceresubr ASCIIrJ s r! r r > s0
#sA
6$na B BBr# )r )rM ),__doc__
__future__r r r future.builtinsr r r r r
r __all__r iostringr r r CRLFNLrO r) copyr. encoder rL r, r/ r r rE r r r StringIOrU r
r r r r r r r# r! r s
. ( ' ' ' ' ' & & & & & & ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?
3 3 3 3 3 3 3 3 3 3
T??EE#JJ????? %**,,
x.-.w777-&-:P:PP Q Q # #A CFFq " 33s88
3
4
4 ! !A #a&&Q
3 3 3
1 1 1
F
F
FD D D
@ @ @ @.3! 3! 3! 3! 3! 3! 3! 3!l "$ +# +# +# +#b , , , ,` C C C C Cr#