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)

Codifica o conteúdo do arquivo input e grava os dados imprimíveis entre aspas resultantes no arquivo output. input e output devem ser objetos de arquivos binários. quotetabs, um sinalizador não opcional que controla a codificação de espaços e tabulações incorporados; quando true, codifica esses espaços em branco incorporados e, quando false, os deixa sem codificação. Observe que os espaços e tabulações que aparecem no final das linhas são sempre codificados, conforme RFC 1521. header é um sinalizador que controla se os espaços são codificados como sublinhados, conforme 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