# `email.encoders` : Encodeurs

Code source : Lib/email/encoders.py

Ce module fait partie du code patrimonial (`Compat32`) de l'API mail. Dans la nouvelle API la fonctionnalité est fournie par le paramètre cte de la méthode `set_content()`.

Ce module est obsolète en Python 3. Il n'est pas de besoin d'appeler explicitement les fonctions définies ici puisque la classe `MIMEText` ajuste le type de contenu et l'entête CTE à l'aide des paramètres _subtype et _charset de son constructeur.

Le texte restant de cette section est la documentation originale de ce module.

Au moment de la création d'objets `Message` à la main, il est souvent nécessaire d'encoder les charges utiles pour le transport à travers des serveurs mail conformes. C'est particulièrement vrai pour les messages de type image/* et text/* contenant des données binaires.

The `email` package provides some convenient encoders in its `encoders` module. These encoders are actually used by the `MIMEAudio` and `MIMEImage` class constructors to provide default encodings. All encoder functions take exactly one argument, the message object to encode. They usually extract the payload, encode it, and reset the payload to this newly encoded value. They should also set the Content-Transfer-Encoding header as appropriate.

À noter que ces fonctions n'ont pas de sens dans le cadre d'un message en plusieurs parties. Elles doivent à la place être appliquées aux sous-parties individuelles, et lèvent `TypeError` si on leur passe un message en plusieurs parties.

Voici les fonctions d'encodages fournies :

email.encoders.encode_quopri(msg)

  Encode la charge utile au format Quoted-Printable, et assigne `quoted-printable` [1] à l'en-tête Content-Transfer-Encoding. C'est un bon encodage à utiliser quand la majorité de la charge utile contient essentiellement des données imprimables, à l'exceptions de quelques caractères.

email.encoders.encode_base64(msg)

  Encode la charge utile au format base64, et assigne `base64` à l'en-tête Content-Transfer-Encoding. C'est un bon encodage à utiliser quand la majorité de la charge utile est non imprimable puisque c'est une forme plus compacte que quoted-printable.

email.encoders.encode_7or8bit(msg)

  Ceci ne modifie pas effectivement la charge utile du message, mais va bien en revanche assigner la valeur `7bit` ou `8bit` à l'en-tête Content-Transfer-Encoding selon la nature de la charge utile.

email.encoders.encode_noop(msg)

  Ceci ne fait rien; et ne va même pas changer la valeur de l'en-tête Content-Transfer-Encoding.

Notes

[1]

À noter que l'encodage avec `encode_quopri()` encode également tous les caractères tabulation et espace.