====== Объект Cookie ======
Предоставляет базовые средства работы с cookie.
===== Конструктор =====
Cookie(name, value, [max_age], [expires], [path], [secure], [httponly], [samesite], [domain])
^ Параметр ^ Тип ^ По умолчанию ^ Описание ^
| ''name'' | ''str'' | -- | Имя cookie |
| ''value'' | ''str'' | -- | Значение cookie |
| ''max_age'' | ''int'' | ''None'' | Время жизни cookie в секундах |
| ''expires'' | ''int'', ''datetime'' | ''None'' | Значение времени, когда cookie будет удалена, задаётся в виде ''unix timestamp (int)'' или ''datetime'' |
| ''path'' | ''str'' | ''None'' | Префикс пути поиска ресурса на данном сайте, для которого следует отправлять данное cookie |
| ''secure'' | ''bool'' | ''True'' | Отправлять cookie только по шифрованным каналам связи |
| ''httponly'' | ''bool'' | ''True'' | Сделать cookie не доступной (почти) для JavaScript |
| ''samesite'' | ''bool'' | ''False'' | Не отправлять данную cookie, если запрос пришёл не с того же сайта (анализируется заголовок referer) |
| ''domain'' | ''str'' | ''None'' | Имя домена в рамках которого выставляется cookie. В современных браузерах может и вести себя не адекватно |
Подробнее о параметрах можно почитать, например, [[https://ru.wikipedia.org/wiki/Cookie#Параметры_cookie|в википедии]].
Следующие параметры, если они заданы в ''None'' просто не выставляются в отправляемом cookie:
* ''max_age''
* ''expires''
* ''path''
* ''domain''
===== to_dict() =====
Преобразует cookie в словарь Python
obj.to_dict()
===== response_add() =====
Добавляет данную cookie в заданный ''bottle.Response''
obj.response_add(resp)
^ Параметр ^ Тип ^ Описание ^
| ''resp'' | ''bottle.BaseResponse'' | Ответ, в который следует добавить cookie |
===== response_delete() =====
Оправляет браузеру признак того, что cookie следует удалить.
obj.response_delete(resp)
^ Параметр ^ Тип ^ Описание ^
| ''resp'' | ''bottle.BaseResponse'' | Ответ, в который следует добавить данную инструкцию для браузера |