o ,º]«*ã@s~dZddlmZddlmZddlmZddlmZmZmZm Z m Z m Z gd¢Z ddl Z ddlZddlmZmZmZd Zd Zd Zed d „e dƒDƒƒZe ¡Zede d¡e d¡ƒD]Zeeƒee<q]deedƒ<edƒD]Zeeƒee<qpdd„Zdd„Zdd„Zdd„Zd0dd„Z dd„Z!d d!„Z"d1d#d$„Z#Gd%d&„d&ej$ƒZ%d'efd(d)„Z&efd*d+„Z'e'Z(e'Z)d,d-„Z*d.d/„Z+dS)2aFQuoted-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)ÚbytesÚchrÚdictÚintÚrangeÚsuper) Ú body_decodeÚ body_encodeÚ body_lengthÚdecodeÚ decodestringÚ header_decodeÚ header_encodeÚ header_lengthÚquoteÚunquoteN)Ú ascii_lettersÚdigitsÚ hexdigitsú Ú Úccs|] }|d|fVqdS)ú=%02XN©)Ú.0ÚcrrúC/usr/lib/python3/dist-packages/future/backports/email/quoprimime.pyÚ <ó€r és-!*+/ÚasciiÚ_ú s_ !"#$%&'()*+,-./0123456789:;<>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ cCót|ƒt|kS)z>Return True if the octet should be escaped with header quopri.)rÚ_QUOPRI_HEADER_MAP©ÚoctetrrrÚ header_checkNór*cCr&)z.©Úsum©Ú bytearrayrrrrXs rcCr.)zÞReturn 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. csr/r0)r1r,r2rrrr lr!zbody_length..r3r5rrrr esr cCsjt|tƒs t|ƒ}|s| | ¡¡dSt|dƒt|ƒ|kr,|d||7<dS| | ¡¡dS)Néÿÿÿÿ)Ú isinstanceÚstrrÚappendÚlstripr1)ÚLÚsÚmaxlenÚextrarrrÚ _max_appendos r@cCstt|dd…dƒƒS)zDTurn a string in the form =AB to the ASCII character with value 0xabééé)rr©r=rrrrzsrcCs dt|ƒS)Nr)Úord)rrrrrs rú iso-8859-1cCs6|sdSg}|D] }| t|¡qd|t |¡fS)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. rz =?%s?q?%s?=)r:r'Ú EMPTYSTRINGÚjoin)Ú header_bytesÚcharsetÚencodedr)rrrr„s  rcsFeZdZ‡fdd„Zdd„Zdd„Zdd„Zdd d „Zd d „Z‡Z S)Ú_body_accumulatorcs(tƒj|i|¤Ž||_||_|_dSr0)r Ú__init__ÚeolÚ maxlinelenÚroom)ÚselfrOrNÚargsÚkw©Ú __class__rrrMsz_body_accumulator.__init__cCs | |¡|jt|ƒ8_dS)z%Add string s to the accumulated body.N)ÚwriterPr1)rQr=rrrÚ write_str¢s z_body_accumulator.write_strcCs| |j¡|j|_dS)zWrite eol, then start new line.N)rWrNrOrP©rQrrrÚnewline§s  z_body_accumulator.newlinecCs| d¡| ¡dS)z*Write a soft break, then start a new line.ú=N)rWrYrXrrrÚwrite_soft_break¬s  z"_body_accumulator.write_soft_breakrcCs(|jt|ƒ|kr | ¡| |¡dS)z.Add a soft line break if needed, then write s.N)rPr1r[rW)rQr=Ú extra_roomrrrÚ write_wrapped±sz_body_accumulator.write_wrappedcCs‚|s |j|dddS|dvr| |¡dS|jdkr$| t|ƒ¡dS|jdkr4| |¡| ¡dS| ¡| t|ƒ¡dS)NrA)r\z rBé)r]rPrVrr[)rQrÚ is_last_charrrrÚ write_char·s    z_body_accumulator.write_char)r) Ú__name__Ú __module__Ú __qualname__rMrWrYr[r]r`Ú __classcell__rrrTrrL›s  rLéLc Cs²|dkrtdƒ‚|s |S|ddv}t||ƒ}| ¡}t|ƒd}t|ƒD]/\}}t|ƒd} t|ƒD]\} } tt| ƒƒrAt| ƒ} | | | | k¡q3||ksP|rT|  ¡q%|  ¡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. ézmaxlinelen must be at least 4r7rrA) Ú ValueErrorrLÚ splitlinesr1Ú enumerater-rErr`rYÚgetvalue) ÚbodyrOrNÚ last_has_eolÚ encoded_bodyÚlinesÚ last_line_noÚline_noÚlineÚlast_char_indexÚirrrrr Ñs$      €r cCs|s|Sd}| ¡D]n}| ¡}|s||7}q d}t|ƒ}||krx||}|dkr2||7}|d7}n:|d|kr=|d7}q|d|krd||dtvrd||dtvrd|t|||d…ƒ7}|d7}n||7}|d7}||krt||7}||ks!q |ddvrŠ| |¡rŠ|d d…}|S) z_Decode a quoted-printable string. Lines are separated with eol, which defaults to \n. rrrZrAr^rBr7rN)rhÚrstripr1rrÚendswith)rKrNÚdecodedrqrsÚnrrrrrs<   , ì€ rcCs| d¡}t|ƒS)zCTurn a match in the form =AB to the ASCII character with value 0xabr)Úgroupr)Úmatchr=rrrÚ_unquote_match7s rzcCs| dd¡}t dt|tj¡S)aDecode 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})ÚreplaceÚreÚsubrzÚASCIIrDrrrr>s r)r)rF),Ú__doc__Ú __future__rrrÚfuture.builtinsrrrrr r Ú__all__r|ÚioÚstringrrrÚCRLFÚNLrGr'Úcopyr,ÚencoderrEr*r-rr r@rrrÚStringIOrLr rr rrzrrrrrÚsD           6 10