indie-status-page/venv/lib/python3.11/site-packages/httptools/parser/parser.pyi
IndieStatusBot 902133edd3 feat: indie status page MVP -- FastAPI + SQLite
- 8 DB models (services, incidents, monitors, subscribers, etc.)
- Full CRUD API for services, incidents, monitors
- Public status page with live data
- Incident detail page with timeline
- API key authentication
- Uptime monitoring scheduler
- 13 tests passing
- TECHNICAL_DESIGN.md with full spec
2026-04-25 05:00:00 +00:00

57 lines
1.8 KiB
Python

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"""