o
0i]! @ s d Z ddlZddlZddlZddlZddlmZmZ ddlm Z g dZ
e e dj
dd Zd d
ZG d d d eZe Zd
eed< dd Zdd Zdd Zdd Zdd ZeedZdd ZeedZeedZ d d d Z dS )!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 C s t | d S )N )bytesfromhexgroupr )m r ;/opt/alt/python310/lib64/python3.10/email/_encoded_words.pyA s r c C s | dd} t| g fS )N _ )replace_q_byte_subber)encodedr r r r C s r c @ s, e Zd Zded ed Zdd ZdS ) _QByteMaps -!*+/asciic C s4 || j v rt|| |< | | S d|| |< | | S )Nz={:02X})safechrformat)selfkeyr r r __missing__M s
z_QByteMap.__missing__N)__name__
__module__ __qualname__r r r r r! r r r r r I s r _ c C s d dd | D S )N c s s | ]}t | V qd S N) _q_byte_map.0xr r r Z s zencode_q..)joinbstringr r r r Y s r c C s t dd | D S )Nc s s | ] }t t| V qd S r( )lenr) r* r r r r- ] s zlen_q..)sumr/ r r r r \ s r c C s t | d }|rdd d| nd}ztj| | dd|r$t gfW S g fW S tjys ztj| ddt gfW Y S tjyr ztj| d ddt t gfW Y Y S tjyq | t gf Y Y Y S w w w )N s === T)ZvalidateFs ==) r1 base64Z b64decoder ZInvalidBase64PaddingDefectbinasciiErrorZ InvalidBase64CharactersDefectZInvalidBase64LengthDefect)r Zpad_errZmissing_paddingr r r r d s2
r c C s t | dS )Nr )r5 Z b64encoder r/ r r r r s r c C s( t t| d\}}|d |rd S d S )N r3 r )divmodr1 )r0 Z groups_of_3Zleftoverr r r r
s r
)qbc
C s | d\}}}}}|d\}}}| }|dd}t| |\}}z||}W n= tyF |t d|d ||d}Y n# t
t fyh |dd}| dkrf|t d|d Y nw ||||fS )
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 ZUndecodableBytesDefect LookupErrorUnicodeEncodeErrorZ CharsetError) Zewr% charsetZcteZ
cte_stringlangr0 Zdefectsstringr r r r s&
r utf-8r' c C s| |dkr | dd}n| |}|du r*td |}td |}|| dk r(dnd}t| |}|r6d| }d ||||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.
r? r r> Nr: r; r= z=?{}{}?{}?{}?=)r _cte_encode_length
_cte_encodersr )rJ rH encodingrI r0 ZqlenZblenr r r r r s
r )rK Nr' ) __doc__rer5 r6 functoolsrJ r r Zemailr __all__partialcompilesubr r dictr r) ordr r r r r
rC r rN rM r r r r r s> ) &+