> **Источник:** https://python-all.ru/2.7/library/cookielib.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # 20.21. [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib) – Обработка cookie для HTTP-клиентов > **Примечание** > > Модуль [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib) в Python 3 переименован в `http.cookiejar`. Инструмент [2to3](https://python-all.ru/2.7/glossary.html#term-2to3) при преобразовании исходного кода в Python 3 автоматически адаптирует импорты. Новое в версии 2.4. **Исходный код:** [Lib/cookielib.py](https://python-all.ru/src/2.7/Lib/cookielib.py) --- Модуль [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib) определяет классы для автоматической обработки HTTP куки. Он полезен для доступа к веб-сайтам, которые требуют, чтобы небольшие фрагменты данных – *куки* – устанавливались на клиентской машине HTTP-ответом от веб-сервера, а затем возвращались серверу в последующих HTTP-запросах. Обрабатываются как обычный протокол cookie Netscape, так и протокол, определённый в [**RFC 2965**](https://python-all.ru/2.7/library/cookielib.html). Обработка RFC 2965 по умолчанию отключена. Cookie [**RFC 2109**](https://python-all.ru/2.7/library/cookielib.html) разбираются как cookie Netscape и впоследствии обрабатываются либо как cookie Netscape, либо как cookie RFC 2965 в зависимости от действующей «политики». Обратите внимание, что подавляющее большинство cookie в интернете – это cookie Netscape. [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib) пытается следовать фактическому протоколу cookie Netscape (который существенно отличается от того, что изложено в оригинальной спецификации Netscape), в том числе учитывая атрибуты cookie `max-age` и `port`, введённые в RFC 2965. > **Примечание** > > Различные именованные параметры в заголовках *Set-Cookie* и *Set-Cookie2* (например, `domain` и `expires`) обычно называют *атрибутами*. Чтобы отличать их от атрибутов Python, в документации этого модуля используется термин *cookie-атрибут*. Модуль определяет следующее исключение: #### `exception cookielib.LoadError` Экземпляры [`FileCookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar) возбуждают это исключение при невозможности загрузить куки из файла. > **Примечание** > > Для обратной совместимости с Python 2.4 (который возбуждал [`IOError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.IOError)), [`LoadError`](https://python-all.ru/2.7/library/cookielib.html#cookielib.LoadError) является подклассом [`IOError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.IOError). Предоставляются следующие классы: #### `class cookielib.CookieJar(policy=None)` *policy* – это объект, реализующий интерфейс [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy). Класс [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar) хранит HTTP-куки. Он извлекает куки из HTTP-запросов и возвращает их в HTTP-ответах. Экземпляры [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar) автоматически удаляют устаревшие куки при необходимости. Подклассы также отвечают за сохранение и загрузку куки из файла или базы данных. #### `class cookielib.FileCookieJar(filename, delayload=None, policy=None)` *policy* – это объект, реализующий интерфейс [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy). Остальные аргументы описаны в документации соответствующих атрибутов. [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar), который может загружать куки из файла на диске и, возможно, сохранять их туда. Куки **НЕ** загружаются из указанного файла до тех пор, пока не будет вызван метод [`load()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar.load) или [`revert()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar.revert). Подклассы этого класса описаны в разделе [Подклассы FileCookieJar и взаимодействие с веб-браузерами](https://python-all.ru/2.7/library/cookielib.html#file-cookie-jar-classes). #### `class cookielib.CookiePolicy` Этот класс отвечает за принятие решения о том, следует ли принять каждый куки от сервера / вернуть его серверу. #### `class cookielib.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)` Аргументы конструктора должны передаваться только как именованные аргументы. *blocked\_domains* – это последовательность доменных имен, с которых мы никогда не принимаем куки и на которые никогда не отправляем их. *allowed\_domains*, если не [`None`](https://python-all.ru/2.7/library/constants.html#None), – это последовательность доменов, единственных, для которых мы принимаем и возвращаем куки. По всем остальным аргументам смотрите документацию для объектов [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy) и [`DefaultCookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.DefaultCookiePolicy). [`DefaultCookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.DefaultCookiePolicy) реализует стандартные правила принятия/отклонения для куки Netscape и RFC 2965. По умолчанию, куки RFC 2109 (то есть куки, полученные в заголовке *Set-Cookie* с атрибутом version, равным 1) обрабатываются по правилам RFC 2965. Однако, если обработка RFC 2965 отключена или [`rfc2109_as_netscape`](https://python-all.ru/2.7/library/cookielib.html#cookielib.DefaultCookiePolicy.rfc2109_as_netscape) равен `True`, куки RFC 2109 «понижаются» экземпляром [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar) до куков Netscape, путём установки атрибута `version` экземпляра [`Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie) в 0. [`DefaultCookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.DefaultCookiePolicy) также предоставляет некоторые параметры для тонкой настройки политики. #### `class cookielib.Cookie` Этот класс представляет куки Netscape, RFC 2109 и RFC 2965. Не предполагается, что пользователи [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib) будут создавать собственные экземпляры [`Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie). Вместо этого, при необходимости, следует вызывать `make_cookies()` для экземпляра [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar). > **См. также** > > **Модуль [`urllib2`](https://python-all.ru/2.7/library/urllib2.html#module-urllib2)** > > Открытие URL с автоматической обработкой куки. > > **Модуль [`Cookie`](https://python-all.ru/2.7/library/cookie.html#module-Cookie)** > > Классы HTTP-куки, пригодные в основном для серверного кода. Модули [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib) и [`Cookie`](https://python-all.ru/2.7/library/cookie.html#module-Cookie) не зависят друг от друга. > > **[https://curl.haxx.se/rfc/cookie\_spec.html](https://python-all.ru/2.7/library/cookielib.html)** > > Спецификация оригинального протокола Netscape cookie. Хотя это всё ещё доминирующий протокол, «протокол Netscape cookie», реализованный всеми основными браузерами (и [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib)), лишь отдалённо напоминает тот, что описан в `cookie_spec.html`. > > **[**RFC 2109**](https://python-all.ru/2.7/library/cookielib.html) – Механизм управления состоянием HTTP** > > Заменено RFC 2965. Использует *Set-Cookie* с version=1. > > **[**RFC 2965**](https://python-all.ru/2.7/library/cookielib.html) – Механизм управления состоянием HTTP** > > Протокол Netscape с исправленными ошибками. Использует *Set-Cookie2* вместо *Set-Cookie*. Широко не используется. > > **[http://kristol.org/cookie/errata.html](https://python-all.ru/2.7/library/cookielib.html)** > > Незавершённые исправления к RFC 2965. > > [**RFC 2964**](https://python-all.ru/2.7/library/cookielib.html) – Использование управления состоянием HTTP ## 20.21.1. Объекты CookieJar и FileCookieJar Объекты [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar) поддерживают протокол [итератора](https://python-all.ru/2.7/glossary.html#term-iterator) для итерации по содержащимся объектам [`Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie). [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar) имеет следующие методы: #### `CookieJar.add_cookie_header(request)` Добавляет правильный заголовок *Cookie* к *запросу*. Если политика разрешает (т.е. атрибуты `rfc2965` и `hide_cookie2` экземпляра [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar)'s [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy) равны, соответственно, true и false), заголовок *Cookie2* также добавляется, когда это уместно. Объект *request* (обычно экземпляр [`urllib2.Request`](https://python-all.ru/2.7/library/urllib2.html#urllib2.Request)) должен поддерживать методы `get_full_url()`, `get_host()`, `get_type()`, `unverifiable()`, `get_origin_req_host()`, `has_header()`, `get_header()`, `header_items()` и `add_unredirected_header()`, как описано в [`urllib2`](https://python-all.ru/2.7/library/urllib2.html#module-urllib2). #### `CookieJar.extract_cookies(response, request)` Извлекает куки из HTTP-*ответа* и сохраняет их в [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar), где это разрешено политикой. [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar) будет искать допустимые заголовки *Set-Cookie* и *Set-Cookie2* в аргументе *ответа*, и сохранять cookie соответствующим образом (с учётом одобрения метода [`CookiePolicy.set_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.set_ok)). Объект *response* (обычно результат вызова [`urllib2.urlopen()`](https://python-all.ru/2.7/library/urllib2.html#urllib2.urlopen) или аналогичного) должен поддерживать метод `info()`, который возвращает объект с методом `getallmatchingheaders()` (обычно экземпляр [`mimetools.Message`](https://python-all.ru/2.7/library/mimetools.html#mimetools.Message)). Объект *request* (обычно экземпляр [`urllib2.Request`](https://python-all.ru/2.7/library/urllib2.html#urllib2.Request)) должен поддерживать методы `get_full_url()`, `get_host()`, `unverifiable()` и `get_origin_req_host()`, как описано в [`urllib2`](https://python-all.ru/2.7/library/urllib2.html#module-urllib2). Запрос используется для установки значений по умолчанию для атрибутов куки, а также для проверки, разрешена ли установка куки. #### `CookieJar.set_policy(policy)` Устанавливает используемый экземпляр [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy). #### `CookieJar.make_cookies(response, request)` Возвращает последовательность объектов [`Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie), извлечённых из объекта *ответа*. Смотрите документацию к [`extract_cookies()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar.extract_cookies) для описания интерфейсов, требуемых от аргументов *ответа* и *запроса*. #### `CookieJar.set_cookie_if_ok(cookie, request)` Устанавливает [`Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie), если политика разрешает это. #### `CookieJar.set_cookie(cookie)` Устанавливает [`Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie) без проверки политики, следует ли его устанавливать. #### `CookieJar.clear([domain[, path[, name]]])` Очищает некоторые куки. Если вызван без аргументов, очищает все cookie. Если передан один аргумент, удаляются только cookie, принадлежащие этому *домену*. Если передано два аргумента, удаляются cookie, принадлежащие указанному *домену* и URL-*пути*. Если передано три аргумента, то удаляется cookie с указанными *доменом*, *путём* и *именем*. Возбуждает [`KeyError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.KeyError), если соответствующая cookie не найдена. #### `CookieJar.clear_session_cookies()` Удалить все сессионные куки. Удаляет все содержащиеся cookie, у которых атрибут `discard` имеет значение true (обычно потому, что у них не было атрибута cookie `max-age` или `expires`, либо был явный атрибут cookie `discard`). Для интерактивных браузеров окончание сессии обычно соответствует закрытию окна браузера. Обратите внимание, что метод `save()` в любом случае не сохраняет сессионные куки, если не указать иное, передав аргумент *ignore\_discard* со значением True. [`FileCookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar) реализует следующие дополнительные методы: #### `FileCookieJar.save(filename=None, ignore_discard=False, ignore_expires=False)` Сохраняет куки в файл. Этот базовый класс вызывает исключение [`NotImplementedError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.NotImplementedError). Подклассы могут оставлять этот метод нереализованным. *filename* is the name of file in which to save cookies. If *filename* is not specified, `self.filename` is used (whose default is the value passed to the constructor, if any); if `self.filename` is [`None`](https://python-all.ru/2.7/library/constants.html#None), [`ValueError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.ValueError) is raised. *ignore\_discard*: сохранять даже те куки, которые помечены к удалению. *ignore\_expires*: сохранять даже куки с истекшим сроком действия. Файл перезаписывается, если он уже существует, при этом удаляются все куки, которые он содержит. Сохраненные куки можно восстановить позже с помощью методов [`load()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar.load) или [`revert()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar.revert). #### `FileCookieJar.load(filename=None, ignore_discard=False, ignore_expires=False)` Загружает куки из файла. Старые куки сохраняются, если они не перезаписываются вновь загруженными. Аргументы такие же, как для [`save()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar.save). Указанный файл должен быть в формате, понятном классу, иначе будет возбуждено [`LoadError`](https://python-all.ru/2.7/library/cookielib.html#cookielib.LoadError). Кроме того, может быть возбуждено [`IOError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.IOError), например, если файл не существует. > **Примечание** > > Для обратной совместимости с Python 2.4 (который возбуждал [`IOError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.IOError)), [`LoadError`](https://python-all.ru/2.7/library/cookielib.html#cookielib.LoadError) является подклассом [`IOError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.IOError). #### `FileCookieJar.revert(filename=None, ignore_discard=False, ignore_expires=False)` Очищает все куки и перезагружает куки из сохраненного файла. [`revert()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar.revert) может возбуждать те же исключения, что и [`load()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar.load). В случае неудачи состояние объекта не изменится. Экземпляры [`FileCookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar) имеют следующие открытые атрибуты: #### `FileCookieJar.filename` Имя файла по умолчанию, в котором хранятся куки. Этому атрибуту можно присваивать значение. #### `FileCookieJar.delayload` Если истина, загружать куки с диска лениво. Этому атрибуту не следует присваивать значение. Это всего лишь подсказка, поскольку влияет только на производительность, а не на поведение (если только куки на диске не изменяются). Объект [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar) может игнорировать её. Ни один из классов [`FileCookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar), входящих в стандартную библиотеку, не загружает куки лениво. ## 20.21.2. Подклассы FileCookieJar и взаимодействие с веб-браузерами Следующие подклассы [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar) предоставляются для чтения и записи. #### `class cookielib.MozillaCookieJar(filename, delayload=None, policy=None)` [`FileCookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar), который может загружать и сохранять куки на диск в файловом формате Mozilla `cookies.txt` (также используется браузерами Lynx и Netscape). > **Примечание** > > Версия 3 веб-браузера Firefox больше не записывает куки в формат файла `cookies.txt`. > **Примечание** > > Это приводит к потере информации о куках RFC 2965, а также о более новых или нестандартных атрибутах куков, таких как `port`. > **Предупреждение** > > Сделайте резервную копию ваших куки перед сохранением, если у вас есть куки, потеря или повреждение которых будут нежелательны (есть некоторые тонкости, которые могут привести к небольшим изменениям в файле при полном цикле загрузки/сохранения). Также учтите, что куки, сохраненные во время работы Mozilla, будут перезаписаны Mozilla. #### `class cookielib.LWPCookieJar(filename, delayload=None, policy=None)` Объект [`FileCookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.FileCookieJar), который может загружать и сохранять куки на диск в формате, совместимом с форматом файлов `Set-Cookie3` библиотеки libwww-perl. Это удобно, если нужно хранить куки в файле, читаемом человеком. ## 20.21.3. Объекты CookiePolicy Объекты, реализующие интерфейс [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy), имеют следующие методы: #### `CookiePolicy.set_ok(cookie, request)` Возвращает логическое значение, указывающее, следует ли принять куки от сервера. *cookie* – экземпляр [`cookielib.Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie). *request* – объект, реализующий интерфейс, описанный в документации для [`CookieJar.extract_cookies()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar.extract_cookies). #### `CookiePolicy.return_ok(cookie, request)` Возвращает логическое значение, указывающее, следует ли вернуть куки серверу. *cookie* – экземпляр [`cookielib.Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie). *request* – объект, реализующий интерфейс, описанный в документации для [`CookieJar.add_cookie_header()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar.add_cookie_header). #### `CookiePolicy.domain_return_ok(domain, request)` Возвращает false, если cookie не должны быть возвращены для данного домена cookie. Этот метод – оптимизация. Он избавляет от необходимости проверять каждый куки для определённого домена (что может потребовать чтения многих файлов). Возврат true от [`domain_return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.domain_return_ok) и [`path_return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.path_return_ok) оставляет всю работу [`return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.return_ok). Если [`domain_return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.domain_return_ok) возвращает true для домена куки, [`path_return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.path_return_ok) вызывается для пути куки. В противном случае [`path_return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.path_return_ok) и [`return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.return_ok) никогда не вызываются для этого домена куки. Если [`path_return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.path_return_ok) возвращает true, [`return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.return_ok) вызывается с объектом [`Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie) для полной проверки. В противном случае [`return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.return_ok) никогда не вызывается для этого пути куки. Обратите внимание, что [`domain_return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.domain_return_ok) вызывается для каждого *домена куки*, а не только для *домена запроса*. Например, функция может вызываться как с `".example.com"`, так и с `"www.example.com"`, если домен запроса – `"www.example.com"`. То же самое относится к [`path_return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.path_return_ok). Аргумент *request* описан в документации [`return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.return_ok). #### `CookiePolicy.path_return_ok(path, request)` Возвращает false, если cookie не должны быть возвращены для указанного пути cookie. См. документацию [`domain_return_ok()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy.domain_return_ok). Помимо реализации методов, описанных выше, реализации интерфейса [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy) должны также предоставлять следующие атрибуты, указывающие, какие протоколы следует использовать и как. Все эти атрибуты могут быть изменены (присвоены). #### `CookiePolicy.netscape` Реализация протокола Netscape. #### `CookiePolicy.rfc2965` Реализует протокол RFC 2965. #### `CookiePolicy.hide_cookie2` Не добавлять заголовок *Cookie2* к запросам (наличие этого заголовка указывает серверу на то, что мы понимаем куки RFC 2965). Самый удобный способ определить класс [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy) – это создать подкласс от [`DefaultCookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.DefaultCookiePolicy) и переопределить некоторые (или все) методы выше. Сам [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy) может использоваться как «нулевая политика», позволяющая устанавливать и принимать любые куки (вряд ли это будет полезно). ## 20.21.4. Объекты DefaultCookiePolicy Реализует стандартные правила принятия и возврата куки. Охватываются как куки RFC 2965, так и Netscape. Обработка RFC 2965 отключена по умолчанию. Самый простой способ создать свою политику – переопределить этот класс и вызывать его методы в ваших переопределённых реализациях перед добавлением собственных дополнительных проверок: ```python import cookielib class MyCookiePolicy(cookielib.DefaultCookiePolicy): def set_ok(self, cookie, request): if not cookielib.DefaultCookiePolicy.set_ok(self, cookie, request): return False if i_dont_want_to_store_this_cookie(cookie): return False return True ``` Помимо возможностей, необходимых для реализации интерфейса [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy), этот класс позволяет блокировать и разрешать домены при установке и получении куки. Также есть несколько переключателей строгости, которые позволяют немного ужесточить довольно свободные правила протокола Netscape (ценой блокировки некоторых безвредных куки). Предоставляются чёрный и белый списки доменов (оба отключены по умолчанию). В установке и возврате cookie участвуют только домены, не входящие в чёрный список и присутствующие в белом списке (если белый список активен). Используйте аргумент конструктора *blocked\_domains* и методы `blocked_domains()` и `set_blocked_domains()` (а также соответствующие аргумент и методы для *allowed\_domains*). Если белый список установлен, его можно снова отключить, присвоив ему значение [`None`](https://python-all.ru/2.7/library/constants.html#None). Домены из чёрного или белого списков, которые не начинаются с точки, должны в точности совпадать с доменом 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 – нет. [`DefaultCookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.DefaultCookiePolicy) реализует следующие дополнительные методы: #### `DefaultCookiePolicy.blocked_domains()` Возвращает последовательность заблокированных доменов (в виде кортежа). #### `DefaultCookiePolicy.set_blocked_domains(blocked_domains)` Устанавливает последовательность заблокированных доменов. #### `DefaultCookiePolicy.is_blocked(domain)` Возвращает, находится ли *domain* в чёрном списке для установки или получения куки. #### `DefaultCookiePolicy.allowed_domains()` Возвращает [`None`](https://python-all.ru/2.7/library/constants.html#None) или последовательность разрешённых доменов (в виде кортежа). #### `DefaultCookiePolicy.set_allowed_domains(allowed_domains)` Устанавливает последовательность разрешённых доменов или [`None`](https://python-all.ru/2.7/library/constants.html#None). #### `DefaultCookiePolicy.is_not_allowed(domain)` Возвращает, не находится ли *domain* в белом списке для установки или получения куки. Экземпляры [`DefaultCookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.DefaultCookiePolicy) имеют следующие атрибуты, все они инициализируются из аргументов конструктора с теми же именами, и всем им можно присваивать значения. #### `DefaultCookiePolicy.rfc2109_as_netscape` Если true, запросить, чтобы экземпляр [`CookieJar`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookieJar) понижал cookie RFC 2109 (то есть cookie, полученные в заголовке *Set-Cookie* с атрибутом version cookie-attribute равным 1) до cookie Netscape, устанавливая атрибут версии экземпляра [`Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie) в 0. Значение по умолчанию – [`None`](https://python-all.ru/2.7/library/constants.html#None), и в этом случае cookie RFC 2109 понижаются только при отключённой обработке RFC 2965. Следовательно, по умолчанию cookie RFC 2109 понижаются. Новое в версии 2.5. Общие переключатели строгости: #### `DefaultCookiePolicy.strict_domain` Не разрешает сайтам устанавливать двухкомпонентные домены с национальными доменами верхнего уровня, такими как `.co.uk`, `.gov.uk`, `.co.nz` и т.д. Это далеко от совершенства и не гарантирует работу! Переключатели строгости протокола RFC 2965: #### `DefaultCookiePolicy.strict_rfc2965_unverifiable` Следовать правилам RFC 2965 для непроверяемых транзакций (обычно непроверяемая транзакция возникает в результате перенаправления или запроса изображения, размещённого на другом сайте). Если это False, куки *никогда* не блокируются на основе проверяемости. Переключатели строгости протокола Netscape: #### `DefaultCookiePolicy.strict_ns_unverifiable` Применять правила RFC 2965 для непроверяемых транзакций даже к куки Netscape. #### `DefaultCookiePolicy.strict_ns_domain` Флаги, указывающие, насколько строгими должны быть правила сопоставления доменов для cookies Netscape. Допустимые значения приведены ниже. #### `DefaultCookiePolicy.strict_ns_set_initial_dollar` Игнорирует cookies в заголовках Set-Cookie, имена которых начинаются с `'$'`. #### `DefaultCookiePolicy.strict_ns_set_path` Не разрешать установку куки, путь которых не соответствует URI запроса. `strict_ns_domain` – это набор флагов. Его значение формируется путём логического ИЛИ (например, `DomainStrictNoDots|DomainStrictNonDomain` означает, что установлены оба флага). #### `DefaultCookiePolicy.DomainStrictNoDots` При установке cookie «префикс хоста» не должен содержать точку (например, `www.foo.bar.com` не может установить cookie для `.bar.com`, потому что `www.foo` содержит точку). #### `DefaultCookiePolicy.DomainStrictNonDomain` Cookie, которые не указали явно атрибут cookie `domain`, могут быть возвращены только домену, равному домену, установившему cookie (например, `spam.example.com` не будут возвращены cookie от `example.com`, у которых не было атрибута cookie `domain`). #### `DefaultCookiePolicy.DomainRFC2965Match` При установке куки требовать полного соответствия домена по RFC 2965. Следующие атрибуты предоставлены для удобства и представляют собой наиболее полезные комбинации указанных выше флагов: #### `DefaultCookiePolicy.DomainLiberal` Эквивалентно 0 (то есть все указанные выше флаги строгости домена Netscape отключены). #### `DefaultCookiePolicy.DomainStrict` Эквивалентно `DomainStrictNoDots|DomainStrictNonDomain`. ## 20.21.5. Объекты Cookie Экземпляры [`Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie) имеют атрибуты Python, примерно соответствующие стандартным атрибутам cookie, определённым в различных стандартах cookie. Это соответствие не является взаимно однозначным, так как существуют сложные правила присвоения значений по умолчанию, а также потому, что атрибуты cookie `max-age` и `expires` содержат эквивалентную информацию, и потому что cookie RFC 2109 могут быть 'понижены' [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib) с версии 1 до версии 0 (Netscape). Присваивание этим атрибутам должно быть необходимо только в редких случаях, например в методе [`CookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.CookiePolicy). Класс не обеспечивает внутренней согласованности, поэтому следует понимать, что делается при таком присваивании. #### `Cookie.version` Целое число или [`None`](https://python-all.ru/2.7/library/constants.html#None). Cookie Netscape имеют [`version`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie.version) 0. Cookie RFC 2965 и RFC 2109 имеют атрибут cookie `version` равный 1. Однако обратите внимание, что [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib) может 'понижать' cookie RFC 2109 до cookie Netscape, и в этом случае [`version`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie.version) равно 0. #### `Cookie.name` Имя cookie (строка). #### `Cookie.value` Значение cookie (строка) или [`None`](https://python-all.ru/2.7/library/constants.html#None). #### `Cookie.port` Строка, представляющая порт или набор портов (например, ‘80’ или ‘80,8080’), или [`None`](https://python-all.ru/2.7/library/constants.html#None). #### `Cookie.path` Путь cookie (строка, например `'/acme/rocket_launchers'`). #### `Cookie.secure` `True`, если cookie должна возвращаться только через защищённое соединение. #### `Cookie.expires` Целочисленная дата истечения срока в секундах от начала эпохи или [`None`](https://python-all.ru/2.7/library/constants.html#None). См. также метод [`is_expired()`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie.is_expired). #### `Cookie.discard` `True`, если это сессионный cookie. #### `Cookie.comment` Строковый комментарий от сервера, поясняющий назначение этого cookie, или [`None`](https://python-all.ru/2.7/library/constants.html#None). #### `Cookie.comment_url` URL, ведущий на комментарий от сервера, поясняющий назначение этого cookie, или [`None`](https://python-all.ru/2.7/library/constants.html#None). #### `Cookie.rfc2109` `True`, если этот cookie был получен как cookie RFC 2109 (то есть cookie пришёл в заголовке *Set-Cookie*, и значение атрибута Version в этом заголовке было равно 1). Этот атрибут предоставлен, потому что [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib) может 'понижать' cookie RFC 2109 до cookie Netscape, и в этом случае [`version`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie.version) равно 0. Новое в версии 2.5. #### `Cookie.port_specified` `True`, если порт или набор портов был явно указан сервером (в заголовке *Set-Cookie* / *Set-Cookie2*). #### `Cookie.domain_specified` `True`, если домен был явно указан сервером. #### `Cookie.domain_initial_dot` `True`, если домен, явно указанный сервером, начинался с точки (`'.'`). Cookie могут иметь дополнительные нестандартные атрибуты cookie. Доступ к ним можно получить с помощью следующих методов: #### `Cookie.has_nonstandard_attr(name)` Возвращает true, если cookie имеет атрибут с указанным именем. #### `Cookie.get_nonstandard_attr(name, default=None)` Если cookie имеет указанный атрибут cookie, возвращает его значение. В противном случае возвращает *default*. #### `Cookie.set_nonstandard_attr(name, value)` Устанавливает значение указанного атрибута cookie. Класс [`Cookie`](https://python-all.ru/2.7/library/cookielib.html#cookielib.Cookie) также определяет следующий метод: #### `Cookie.is_expired([now=None])` `True`, если срок действия cookie истёк (прошло время, указанное сервером для истечения). Если передан *now* (в секундах с начала эпохи), возвращается, истёк ли срок действия cookie на указанный момент времени. ## 20.21.6. Примеры Первый пример показывает наиболее распространённое использование [`cookielib`](https://python-all.ru/2.7/library/cookielib.html#module-cookielib): ```python import cookielib, urllib2 cj = cookielib.CookieJar() opener = urllib2.build_opener(urllib2.HTTPCookieProcessor(cj)) r = opener.open("http://example.com/") ``` Этот пример иллюстрирует, как открыть URL с использованием ваших куки Netscape, Mozilla или Lynx (предполагается соглашение Unix/Netscape о местоположении файла куки): ```python import os, cookielib, urllib2 cj = cookielib.MozillaCookieJar() cj.load(os.path.join(os.path.expanduser("~"), ".netscape", "cookies.txt")) opener = urllib2.build_opener(urllib2.HTTPCookieProcessor(cj)) r = opener.open("http://example.com/") ``` The next example illustrates the use of [`DefaultCookiePolicy`](https://python-all.ru/2.7/library/cookielib.html#cookielib.DefaultCookiePolicy). Turn on RFC 2965 cookies, be more strict about domains when setting and returning Netscape cookies, and block some domains from setting cookies or having them returned: ```python import urllib2 from cookielib import CookieJar, DefaultCookiePolicy policy = DefaultCookiePolicy( rfc2965=True, strict_ns_domain=DefaultCookiePolicy.DomainStrict, blocked_domains=["ads.net", ".ads.net"]) cj = CookieJar(policy) opener = urllib2.build_opener(urllib2.HTTPCookieProcessor(cj)) r = opener.open("http://example.com/") ```