19.9. quopri
— Codifica e decodifica dados imprimíveis com aspas em MIME¶
Código-fonte: Lib/quopri.py
Este módulo realiza codificação e decodificação de transporte imprimida entre aspas, como definido em RFC 1521: “MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies”. A codificação imprimida entre aspas é projetada para dados em que há relativamente poucos caracteres não imprimíveis; o esquema de codificação base64 disponível através do módulo base64
é mais compacto se existirem muitos desses caracteres, como no envio de um arquivo gráfico.
-
quopri.
decode
(input, output, header=False)¶ Decodifica o conteúdo do arquivo input e escreve os dados binários decodificados resultantes no arquivo output. * input * e output devem ser objetos de arquivos binários. Se o argumento opcional header estiver presente e for true, o sublinhado será decodificado como espaço. Isso é usado para decodificar cabeçalhos codificados em “Q”, conforme descrito em RFC 1522: “MIME (Multipurpose Internet Mail Extensions) Part Two: Message Header Extensions for Non-ASCII Text”.
-
quopri.
encode
(input, output, quotetabs, header=False)¶ Encode the contents of the input file and write the resulting quoted-printable data to the output file. input and output must be binary file objects. quotetabs, a flag which controls whether to encode embedded spaces and tabs must be provideda and when true it encodes such embedded whitespace, and when false it leaves them unencoded. Note that spaces and tabs appearing at the end of lines are always encoded, as per RFC 1521. header is a flag which controls if spaces are encoded as underscores as per RFC 1522.
-
quopri.
decodestring
(s, header=False)¶ Como
decode()
, exceto pelo fato de aceitar uma fontebytes
e retornar o correspondente decodificadobytes
.
-
quopri.
encodestring
(s, quotetabs=False, header=False)¶ Como
encode()
, exceto pelo fato de aceitar uma fontebytes
e retornar obytes
codificado correspondente. Por padrão, envia um valorFalse
para o parâmetro quotetabs da funçãoencode()
.
Ver também
- Módulo
base64
- Codifica e decodifica dados de base64 MIME