/
_request.py
53 lines (36 loc) · 1.31 KB
/
_request.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# -*- test-case-name: klein.test.test_request -*-
# Copyright (c) 2011-2019. See LICENSE for details.
"""
HTTP request API.
"""
from typing import Text, Union
from attr import Factory, attrib, attrs
from attr.validators import instance_of, provides
from hyperlink import DecodedURL
from tubes.itube import IFount
from twisted.internet.defer import Deferred
from zope.interface import implementer
from ._interfaces import IHTTPHeaders, IHTTPRequest
from ._message import MessageState, bodyAsBytes, bodyAsFount, validateBody
__all__ = ()
@implementer(IHTTPRequest) # type: ignore[misc]
@attrs(frozen=True)
class FrozenHTTPRequest(object):
"""
Immutable HTTP request.
"""
method = attrib(validator=instance_of(Text)) # type: Text
uri = attrib(validator=instance_of(DecodedURL)) # type: DecodedURL
headers = attrib(
validator=provides(IHTTPHeaders) # type: ignore[misc]
) # type: IHTTPHeaders
_body = attrib(validator=validateBody) # type: Union[bytes, IFount]
_state = attrib(
default=Factory(MessageState), init=False
) # type: MessageState
def bodyAsFount(self):
# type: () -> IFount
return bodyAsFount(self._body, self._state)
def bodyAsBytes(self):
# type: () -> Deferred[bytes]
return bodyAsBytes(self._body, self._state)