Python3标准库：http.cookies HTTP cookie

1. http.cookies http cookie

http.cookies模块为大多数符合rfc2109的cookie实现一个解析器。这个实现没有标准那么严格，因为msie3.0x不支持完整的标准。

1.1 创建和设置cookie

可以用cookie为基于浏览器的应用实现状态管理，因此，cookie通常由服务器设置，并由客户存储和返回。下面给出一个最简单的例子，创建一个cookie设置一个键值对。

from http import cookies

c = cookies.simplecookie()
c['mycookie'] = 'cookie_value'
print(c)

输出是一个合法的set-cookie首部，可以作为http响应的一部分传递到客户。

1.2 morsel

还可以控制 cookie的其他方面，如到期时间、路径和域。实际上，cookie的所有rfc属性都可以通过表示cookie值的morse1对象来管理。

from http import cookies
import datetime

def show_cookie(c):
    print(c)
    for key, morsel in c.items():
        print()
        print('key =', morsel.key)
        print('  value =', morsel.value)
        print('  coded_value =', morsel.coded_value)
        for name in morsel.keys():
            if morsel[name]:
                print('  {} = {}'.format(name, morsel[name]))

c = cookies.simplecookie()

# a cookie with a value that has to be encoded
# to fit into the header
c['encoded_value_cookie'] = '"cookie,value;"'
c['encoded_value_cookie']['comment'] = 'has escaped punctuation'

# a cookie that only applies to part of a site
c['restricted_cookie'] = 'cookie_value'
c['restricted_cookie']['path'] = '/sub/path'
c['restricted_cookie']['domain'] = 'pymotw'
c['restricted_cookie']['secure'] = true

# a cookie that expires in 5 minutes
c['with_max_age'] = 'expires in 5 minutes'
c['with_max_age']['max-age'] = 300  # seconds

# a cookie that expires at a specific time
c['expires_at_time'] = 'cookie_value'
time_to_live = datetime.timedelta(hours=1)
expires = (datetime.datetime(2020, 4, 8, 18, 30, 14) +
           time_to_live)

# date format: wdy, dd-mon-yy hh:mm:ss gmt
expires_at_time = expires.strftime('%a, %d %b %y %h:%m:%s')
c['expires_at_time']['expires'] = expires_at_time

show_cookie(c)

这个例子使用两个不同的方法设置到期的cookie。其中一个方法将max-age设置为一个秒数，另一个方法将expires设置为一个日期时间，达到这个日期时间就会丢弃这个cookie。

cookie和morsel对象都相当于字典。morsel响应一个固定的键集。 

expires

path

comment

domain

secure

version

cookie实例的键是所存储的各个cookie的名。这个信息也可以从morsel的键属性得到。

1.3 编码的值

cookie首部值必须经过编码才能被正确的解析。

from http import cookies

c = cookies.simplecookie()
c['integer'] = 5
c['with_quotes'] = 'he said, "hello, world!"'

for name in ['integer', 'with_quotes']:
    print(c[name].key)
    print('  {}'.format(c[name]))
    print('  value={!r}'.format(c[name].value))
    print('  coded_value={!r}'.format(c[name].coded_value))
    print()

morsel.value是cookie的解码值，而morsel.coded_value表示总是用来将值传输到客户。这两个值都是串。如果保存到一个cookie的值不是串，那么其将会自动转换为串。

1.4 接收和解析cookie首部

一旦客户接收到set-cookie首部，在后续请求中它会使用一个cookie首部把这些cookie返回到服务器。到来的cookie首部串可能包含多个cookie值，由分号分隔(;)。

cookie: integer=5; with_quotes="he said, \"hello, world!\""

取决于web服务器和框架，可以直接从首部或http_cookie环境变量得到cookie。

from http import cookies

http_cookie = '; '.join([
    r'integer=5',
    r'with_quotes="he said, \"hello, world!\""',
])

print('from constructor:')
c = cookies.simplecookie(http_cookie)
print(c)

print()
print('from load():')
c = cookies.simplecookie()
c.load(http_cookie)
print(c)

要对它们解码，实例化时可以将串(但不包括首部前缀)传递到simplecookie，或者使用load()方法。

1.5 候选输出格式

除了使用set-cookie首部，服务器还可以提供javascript向客户增加cookie。simplecookie和morsel通过js_output()方法来提供javascript输出。 

from http import cookies
import textwrap

c = cookies.simplecookie()
c['mycookie'] = 'cookie_value'
c['another_cookie'] = 'second value'
js_text = c.js_output()
print(textwrap.dedent(js_text).lstrip())

结果是一个完整的script标记，其中包含设置cookie的语句。