| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657 |
- from typing import Union, Any
- from array import array
- from .protocol import HTTPProtocol
- class HttpParser:
- def __init__(self, protocol: Union[HTTPProtocol, Any]) -> None:
- """
- protocol -- a Python object with the following methods
- (all optional):
- - on_message_begin()
- - on_url(url: bytes)
- - on_header(name: bytes, value: bytes)
- - on_headers_complete()
- - on_body(body: bytes)
- - on_message_complete()
- - on_chunk_header()
- - on_chunk_complete()
- - on_status(status: bytes)
- """
- def get_http_version(self) -> str:
- """Return an HTTP protocol version."""
- ...
- def should_keep_alive(self) -> bool:
- """Return ``True`` if keep-alive mode is preferred."""
- ...
- def should_upgrade(self) -> bool:
- """Return ``True`` if the parsed request is a valid Upgrade request.
- The method exposes a flag set just before on_headers_complete.
- Calling this method earlier will only yield `False`."""
- ...
- def feed_data(self, data: Union[bytes, bytearray, memoryview, array]) -> None:
- """Feed data to the parser.
- Will eventually trigger callbacks on the ``protocol``
- object.
- On HTTP upgrade, this method will raise an
- ``HttpParserUpgrade`` exception, with its sole argument
- set to the offset of the non-HTTP data in ``data``.
- """
- class HttpRequestParser(HttpParser):
- """Used for parsing http requests from the server's side"""
- def get_method(self) -> bytes:
- """Return HTTP request method (GET, HEAD, etc)"""
- class HttpResponseParser(HttpParser):
- """Used for parsing http requests from the client's side"""
- def get_status_code(self) -> int:
- """Return the status code of the HTTP response"""
|
