Warning: This document is for the development version of molten.

Source code for molten.http.request

# This file is a part of molten.
#
# Copyright (C) 2018 CLEARTYPE SRL <bogdan@cleartype.io>
#
# 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)})" )