`http.cookiejar.md`

507 строк · 47.3 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.2/library/http.cookiejar.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 20.22. [`http.cookiejar`](https://python-all.ru/3.2/library/http.cookiejar.html#module-http.cookiejar) – Обработка cookie для HTTP-клиентов89**Исходный код:** [Lib/http/cookiejar.py](https://python-all.ru/src/3.2/Lib/http/cookiejar.py)1011---1213The [`http.cookiejar`](https://python-all.ru/3.2/library/http.cookiejar.html#module-http.cookiejar) module defines classes for automatic handling of HTTP cookies. It is useful for accessing web sites that require small pieces of data – *cookies* – to be set on the client machine by an HTTP response from a web server, and then returned to the server in later HTTP requests.1415Поддерживаются как обычный протокол Netscape cookie, так и протокол, определённый в [**RFC 2965**](https://python-all.ru/3.2/library/http.cookiejar.html). Обработка RFC 2965 по умолчанию отключена. [**RFC 2109**](https://python-all.ru/3.2/library/http.cookiejar.html) cookie разбираются как Netscape cookie и впоследствии обрабатываются либо как Netscape, либо как RFC 2965 cookie в зависимости от действующей «политики». Обратите внимание, что подавляющее большинство cookie в интернете – это Netscape cookie. [`http.cookiejar`](https://python-all.ru/3.2/library/http.cookiejar.html#module-http.cookiejar) пытается следовать фактическому протоколу Netscape cookie (который существенно отличается от изложенного в оригинальной спецификации Netscape), включая учёт атрибутов cookie `max-age` и `port`, введённых в RFC 2965.1617> **Примечание**18>19> Различные именованные параметры, встречающиеся в заголовках *Set-Cookie* и *Set-Cookie2* (например, `domain` и `expires`), обычно называют *атрибутами*. Чтобы отличать их от атрибутов Python, в документации этого модуля используется термин *cookie-attribute*.2021Модуль определяет следующее исключение:2223#### `exception http.cookiejar.LoadError`2425Экземпляры [`FileCookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar) вызывают это исключение при сбое загрузки куки из файла. [`LoadError`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.LoadError) является подклассом [`IOError`](https://python-all.ru/3.2/library/exceptions.html#IOError).2627Предоставляются следующие классы:2829#### `class http.cookiejar.CookieJar(policy=None)`3031*policy* – это объект, реализующий интерфейс [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy).3233The [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) class stores HTTP cookies. It extracts cookies from HTTP requests, and returns them in HTTP responses. [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) instances automatically expire contained cookies when necessary. Subclasses are also responsible for storing and retrieving cookies from a file or database.3435#### `class http.cookiejar.FileCookieJar(filename, delayload=None, policy=None)`3637*policy* – это объект, реализующий интерфейс [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy). Остальные аргументы описаны в документации соответствующих атрибутов.3839A [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) which can load cookies from, and perhaps save cookies to, a file on disk. Cookies are **NOT** loaded from the named file until either the [`load()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar.load) or [`revert()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar.revert) method is called. Subclasses of this class are documented in section [*FileCookieJar subclasses and co-operation with web browsers*](https://python-all.ru/3.2/library/http.cookiejar.html#file-cookie-jar-classes).4041#### `class http.cookiejar.CookiePolicy`4243Этот класс отвечает за принятие решения о том, следует ли принять каждый куки от сервера / вернуть его серверу.4445#### `class http.cookiejar.DefaultCookiePolicy(blocked_domains=None, allowed_domains=None, netscape=True, rfc2965=False, rfc2109_as_netscape=None, 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)`4647Аргументы конструктора следует передавать только в виде именованных аргументов. *blocked\_domains* – это последовательность доменных имён, с которых мы никогда не принимаем куки и на которые не отправляем куки. *allowed\_domains*, если не равно [`None`](https://python-all.ru/3.2/library/constants.html#None), – это последовательность доменов, для которых мы принимаем и отправляем куки. Что касается всех остальных аргументов, см. документацию объектов [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy) и [`DefaultCookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.DefaultCookiePolicy).4849[`DefaultCookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.DefaultCookiePolicy) реализует стандартные правила приёма/отклонения для cookie Netscape и RFC 2965. По умолчанию cookie RFC 2109 (т.е. cookie, полученные в заголовке *Set-Cookie* с атрибутом версии, равным 1) обрабатываются по правилам RFC 2965. Однако если обработка RFC 2965 отключена или [`rfc2109_as_netscape`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.DefaultCookiePolicy.rfc2109_as_netscape) равно True, cookie RFC 2109 «понижаются» экземпляром [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) до cookie Netscape путём установки атрибута `version` экземпляра [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie) в 0. [`DefaultCookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.DefaultCookiePolicy) также предоставляет некоторые параметры для тонкой настройки политики.5051#### `class http.cookiejar.Cookie`5253Этот класс представляет cookie Netscape, RFC 2109 и RFC 2965. Не предполагается, что пользователи [`http.cookiejar`](https://python-all.ru/3.2/library/http.cookiejar.html#module-http.cookiejar) будут создавать собственные экземпляры [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie). Вместо этого, если необходимо, следует вызвать `make_cookies()` на экземпляре [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar).5455> **См. также**56>57> **Модуль [`urllib.request`](https://python-all.ru/3.2/library/urllib.request.html#module-urllib.request)**58>59> Открытие URL с автоматической обработкой куки.60>61> **Модуль [`http.cookies`](https://python-all.ru/3.2/library/http.cookies.html#module-http.cookies)**62>63> Классы HTTP cookie, в основном полезные для серверного кода. Модули64>65> [`http.cookiejar`](https://python-all.ru/3.2/library/http.cookiejar.html#module-http.cookiejar)66>67> и68>69> [`http.cookies`](https://python-all.ru/3.2/library/http.cookies.html#module-http.cookies)70>71> не зависят друг от друга.72>73> **[http://wp.netscape.com/newsref/std/cookie\_spec.html](https://python-all.ru/3.2/library/http.cookiejar.html)**74>75> Спецификация оригинального протокола Netscape cookie. Хотя это всё ещё доминирующий протокол, «протокол Netscape cookie», реализуемый всеми основными браузерами (а также76>77> [`http.cookiejar`](https://python-all.ru/3.2/library/http.cookiejar.html#module-http.cookiejar)78>79> ), лишь отдалённо напоминает тот, что описан в80>81> `cookie_spec.html`82>83> .84>85> **[**RFC 2109**](https://python-all.ru/3.2/library/http.cookiejar.html) – Механизм управления состоянием HTTP**86>87> Заменено RFC 2965. Использует88>89> *Set-Cookie*90>91> с version=1.92>93> **[**RFC 2965**](https://python-all.ru/3.2/library/http.cookiejar.html) – Механизм управления состоянием HTTP**94>95> Протокол Netscape с исправленными ошибками. Использует96>97> *Set-Cookie2*98>99> вместо100>101> *Set-Cookie*102>103> . Широко не используется.104>105> **[http://kristol.org/cookie/errata.html](https://python-all.ru/3.2/library/http.cookiejar.html)**106>107> Незавершённые исправления к RFC 2965.108>109> [**RFC 2964**](https://python-all.ru/3.2/library/http.cookiejar.html) – Использование управления состоянием HTTP110111## 20.22.1. Объекты CookieJar и FileCookieJar112113Объекты [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) поддерживают протокол [*итератора*](https://python-all.ru/3.2/glossary.html#term-iterator) для перебора содержащихся в них объектов [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie).114115[`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) имеет следующие методы:116117#### `CookieJar.add_cookie_header(request)`118119Добавляет правильный заголовок *Cookie* к *запросу*.120121Если политика позволяет (т.е. атрибуты `rfc2965` и `hide_cookie2` экземпляра [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy) равны true и false соответственно), заголовок *Cookie2* также добавляется, когда это уместно.122123Объект *request* (обычно экземпляр `urllib.request..Request`) должен поддерживать методы `get_full_url()`, `get_host()`, `get_type()`, `unverifiable()`, `get_origin_req_host()`, `has_header()`, `get_header()`, `header_items()` и `add_unredirected_header()`, как описано в [`urllib.request`](https://python-all.ru/3.2/library/urllib.request.html#module-urllib.request).124125#### `CookieJar.extract_cookies(response, request)`126127Извлекает cookies из HTTP *response* и сохраняет их в [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar), если это разрешено политикой.128129[`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) будет искать допустимые заголовки *Set-Cookie* и *Set-Cookie2* в аргументе *response*, и сохранять cookies соответствующим образом (при условии одобрения методом [`CookiePolicy.set_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.set_ok)).130131Объект *response* (обычно результат вызова [`urllib.request.urlopen()`](https://python-all.ru/3.2/library/urllib.request.html#urllib.request.urlopen) или аналогичного) должен поддерживать метод `info()`, который возвращает экземпляр [`email.message.Message`](https://python-all.ru/3.2/library/email.message.html#email.message.Message).132133Объект *request* (обычно экземпляр [`urllib.request.Request`](https://python-all.ru/3.2/library/urllib.request.html#urllib.request.Request)) должен поддерживать методы `get_full_url()`, `get_host()`, `unverifiable()` и `get_origin_req_host()`, как описано в [`urllib.request`](https://python-all.ru/3.2/library/urllib.request.html#module-urllib.request). Запрос используется для установки значений по умолчанию для атрибутов cookie, а также для проверки, разрешена ли установка cookie.134135#### `CookieJar.set_policy(policy)`136137Устанавливает экземпляр [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy), который будет использоваться.138139#### `CookieJar.make_cookies(response, request)`140141Возвращает последовательность объектов [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie), извлечённых из объекта *response*.142143См. документацию [`extract_cookies()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar.extract_cookies) для получения интерфейсов, требуемых от аргументов *response* и *request*.144145#### `CookieJar.set_cookie_if_ok(cookie, request)`146147Устанавливает [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie), если политика разрешает это сделать.148149#### `CookieJar.set_cookie(cookie)`150151Устанавливает [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie), не проверяя по политике, следует ли его устанавливать.152153#### `CookieJar.clear([domain[, path[, name]]])`154155Очищает некоторые куки.156157Если вызван без аргументов, очищает все cookie. Если передан один аргумент, удаляются только cookie, принадлежащие этому *домену*. Если передано два аргумента, удаляются cookie, принадлежащие указанному *домену* и URL-*пути*. Если передано три аргумента, то удаляется cookie с указанными *доменом*, *путём* и *именем*.158159Возбуждает [`KeyError`](https://python-all.ru/3.2/library/exceptions.html#KeyError), если нет соответствующего cookie.160161#### `CookieJar.clear_session_cookies()`162163Удалить все сессионные куки.164165Отбрасывает все содержащиеся cookies, у которых атрибут `discard` имеет значение true (обычно потому, что у них не было атрибутов `max-age` или `expires`, либо был явный атрибут `discard`). Для интерактивных браузеров конец сессии обычно соответствует закрытию окна браузера.166167Обратите внимание, что метод `save()` в любом случае не сохраняет сессионные cookies, если только явно не указано иное путём передачи аргумента *ignore\_discard* со значением true.168169[`FileCookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar) реализует следующие дополнительные методы:170171#### `FileCookieJar.save(filename=None, ignore_discard=False, ignore_expires=False)`172173Сохраняет куки в файл.174175Этот базовый класс возбуждает [`NotImplementedError`](https://python-all.ru/3.2/library/exceptions.html#NotImplementedError). Подклассы могут оставить этот метод нереализованным.176177*filename* – это имя файла, в который сохраняются cookies. Если *filename* не указан, используется `self.filename` (по умолчанию – значение, переданное конструктору, если оно было); если `self.filename` равно [`None`](https://python-all.ru/3.2/library/constants.html#None), возбуждается [`ValueError`](https://python-all.ru/3.2/library/exceptions.html#ValueError).178179*ignore\_discard*: сохранять даже те куки, которые помечены к удалению. *ignore\_expires*: сохранять даже куки с истекшим сроком действия.180181Файл перезаписывается, если он уже существует, тем самым удаляя все cookies, которые он содержит. Сохранённые cookies можно восстановить позже с помощью методов [`load()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar.load) или [`revert()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar.revert).182183#### `FileCookieJar.load(filename=None, ignore_discard=False, ignore_expires=False)`184185Загружает куки из файла.186187Старые куки сохраняются, если они не перезаписываются вновь загруженными.188189Аргументы такие же, как для [`save()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar.save).190191Указанный файл должен быть в формате, понятном классу, иначе будет вызвано [`LoadError`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.LoadError). Также может быть вызвано [`IOError`](https://python-all.ru/3.2/library/exceptions.html#IOError), например, если файл не существует.192193#### `FileCookieJar.revert(filename=None, ignore_discard=False, ignore_expires=False)`194195Очищает все куки и перезагружает куки из сохраненного файла.196197[`revert()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar.revert) может возбуждать те же исключения, что и [`load()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar.load). В случае ошибки состояние объекта не изменится.198199Экземпляры [`FileCookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar) имеют следующие открытые атрибуты:200201#### `FileCookieJar.filename`202203Имя файла по умолчанию, в котором хранятся куки. Этому атрибуту можно присваивать значение.204205#### `FileCookieJar.delayload`206207Если True, загружает файлы cookie с диска лениво. Этому атрибуту не следует присваивать значение. Это лишь подсказка, поскольку влияет только на производительность, а не на поведение (если только файлы cookie на диске не меняются). Объект [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) может игнорировать его. Ни один из классов [`FileCookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar), включённых в стандартную библиотеку, не загружает файлы cookie лениво.208209## 20.22.2. Подклассы FileCookieJar и взаимодействие с веб-браузерами210211Следующие подклассы [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) предоставляются для чтения и записи.212213#### `class http.cookiejar.MozillaCookieJar(filename, delayload=None, policy=None)`214215[`FileCookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar), который может загружать и сохранять файлы cookie на диск в формате `cookies.txt` браузера Mozilla (этот формат также используется браузерами Lynx и Netscape).216217> **Примечание**218>219> Это теряет информацию о файлах cookie по стандарту RFC 2965, а также о более новых или нестандартных атрибутах cookie, таких как `port`.220221> **Предупреждение**222>223> Сделайте резервную копию ваших куки перед сохранением, если у вас есть куки, потеря или повреждение которых будут нежелательны (есть некоторые тонкости, которые могут привести к небольшим изменениям в файле при полном цикле загрузки/сохранения).224225Также учтите, что куки, сохраненные во время работы Mozilla, будут перезаписаны Mozilla.226227#### `class http.cookiejar.LWPCookieJar(filename, delayload=None, policy=None)`228229[`FileCookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.FileCookieJar), который может загружать и сохранять файлы cookie на диск в формате, совместимом с форматом файла `Set-Cookie3` библиотеки libwww-perl. Это удобно, если требуется хранить файлы cookie в читаемом человеком файле.230231## 20.22.3. Объекты CookiePolicy232233Объекты, реализующие интерфейс [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy), имеют следующие методы:234235#### `CookiePolicy.set_ok(cookie, request)`236237Возвращает логическое значение, указывающее, следует ли принять куки от сервера.238239*cookie* – это экземпляр [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie). *request* – это объект, реализующий интерфейс, определённый в документации к [`CookieJar.extract_cookies()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar.extract_cookies).240241#### `CookiePolicy.return_ok(cookie, request)`242243Возвращает логическое значение, указывающее, следует ли вернуть куки серверу.244245*cookie* – это экземпляр [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie). *request* – это объект, реализующий интерфейс, определённый в документации к [`CookieJar.add_cookie_header()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar.add_cookie_header).246247#### `CookiePolicy.domain_return_ok(domain, request)`248249Возвращает false, если cookie не должны быть возвращены для данного домена cookie.250251Этот метод является оптимизацией. Он устраняет необходимость проверять каждый файл cookie для определённого домена (что может потребовать чтения многих файлов). Возврат true из [`domain_return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.domain_return_ok) и [`path_return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.path_return_ok) оставляет всю работу на [`return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.return_ok).252253Если [`domain_return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.domain_return_ok) возвращает true для домена cookie, то [`path_return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.path_return_ok) вызывается для пути cookie. В противном случае [`path_return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.path_return_ok) и [`return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.return_ok) никогда не вызываются для этого домена cookie. Если [`path_return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.path_return_ok) возвращает true, то [`return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.return_ok) вызывается с самим объектом [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie) для полной проверки. В противном случае [`return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.return_ok) никогда не вызывается для этого пути cookie.254255Обратите внимание, что [`domain_return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.domain_return_ok) вызывается для каждого домена *cookie*, а не только для домена *request*. Например, функция может быть вызвана как с `".example.com"`, так и с `"www.example.com"`, если домен запроса – `"www.example.com"`. То же самое относится к [`path_return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.path_return_ok).256257Аргумент *request* описан в документации к [`return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.return_ok).258259#### `CookiePolicy.path_return_ok(path, request)`260261Возвращает false, если cookie не должны быть возвращены для указанного пути cookie.262263См. документацию к [`domain_return_ok()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy.domain_return_ok).264265В дополнение к реализации вышеуказанных методов, реализации интерфейса [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy) также должны предоставлять следующие атрибуты, указывающие, какие протоколы следует использовать и как. Все эти атрибуты могут быть изменены (присвоены).266267#### `CookiePolicy.netscape`268269Реализация протокола Netscape.270271#### `CookiePolicy.rfc2965`272273Реализует протокол RFC 2965.274275#### `CookiePolicy.hide_cookie2`276277Не добавлять заголовок *Cookie2* к запросам (наличие этого заголовка указывает серверу на то, что мы понимаем куки RFC 2965).278279Самый удобный способ определить класс [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy) – создать подкласс [`DefaultCookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.DefaultCookiePolicy) и переопределить некоторые или все методы, описанные выше. Сам [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy) можно использовать как «нулевую политику», разрешающую устанавливать и получать любые файлы cookie (вряд ли это будет полезно).280281## 20.22.4. Объекты DefaultCookiePolicy282283Реализует стандартные правила принятия и возврата куки.284285Охватываются как куки RFC 2965, так и Netscape. Обработка RFC 2965 отключена по умолчанию.286287Самый простой способ создать свою политику – переопределить этот класс и вызывать его методы в ваших переопределённых реализациях перед добавлением собственных дополнительных проверок:288289```python290import http.cookiejar291class MyCookiePolicy(http.cookiejar.DefaultCookiePolicy):292    def set_ok(self, cookie, request):293        if not http.cookiejar.DefaultCookiePolicy.set_ok(self, cookie, request):294            return False295        if i_dont_want_to_store_this_cookie(cookie):296            return False297        return True298```299300В дополнение к функциям, необходимым для реализации интерфейса [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy), этот класс позволяет запрещать или разрешать доменам устанавливать и получать файлы cookie. Также имеются переключатели строгости, позволяющие немного ужесточить довольно свободные правила протокола Netscape (ценой блокировки некоторых безобидных файлов cookie).301302Предоставляются чёрный и белый списки доменов (оба отключены по умолчанию). Только домены, не входящие в чёрный список и присутствующие в белом списке (если белый список активен), участвуют в установке и возврате файлов cookie. Используйте аргумент конструктора *blocked\_domains* и методы `blocked_domains()` и `set_blocked_domains()` (а также соответствующий аргумент и методы для *allowed\_domains*). Если задан белый список, его можно отключить, установив значение [`None`](https://python-all.ru/3.2/library/constants.html#None).303304Домены в списках блокировки или разрешения, которые не начинаются с точки, должны в точности совпадать с доменом cookie для соответствия. Например, `"example.com"` соответствует записи чёрного списка `"example.com"`, а `"www.example.com"` – нет. Домены, начинающиеся с точки, также сопоставляются с более конкретными доменами. Например, и `"www.example.com"`, и `"www.coyote.example.com"` соответствуют `".example.com"` (но сам `"example.com"` – нет). IP-адреса являются исключением и должны совпадать в точности. Например, если blocked\_domains содержит `"192.168.1.2"` и `".168.1.2"`, то 192.168.1.2 блокируется, а 193.168.1.2 – нет.305306[`DefaultCookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.DefaultCookiePolicy) реализует следующие дополнительные методы:307308#### `DefaultCookiePolicy.blocked_domains()`309310Возвращает последовательность заблокированных доменов (в виде кортежа).311312#### `DefaultCookiePolicy.set_blocked_domains(blocked_domains)`313314Устанавливает последовательность заблокированных доменов.315316#### `DefaultCookiePolicy.is_blocked(domain)`317318Возвращает, находится ли *domain* в чёрном списке для установки или получения куки.319320#### `DefaultCookiePolicy.allowed_domains()`321322Возвращает [`None`](https://python-all.ru/3.2/library/constants.html#None) или последовательность разрешённых доменов (в виде кортежа).323324#### `DefaultCookiePolicy.set_allowed_domains(allowed_domains)`325326Устанавливает последовательность разрешённых доменов или [`None`](https://python-all.ru/3.2/library/constants.html#None).327328#### `DefaultCookiePolicy.is_not_allowed(domain)`329330Возвращает, не находится ли *domain* в белом списке для установки или получения куки.331332[`DefaultCookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.DefaultCookiePolicy) экземпляры имеют следующие атрибуты, которые все инициализируются из одноимённых аргументов конструктора и которым можно присваивать значения.333334#### `DefaultCookiePolicy.rfc2109_as_netscape`335336Если true, запрашивает, чтобы экземпляр [`CookieJar`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookieJar) понижал версию файлов cookie RFC 2109 (т.е. файлы cookie, полученные в заголовке *Set-Cookie* с атрибутом версии cookie-attribute, равным 1) до файлов cookie Netscape, устанавливая атрибут версии экземпляра [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie) в 0. Значение по умолчанию – [`None`](https://python-all.ru/3.2/library/constants.html#None), в этом случае файлы cookie RFC 2109 понижаются тогда и только тогда, когда обработка RFC 2965 отключена. Поэтому по умолчанию файлы cookie RFC 2109 понижаются.337338Общие переключатели строгости:339340#### `DefaultCookiePolicy.strict_domain`341342Не разрешает сайтам устанавливать двухкомпонентные домены с национальными доменами верхнего уровня, такими как `.co.uk`, `.gov.uk`, `.co.nz` и т.д. Это далеко от совершенства и не гарантирует работы!343344Переключатели строгости протокола RFC 2965:345346#### `DefaultCookiePolicy.strict_rfc2965_unverifiable`347348Следовать правилам RFC 2965 для непроверяемых транзакций (обычно непроверяемая транзакция возникает в результате перенаправления или запроса изображения, размещённого на другом сайте). Если это False, куки *никогда* не блокируются на основе проверяемости.349350Переключатели строгости протокола Netscape:351352#### `DefaultCookiePolicy.strict_ns_unverifiable`353354Применять правила RFC 2965 для непроверяемых транзакций также к куки Netscape.355356#### `DefaultCookiePolicy.strict_ns_domain`357358Флаги, указывающие, насколько строгими должны быть правила сопоставления доменов для cookies Netscape. Допустимые значения приведены ниже.359360#### `DefaultCookiePolicy.strict_ns_set_initial_dollar`361362Игнорирует cookies в заголовках Set-Cookie, имена которых начинаются с `'$'`.363364#### `DefaultCookiePolicy.strict_ns_set_path`365366Не разрешать установку куки, путь которых не соответствует URI запроса.367368`strict_ns_domain` – это набор флагов. Его значение формируется путём логического ИЛИ (например, `DomainStrictNoDots|DomainStrictNonDomain` означает, что установлены оба флага).369370#### `DefaultCookiePolicy.DomainStrictNoDots`371372При установке файлов cookie «префикс хоста» не должен содержать точку (например, `www.foo.bar.com` не может установить файл cookie для `.bar.com`, потому что `www.foo` содержит точку).373374#### `DefaultCookiePolicy.DomainStrictNonDomain`375376Файлы cookie, которые не указали явно атрибут `domain` cookie-attribute, могут быть возвращены только домену, равному домену, установившему cookie (например, `spam.example.com` не будут возвращены файлы cookie от `example.com`, у которых не было `domain` cookie-attribute).377378#### `DefaultCookiePolicy.DomainRFC2965Match`379380При установке куки требовать полного соответствия домена по RFC 2965.381382Следующие атрибуты предоставлены для удобства и представляют собой наиболее полезные комбинации указанных выше флагов:383384#### `DefaultCookiePolicy.DomainLiberal`385386Эквивалентно 0 (то есть все указанные выше флаги строгости домена Netscape отключены).387388#### `DefaultCookiePolicy.DomainStrict`389390Эквивалентно `DomainStrictNoDots|DomainStrictNonDomain`.391392## 20.22.5. Объекты Cookie393394Экземпляры [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie) имеют атрибуты Python, примерно соответствующие стандартным атрибутам cookie, указанным в различных стандартах cookie. Соответствие не является взаимно однозначным, поскольку существуют сложные правила назначения значений по умолчанию, потому что атрибуты cookie `max-age` и `expires` содержат эквивалентную информацию, и потому что файлы cookie RFC 2109 могут быть «понижены» с помощью [`http.cookiejar`](https://python-all.ru/3.2/library/http.cookiejar.html#module-http.cookiejar) с версии 1 до версии 0 (Netscape).395396Присваивание значения этим атрибутам не должно требоваться, за исключением редких случаев в методе [`CookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.CookiePolicy). Класс не обеспечивает внутреннюю согласованность, поэтому следует понимать, что делаешь, если это делать.397398#### `Cookie.version`399400Целое число или [`None`](https://python-all.ru/3.2/library/constants.html#None). Файлы cookie Netscape имеют [`version`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie.version) 0. RFC 2965 и RFC 2109 имеют атрибут `version` cookie, равный 1. Однако учтите, что [`http.cookiejar`](https://python-all.ru/3.2/library/http.cookiejar.html#module-http.cookiejar) может «понизить» файлы cookie RFC 2109 до файлов cookie Netscape, и в этом случае [`version`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie.version) равен 0.401402#### `Cookie.name`403404Имя cookie (строка).405406#### `Cookie.value`407408Значение cookie (строка) или [`None`](https://python-all.ru/3.2/library/constants.html#None).409410#### `Cookie.port`411412Строка, представляющая порт или набор портов (например, ‘80’ или ‘80,8080’), или [`None`](https://python-all.ru/3.2/library/constants.html#None).413414#### `Cookie.path`415416Путь к cookie (строка, например `'/acme/rocket_launchers'`).417418#### `Cookie.secure`419420True, если cookie должен возвращаться только через защищённое соединение.421422#### `Cookie.expires`423424Целое число – дата истечения в секундах от начала эпохи, или [`None`](https://python-all.ru/3.2/library/constants.html#None). См. также метод [`is_expired()`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie.is_expired).425426#### `Cookie.discard`427428True, если это сессионный cookie.429430#### `Cookie.comment`431432Строковый комментарий от сервера, поясняющий назначение этого cookie, или [`None`](https://python-all.ru/3.2/library/constants.html#None).433434#### `Cookie.comment_url`435436URL, указывающий на комментарий от сервера с пояснением назначения этого cookie, или [`None`](https://python-all.ru/3.2/library/constants.html#None).437438#### `Cookie.rfc2109`439440True, если этот cookie был получен как cookie RFC 2109 (т.е. cookie пришёл в заголовке *Set-Cookie*, и значение атрибута Version этого заголовка было равно 1). Данный атрибут предусмотрен, потому что [`http.cookiejar`](https://python-all.ru/3.2/library/http.cookiejar.html#module-http.cookiejar) может «понижать» cookie RFC 2109 до cookie Netscape, в этом случае [`version`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie.version) равен 0.441442#### `Cookie.port_specified`443444True, если порт или набор портов был явно указан сервером (в *Set-Cookie* / *Set-Cookie2* заголовке).445446#### `Cookie.domain_specified`447448True, если домен был явно указан сервером.449450#### `Cookie.domain_initial_dot`451452True, если домен, явно указанный сервером, начинался с точки (`'.'`).453454Cookie могут иметь дополнительные нестандартные атрибуты cookie. Доступ к ним можно получить с помощью следующих методов:455456#### `Cookie.has_nonstandard_attr(name)`457458Возвращает true, если cookie имеет атрибут с указанным именем.459460#### `Cookie.get_nonstandard_attr(name, default=None)`461462Если cookie имеет указанный атрибут cookie, возвращает его значение. В противном случае возвращает *default*.463464#### `Cookie.set_nonstandard_attr(name, value)`465466Устанавливает значение указанного атрибута cookie.467468Класс [`Cookie`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.Cookie) также определяет следующий метод:469470#### `Cookie.is_expired(now=None)`471472True, если прошло время, когда сервер запросил истечение cookie. Если *now* задан (в секундах от начала эпохи), возвращает, истёк ли cookie на указанный момент.473474## 20.22.6. Примеры475476Первый пример показывает наиболее распространённое использование [`http.cookiejar`](https://python-all.ru/3.2/library/http.cookiejar.html#module-http.cookiejar):477478```python479import http.cookiejar, urllib.request480cj = http.cookiejar.CookieJar()481opener = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(cj))482r = opener.open("http://example.com/")483```484485Этот пример иллюстрирует, как открыть URL с использованием ваших куки Netscape, Mozilla или Lynx (предполагается соглашение Unix/Netscape о местоположении файла куки):486487```python488import os, http.cookiejar, urllib.request489cj = http.cookiejar.MozillaCookieJar()490cj.load(os.path.join(os.path.expanduser("~"), ".netscape", "cookies.txt"))491opener = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(cj))492r = opener.open("http://example.com/")493```494495Следующий пример иллюстрирует использование [`DefaultCookiePolicy`](https://python-all.ru/3.2/library/http.cookiejar.html#http.cookiejar.DefaultCookiePolicy). Включите cookies по RFC 2965, ужесточите правила для доменов при установке и возврате cookies Netscape, а также заблокируйте возможность установки или возврата cookies для некоторых доменов:496497```python498import urllib.request499from http.cookiejar import CookieJar, DefaultCookiePolicy500policy = DefaultCookiePolicy(501    rfc2965=True, strict_ns_domain=Policy.DomainStrict,502    blocked_domains=["ads.net", ".ads.net"])503cj = CookieJar(policy)504opener = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(cj))505r = opener.open("http://example.com/")506```507