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 fonte bytes e retornar o correspondente decodificado bytes.

quopri.encodestring(s, quotetabs=False, header=False)

Como encode(), exceto pelo fato de aceitar uma fonte bytes e retornar o bytes codificado correspondente. Por padrão, envia um valor False para o parâmetro quotetabs da função encode().

Ver também

Módulo base64
Codifica e decodifica dados de base64 MIME