20.9. quopri — Encode et décode des données MIME quoted-printable

Code source : Lib/quopri.py


Ce module effectue des encodages et décodages de transport quoted-printable, tel que définis dans la RFC 1521 : « MIME (Multipurpose Internet Mail Extensions) Part One Mechanisms for Specifying and Describing the Format of Internet Message Bodies ». L’encodage quoted-printable est adapté aux données dans lesquelles peu de données ne sont pas affichables. L’encodage base64 disponible dans le module base64 est plus compact dans les cas où ces caractères sont nombreux, typiquement pour encoder des images.

quopri.decode(input, output, header=False)

Décode le contenu du fichier input et écrit le résultat décodé, binaire, dans le fichier output. input et output doivent être des objets fichiers binaires. Si l’argument facultatif header est fourni et vrai, les underscore seront décodés en espaces. C’est utilisé pour décoder des entêtes encodées « Q » décrits dans la RFC RFC 1522 : « MIME (Multipurpose Internet Mail Extensions) Part Two: Message Header Extensions for Non-ASCII Text ».

quopri.encode(input, output, quotetabs, header=False)

Encode le contenu du fichier input et écrit le résultat dans le fichier output. input et output doivent être des objets fichiers binaires. quotetabs (paramètre obligatoire) permet de choisir le style d’encodage des espaces et des tabulations, si vrai les espaces seront encodées, sinon elles seront laissées inchangées. Notez que les espaces et tabulations en fin de ligne sont toujours encodées, tel que spécifié par la RFC 1521. header est une option permettant d’encoder les espace en underscores, tel que spécifié par la RFC 1522.

quopri.decodestring(s, header=False)

Fonctionn comme decode(), sauf qu’elle accepte des bytes comme source, et renvoie les bytes décodés correspondants.

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

Fonctionn comme encode(), sauf qu’elle accepte des bytes comme source et renvoie les bytes encodés correpondants. Par défaut, False est donné au paramètre quotetabs de la fonction encode().

Voir aussi

Module base64
Encode et décode des données MIME en base64