# This file is a part of molten.
#
# Copyright (C) 2018 CLEARTYPE SRL <[email protected]>
#
# molten is free software; you can redistribute it and/or modify it
# under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation, either version 3 of the License, or (at
# your option) any later version.
#
# molten is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
# License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
from io import BytesIO
from typing import BinaryIO, Dict, List, Optional, Union
from ..typing import Environ
from .headers import Headers
from .query_params import ParamsDict, QueryParams
[docs]class Request:
"""Represents an individual HTTP request.
Attributes:
method: The HTTP method.
scheme: The URL scheme.
host: The hostname.
port: The port.
path: The path.
params: The query parameters.
headers: The request headers.
body_file: A file-like object representing the request body.
"""
__slots__ = [
"method",
"scheme",
"host",
"port",
"path",
"params",
"headers",
"body_file",
]
def __init__(
self, *,
method: str = "GET",
scheme: str = "http",
host: str = "127.0.0.1",
port: int = 8000,
path: str = "/",
params: Optional[Union[ParamsDict, QueryParams]] = None,
headers: Optional[Union[Dict[str, Union[str, List[str]]], Headers]] = None,
body_file: Optional[BinaryIO] = None,
) -> None:
self.method = method
self.scheme = scheme
self.host = host
self.port = port
self.path = path
self.body_file = body_file or BytesIO()
if isinstance(headers, dict):
self.headers: Headers = Headers(headers)
else:
self.headers = headers or Headers()
if not params:
self.params = QueryParams()
elif isinstance(params, dict):
self.params = QueryParams(params)
else:
self.params = params
[docs] @classmethod
def from_environ(cls, environ: Environ) -> "Request":
"""Construct a Request object from a WSGI environ.
"""
return Request(
method=environ["REQUEST_METHOD"],
scheme=environ["wsgi.url_scheme"],
host=environ.get("HTTP_HOST", ""),
port=environ.get("SERVER_PORT", 0),
path=environ.get("PATH_INFO", ""),
params=QueryParams.from_environ(environ),
headers=Headers.from_environ(environ),
body_file=environ["wsgi.input"],
)
def __repr__(self) -> str:
return (
f"Request(method={repr(self.method)}, scheme={repr(self.scheme)}, host={repr(self.host)}, "
f"port={repr(self.port)}, path={repr(self.path)}, params={repr(self.params)}, "
f"headers={repr(self.headers)}, body_file={repr(self.body_file)})"
)
