cj]! 2 d Z ddlZddlZddlZddlZddlmZmZ ddlm Z g dZ
ej ej d j d Zd Z G d d
e Z e Zd e ed < d
Zd Zd Zd Zd ZeedZd ZeedZeedZ ddZ y)z Routines for manipulating RFC2047 encoded words.
This is currently a package-private API, but will be considered for promotion
to a public API if there is demand.
N)
ascii_lettersdigits)errors)decode_qencode_qdecode_bencode_blen_qlen_bdecodeencodes =([a-fA-F0-9]{2})c f t j | j d j S )N )bytesfromhexgroupr )ms -/usr/lib64/python3.12/email/_encoded_words.pyr A s %--
1 1 34 c @ | j dd } t | g fS )N _ )replace_q_byte_subber)encodeds r r r C s" oodD)G ' "B &&r c b e Zd Zd ej d z ej d z Zd Zy) _QByteMaps -!*+/asciic v || j v rt | | |< | | S dj | | |< | | S )Nz={:02X})safechrformat)selfkeys r __missing__z_QByteMap.__missing__M sG $)) CDI Cy "((-DICyr N)__name__
__module__ __qualname__r r
r r! r& r r r r I s/ *m**73 3mfmmG6L LDr r _ c 2 dj d | D S )N c 3 . K | ]
}t | y wN) _q_byte_map.0xs r zencode_q..Z s 37a;q>7s )joinbstrings r r r Y s
77373 33r c & t d | D S )Nc 3 @ K | ] }t t | y wr0 )lenr1 r2 s r r5 zlen_q..] s 4Gqs;q>"Gs )sumr7 s r r
r
\ s 4G4 44r c P t | dz }|rdd d|z
nd} t j | |z d |rt j gfS g fS # t
j $ r t j | d t j gfcY S # t
j $ r| t j | dz d t j t j gfcY cY S # t
j $ r | t j gfcY cY cY S w xY ww xY ww xY w)N s ===r T)validateFs ==) r; base64 b64decoder InvalidBase64PaddingDefectbinasciiError InvalidBase64CharactersDefectInvalidBase64LengthDefect)r pad_errmissing_paddings r r r d s7 'lQ G,3fZai(O E W 6 F5> E E 595578
~~ E
E$$Wu_uE99;668:
>>
E !A!A!C DDD
E EEsZ 0A
A D%$+BD%D!&AC,'D!(D%,*D D!D% D D!!D%c J t j | j d S )Nr )r@ b64encoder r7 s r r r s G $ + +G 44r c N t t | d \ }}|dz |rdz S dz S )N r> r )divmodr; )r8 groups_of_3leftovers r r r s0 "3w< 3K ?8a 33 33r )qbc < | j d \ }}}}}|j d \ }}}|j }|j dd }t | | \ }} |j | }||||fS # t $ r= |j t j d|d |j |d }Y Kt t f$ rP |j dd }|j dk7 r(|j t j d|d Y w xY w)
a Decode encoded word and return (string, charset, lang, defects) tuple.
An RFC 2047/2243 encoded word has the form:
=?charset*lang?cte?encoded_string?=
where '*lang' may be omitted but the other parts may not be.
This function expects exactly such a string (that is, it does not check the
syntax and may raise errors if the string is not well formed), and returns
the encoded_string decoded first from its Content Transfer Encoding and
then from the resulting bytes into unicode using the specified charset. If
the cte-decoded string does not successfully decode using the specified
character set, a defect is added to the defects list and the unknown octets
are replaced by the unicode 'unknown' character \uFDFF.
The specified charset and language are returned. The default for language,
which is rarely if ever encountered, is the empty string.
?*r surrogateescapez0Encoded word contains bytes not decodable using z charset unknown-8bitzUnknown charset z* in encoded word; decoded as unknown bytes)
split partitionlowerr
_cte_decodersr UnicodeDecodeErrorappendr UndecodableBytesDefect LookupErrorUnicodeEncodeError CharsetError) ewr+ charsetcte
cte_stringlangr8 defectsstrings r r r s1 * &(XXc]"AwZ ((-GQ
))+C ):;G$S)'2GW
? ( 7D' )) <v44 6229H6F G H ):; + , ? ):; ==?n , NN6..1A' M< 0= >
??s !A8 8AD=ADDc |dk( r| j dd }n| j | }|(t d | }t d | }||z
dk rdnd}t | | }|rd|z }dj |||| S ) a Encode string using the CTE encoding that produces the shorter result.
Produces an RFC 2047/2243 encoded word of the form:
=?charset*lang?cte?encoded_string?=
where '*lang' is omitted unless the 'lang' parameter is given a value.
Optional argument charset (defaults to utf-8) specifies the charset to use
to encode the string to binary before CTE encoding it. Optional argument
'encoding' is the cte specifier for the encoding that should be used ('q'
or 'b'); if it is None (the default) the encoding which produces the
shortest encoded sequence is used, except that 'q' is preferred if it is up
to five characters longer. Optional argument 'lang' (default '') gives the
RFC 2243 language string to specify in the encoded word.
rV r rU rP rQ rT z=?{}{}?{}?{}?=)r
_cte_encode_length
_cte_encodersr# )rg rb encodingre r8 qlenblenr s r r
r
s " . --):;--(!#&w/!#&w/ +/3sH%g.G Tz " "7D(G DDr )zutf-8Nr. ) __doc__rer@ rC functoolsrg r r emailr __all__partialcompilesubr r dictr r1 ordr r
r r r rZ r rk rj r
r* r r ry s R
(
#"":2::.C#D#H#H46' k CH 45$EL54
'*V
Er