11.17 `Cookie` --- Gestion d'état en HTTP

Le module Cookie définit des classes fournissant une abstraction du concept de cookies, un mécanisme de gestion d'état en HTTP. Il prend en charge à la fois les simples cookies chaînes, et fournit une abstraction pour donner comme valeur à un cookie n'importe quel type de donnée sérialisable.

Précédemment ce module appliquait strictement des règles d'analyse décrites dans les spécifications RFC 2109 et RFC 2068. Il a été découvert récemment que MSIE 3.0x ne suit pas les règles sur les caractères définies dans ces spécifications. Par conséquent, les règles d'analyse utilisées sont devenues un peu moins strictes.

CookieError

Exception déclenchée pour cause d'invalidité RFC 2109: attributs incorrects, en-tête Set-Cookie incorrect, etc.

BaseCookie([entree])

Cette classe est un objet de type dictionnaire dont les clés sont des chaînes et les valeurs sont des Morsels. Notez qu'au moment d'affecter une valeur à une clé, la valeur est d'abord convertie en un Morsel contenant la clé et la valeur.

Si l'arguement entree est fourni, il est passé à la méthode load.

SimpleCookie([entree]): Cette classe dérive de BaseCookie et surcharge value_decode et value_encode pour qu'elles correspondent respectivement à l'identité et à str().

SerialCookie([entree])

Cette classe dérive de BaseCookie et surcharge value_decode et value_encode pour qu'elles correspondent respectivement à pickle.loads() et à pickle.dumps.

Ne pas utiliser cette classe. Lire des valeurs picklées est un trou de sécurité, parce qu'un code client arbitraire peut être exécuté sur pickle.loads(). Elle est prise en charge pour des raisons de compatibilité ascendante.

SmartCookie([entree])

Cette classe dérive de BaseCookie. Elle surcharge value_decode pour qu'elle corresponde à pickle.loads() s'il s'agit d'un pickle valide, et sinon à la valeur elle-même. Elle surcharge value_encode pour qu'elle corresponde à pickle.dumps() à moins qu'il ne s'agisse d'une chaîne de caractères, auquel cas elle retourne la valeur elle-même.

Le même avertissement sur la sécurité que pour SerialCookie s'applique ici.

Voir aussi:

RFC 2109, HTTP State Management Mechanism: C'est la spécification de la gestion d'état implémentée par ce module.

Sous-sections

11.17 Cookie --- Gestion d'état en HTTP

11.17 `Cookie` --- Gestion d'état en HTTP