 |
 |
 |
Python ライブラリリファレンス |  |
 |
 |
|
|
|
Python ライブラリリファレンス | |
|
|
cookielib モジュールは HTTP クッキーの自動処理をおこなう クラスを定義します。これは小さなデータの断片 - クッキー - を要求する web サイトにアクセスする際に有用です。クッキーとは web サーバの HTTP レスポンスによってクライアントのマシンに設定され、 のちの HTTP リクエストをおこなうさいにサーバに返されるものです。
標準的な Netscape クッキープロトコルおよび RFC 2965 で定義されている
プロトコルの両方を処理できます。RFC 2965 の処理はデフォルトではオフになっています。
RFC 2109 のクッキーは Netscape クッキーとして解析され、のちに
RFC 2965 として処理されます。cookielib はデファクトスタンダードの
Netscape クッキープロトコル (これは元々 Netscape が策定した仕様とはかなり異なっています) に
従うようになっており、RFC 2109 で導入された max-age や port などの
クッキー属性にも注意を払います。 注意:
Set-Cookie: や
Set-Cookie2: ヘッダに現れる多種多様なパラメータの名前
(domain や expires など) は便宜上 属性 と呼ばれますが、
ここでは Python の属性と区別するため、かわりに クッキー属性 と呼ぶことにします。
このモジュールは以下の例外を定義しています:
以下のクラスが提供されています:
| policy=None) |
CookieJar クラスには HTTP クッキーを保管します。 これは HTTP リクエストに応じてクッキーを取り出し、それを HTTP レスポンスの中で返します。必要に応じて、 CookieJar インスタンスは保管されているクッキーを 自動的に破棄します。このサブクラスは、クッキーをファイルや データベースに格納したり取り出したりする操作をおこなう役割を負っています。
| filename, delayload=None, policy=None) |
FileCookieJar はディスク上のファイルからのクッキーの読み込み、 もしくは書き込みをサポートします。実際には、load() または revert() のどちらかのメソッドが呼ばれるまでクッキーは 指定されたファイルからはロードされません。 このクラスのサブクラスは 11.20.2 節で説明します。
| ) |
| blocked_domains=None, allowed_domains=None, netscape=True, rfc2965=False, hide_cookie2=False, strict_domain=False, strict_rfc2965_unverifiable=True, strict_ns_unverifiable=False, strict_ns_domain=DefaultCookiePolicy.DomainLiberal, strict_ns_set_initial_dollar=False, strict_ns_set_path=False ) |
コンストラクタはキーワード引数しか取りません。 blocked_domains はドメイン名からなるシーケンスで、ここからは 決してクッキーを受けとらないし、このドメインにクッキーを返すこともありません。 allowed_domains が None でない場合、これはこのドメインのみから クッキーを受けとり、返すという指定になります。これ以外の引数については CookiePolicy および DefaultCookiePolicy オブジェクトの 説明をごらんください。
DefaultCookiePolicy は Netscape および RFC 2965 クッキーの 標準的な許可 / 拒絶のルールを実装しています。RFC 2109 のクッキー (Set-Cookie: の version クッキー属性が 1 で受けとられるもの) は RFC 2965 のルールで扱われます。また DefaultCookiePolicy には いくつかの細かいポリシー設定をおこなうパラメータが用意されています。
| ) |
参考:
cookie_spec.html で述べられているものと
おおまかにしか似ていません。
|
|
|
Python ライブラリリファレンス | |
|
|