*j]! 4 S r SSKrSSKrSSKrSSKrSSKJrJr SSKJ r / SQr
\R " \R " S5 R S 5 rS r " S S
\5 r\" 5 rS \\" S 5 ' S
rS rS rS rS r\\S.rS r\\S.r\\S.r SS jr g)zRoutines 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 [ R U R S5 R 5 5 $ )N )bytesfromhexgroupr )ms ;/opt/alt/python313/lib64/python3.13/email/_encoded_words.pyr A s %--
1 1 34 c @ U R SS5 n [ U 5 / 4$ )N _ )replace_q_byte_subber)encodeds r r r C s" oodD)G ' "B &&r c j \ rS rSrS\R
" S5 - \R
" S5 - rS rSr g) _QByteMapI s -!*+/asciic p XR ; a [ U5 X' X $ SR U5 X' X $ )Nz={:02X})safechrformat)selfkeys r __missing___QByteMap.__missing__M s= )) CDI y "((-DIyr N)
__name__
__module__ __qualname____firstlineno__r r
r r" r' __static_attributes__r) r r r r I s* m**73 3fmmG6L LDr r _ c 2 SR S U 5 5 $ )N c 3 4 # U H n[ U v M g 7fN) _q_byte_map.0xs r encode_q..Z s 37a;q>7s )joinbstrings r r r Y s
77373 33r c & [ S U 5 5 $ )Nc 3 F # U H n[ [ U 5 v M g 7fr4 )lenr5 r6 s r r9 len_q..] s 4Gqs;q>""Gs !)sumr< s r r
r
\ s 4G4 44r c f [ U 5 S- nU( a SS SU-
OSn [ R " X- SS9U( a [ R " 5 /4$ / 4$ ! [
R a [ R " U SS9[ R " 5 /4s $ ! [
R a~ [ R " U S- SS9[ R " 5 [ R " 5 /4s s $ ! [
R a U [ R " 5 /4s s s $ f = ff = ff = f)N s ===r T)validateFs ==) r@ base64 b64decoder InvalidBase64PaddingDefectbinasciiError InvalidBase64CharactersDefectInvalidBase64LengthDefect)r pad_errmissing_paddings r r r d s5 'lQ G,3fZai(O E W 6 F5> E E 595578
~~ E
E$$Wu_uE99;668:
>>
E !A!A!C DDD
E EEsZ 3A A D0-*BD0D,/AC50D,1D05,D(!D,#D0'D((D,,D0c L [ R " U 5 R S5 $ )Nr )rF b64encoder r< s r r r s G $ + +G 44r c V [ [ U 5 S5 u pUS- U( a S- $ S- $ )N rD r )divmodr@ )r= groups_of_3leftovers r r r s. "3w< 3K ?8a 33 33r )qbc @ U R S5 u pp4nUR S5 u p!nUR 5 nUR SS5 n[ U " U5 u pg UR U5 nXXW4$ ! [ a? UR [ R " SU< S35 5 UR US5 n NL[ [ 4 aS UR SS5 nUR 5 S:w a* UR [ R " SU< S 35 5 Nf = f)
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_stringlangr= defectsstrings r r r s% * &(XXc]"A ((-G
))+C ):;G$S)'2G
? ( D )) <v44 6229H6F G H ):; + , ? ):; ==?n , NN6..1A' M< 0= >
??s A3 3AD ;A D D c
US:X a U R SS5 nOU R U5 nUc* [ S " U5 n[ S " U5 nXV-
S: a SOSn[ U " U5 nU( a SU- nSR XX'5 $ ) 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.
r\ utf-8r[ rV rW rZ z=?{}{}?{}?{}?=)r
_cte_encode_length
_cte_encodersr$ )rm rh encodingrk r= qlenblenr s r r
r
s " . --):;--(!#&w/!#&w/ +/3sH%g.G Tz " "7( DDr )ro Nr2 ) __doc__rerF rI functoolsrm r r emailr __all__partialcompilesubr r dictr r5 ordr r
r r r r` r rr rq r
r) r r r s R
(
""2::.C#D#H#H46' k CH 45$EL54
'*V
Er