Programmation PYTHON - Zenk - Security - Repository

266
La bibliothèque standard
TROISIÈME PARTIE
cPickle
cPickle offre un mécanisme de sérialisation des objets très puissant : tout objet en
mémoire peut être sauvegardé sur le système de fichiers puis rechargé par la suite.
cPickle est le grand frère du module pickle : il implémente à peu de choses près les
mêmes fonctionnalités mais est codé en C, donc beaucoup plus rapide.
cPickle est supérieur au module de fonctionnalités similaires marshal car il permet
de sérialiser de manière transparente tout type de classe.
Le mécanisme de sérialisation ne sauvegarde pas le code des fonctions ni les
paramètres : une simple référence est conservée et il est nécessaire de pouvoir
retrouver ces définitions lorsqu’un objet est dé-sérialisé.
Les rares types d’objets ne pouvant être sérialisés par cPickle sont dits unpickable et
sont les instances de socket, les pointeurs de fichiers et les threads. Les objets compatibles
sont dit pickable.
cPickle fournit deux types de fonctions pour sérialiser les objets :
dump() et load(), pour une écriture et une lecture directe dans un objet de type
fichier ;
dumps() et loads(), pour récupérer et fournir les flux sous forme de string.
dump(objet, fichier[, protocol])
Sérialise l’objet. fichier est un objet qui doit présenter une méthode write(), utilisée
par dump(). C’est en général un objet de type fichier (ouvert en écriture) ou assimilé,
comme StringIO.
protocol est un paramètre qui permet de déterminer la structure créée pendant la
sérialisation. Avec une valeur à 0 par défaut, cette structure reste la même pour toutes
les versions de Python passées ou à venir et assure ainsi une compatibilité ascendante.
1 détermine une structure plus efficace et 2 la meilleure structure possible.
Pour Python 2.4 et supérieur, la valeur 2 peut être récupérée par la variable
cPickle.HIGHEST_PROTOCOL, qui détermine la valeur maximum pour la version courante,
sachant que les prochaines versions introduiront certainement des valeurs supplémentaires.
Une valeur négative est équivalente à cPickle.HIGHEST_PROTOCOL.
load(fichier) -> objet
Utilise l’objet fichier pour reconstruire l’objet sérialisé. fichier est un objet de type
file ou assimilé qui doit fournir les méthodes read() et readlines().