http.cookiejar --- HTTP 用戶端的 Cookie 處理

原始碼:Lib/http/cookiejar.py


http.cookiejar 模組定義了自動處理 HTTP cookie 的類別。當需要存取小量資料 —— cookies —— 的網站時會非常有用。這些資料會依據網頁伺服器的 HTTP 回應來設置於用戶端機器,並在之後的請求中被回傳到伺服器。

一般的 Netscape cookie 協定和 RFC 2965 定義的 cookie 協定都會被處理。RFC 2965 的處理預設是關閉的。RFC 2109 cookie 會被剖析為 Netscape cookie,然後根據有生效的「策略」來被看作為 Netscape 或 RFC 2965 cookie。http.cookiejar 會嘗試遵循實際上的 Netscape cookie 協定(與原始的 Netscape 規格中的協定有很大的不同),包括 RFC 2965 所引進的 max-ageport cookie 屬性。

備註

Set-CookieSet-Cookie2 標頭中出現的各種命名參數(例如 domainexpires)通常被稱為 attributes。為了與 Python 的屬性分別開,這個模組的說明檔案改用 cookie-attribute 來稱呼。

模組定義了以下例外:

exception http.cookiejar.LoadError

當從檔案載入 cookies 失敗時,FileCookieJar 的實例會引發這個例外。LoadErrorOSError 的子類別。

在 3.3 版的變更: LoadError 以前是 IOError 的子型別,現在是 OSError 的別名。

這個模組提供了以下類別:

class