Класс Cookie() модуля http.cookiejar в Python

Синтаксис:

import http.cookiejar

http.cookiejar.Cookie

Параметры:

• нет.

Возвращаемое значение:

• объект Cookie.

Описание:

Класс Cookie() модуля http.cookiejar представляет файлы cookie Netscape, RFC 2109 и RFC 2965.

Не ожидается, что пользователи модуля http.cookiejar будут создавать свои собственные экземпляры файлов сookie. Вместо этого, если необходимо, вызывайте метод .make_cookies() для экземпляра класса CookieJar.

Экземпляры файлов cookie имеют атрибуты Python, примерно соответствующие стандартным атрибутам файлов cookie, указанным в различных стандартах файлов cookie. Соответствие не является однозначным, потому что существуют сложные правила для назначения значений по умолчанию, потому что атрибуты cookie max-age и expires содержат эквивалентную информацию, и так же файлы cookie RFC 2109 могут быть понижены модулем http.cookiejar с версии 1 до версии 0 (Netscape) cookie.

Назначение этих атрибутов не должно быть необходимым, за исключением редких случаев в методе объекта CookiePolicy.

Класс не требует внутренней согласованности, поэтому вы должны знать, что вы делаете, если делаете это.

Объект Cookie.

• Cookie.version Атрибут,
• Cookie.name Атрибут,
• Cookie.value Атрибут,
• Cookie.port Атрибут,
• Cookie.path Атрибут,
• Cookie.secure Атрибут,
• Cookie.expires Атрибут,
• Cookie.discard Атрибут,
• Cookie.comment Атрибут,
• Cookie.comment_url Атрибут,
• Cookie.rfc2109 Атрибут,
• Cookie.port_specified Атрибут,
• Cookie.domain_specified Атрибут,
• Cookie.domain_initial_dot Атрибут,
• Cookie.is_expired() Метод,
• Нестандартные атрибуты объекта Cookie:
  • Cookie.has_nonstandard_attr() Метод,
  • Cookie.get_nonstandard_attr() Метод,
  • Cookie.set_nonstandard_attr() Метод.

Cookie.version:

Атрибут Cookie.version целое число или None.

• Файлы cookie Netscape имеют версию 0.
• Файлы cookie RFC 2965 и RFC 2109 имеют атрибут cookie версии 1.

Обратите внимание, что модуль http.cookiejar может понизить файлы cookie RFC 2109 до файлов cookie Netscape, в этом случае версия будет равна 0.

Cookie.name:

Атрибут Cookie.name - имя файла cookie (строка).

Cookie.value:

Атрибут Cookie.value - значение cookie (строка) или None.

Cookie.port:

Атрибут Cookie.port - строка, представляющая порт или набор портов (например, '80' или '80, 8080') или 'None'.

Cookie.path:

Атрибут Cookie.path - URL путь в сookie, строка, например '/acme/rocket_launchers.

Cookie.secure:

Атрибут Cookie.secure - True, если cookie следует возвращать только через безопасное соединение.

Cookie.expires:

Атрибут Cookie.expires - целочисленный срок годности cookie в секундах с начала эпохи или None.

Смотрите также метод Cookie.is_expired().

Cookie.discard:

Атрибут Cookie.discard - True, если это сессионный файл cookie.

Cookie.comment:

Атрибут Cookie.comment - строковый комментарий с сервера, объясняющий функцию этого файла cookie, или None.

Cookie.comment_url:

Атрибут Cookie.comment_url - URL-адрес, указывающий на комментарий сервера, объясняющий функцию этого файла cookie, или None.

Cookie.rfc2109:

Атрибут Cookie.rfc2109 - True, если этот cookie был получен как cookie RFC 2109 (т. е. cookie прибыл в заголовке Set-Cookie, и значение атрибута cookie версии в этом заголовке было 1).

Этот атрибут предоставляется, потому что модуль http.cookiejar может понизить файлы cookie RFC 2109 до файлов cookie Netscape, и в этом случае версия будет равна 0.

Cookie.port_specified:

Атрибут Cookie.port_specified - True, если порт или набор портов был явно указан сервером (в заголовке Set-Cookie/Set-Cookie2).

Cookie.domain_specified:

Атрибут Cookie.domain_specified True, если домен был явно указан сервером.

Cookie.domain_initial_dot:

Атрибут Cookie.domain_initial_dot True, если домен, явно указанный сервером, начинается с точки '.'.

Нестандартные атрибуты объекта Cookie:

Объект Cookie могут иметь дополнительные нестандартные атрибуты cookie. К ним можно получить доступ, используя следующие методы:

Cookie.is_expired(now=None):

Метод Cookie.is_expired() - True, если для файла cookie прошло время, в которое его запросил сервер, он должен истечь.

Если задано (в секундах с начала эпохи), то возвращает, истек ли срок действия cookie в указанное время.

Cookie.has_nonstandard_attr(name):

Метод Cookie.has_nonstandard_attr() возвращает True, если cookie имеет cookie-атрибут name.

Cookie.get_nonstandard_attr(name, default=None):

Метод Cookie.get_nonstandard_attr() возвращает значение cookie-атрибута name, если он имеется. В противном случае возвращает значение по умолчанию default.

Cookie.set_nonstandard_attr(name, value):

Метод Cookie.set_nonstandard_attr() устанавливает значение value cookie-атрибута name.