PHP 8.0.30
Preview: abc.py Size: 5.38 KB
//proc/thread-self/root/opt/alt/python37/lib64/python3.7/site-packages/aiohttp/abc.py

import asyncio
import logging
from abc import ABC, abstractmethod
from collections.abc import Sized
from http.cookies import BaseCookie, Morsel
from typing import (
    TYPE_CHECKING,
    Any,
    Awaitable,
    Callable,
    Dict,
    Generator,
    Iterable,
    List,
    Optional,
    Tuple,
)

from multidict import CIMultiDict
from yarl import URL

from .helpers import get_running_loop
from .typedefs import LooseCookies

if TYPE_CHECKING:  # pragma: no cover
    from .web_app import Application
    from .web_exceptions import HTTPException
    from .web_request import BaseRequest, Request
    from .web_response import StreamResponse
else:
    BaseRequest = Request = Application = StreamResponse = None
    HTTPException = None


class AbstractRouter(ABC):
    def __init__(self) -> None:
        self._frozen = False

    def post_init(self, app: Application) -> None:
        """Post init stage.

        Not an abstract method for sake of backward compatibility,
        but if the router wants to be aware of the application
        it can override this.
        """

    @property
    def frozen(self) -> bool:
        return self._frozen

    def freeze(self) -> None:
        """Freeze router."""
        self._frozen = True

    @abstractmethod
    async def resolve(self, request: Request) -> "AbstractMatchInfo":
        """Return MATCH_INFO for given request"""


class AbstractMatchInfo(ABC):
    @property  # pragma: no branch
    @abstractmethod
    def handler(self) -> Callable[[Request], Awaitable[StreamResponse]]:
        """Execute matched request handler"""

    @property
    @abstractmethod
    def expect_handler(self) -> Callable[[Request], Awaitable[None]]:
        """Expect handler for 100-continue processing"""

    @property  # pragma: no branch
    @abstractmethod
    def http_exception(self) -> Optional[HTTPException]:
        """HTTPException instance raised on router's resolving, or None"""

    @abstractmethod  # pragma: no branch
    def get_info(self) -> Dict[str, Any]:
        """Return a dict with additional info useful for introspection"""

    @property  # pragma: no branch
    @abstractmethod
    def apps(self) -> Tuple[Application, ...]:
        """Stack of nested applications.

        Top level application is left-most element.

        """

    @abstractmethod
    def add_app(self, app: Application) -> None:
        """Add application to the nested apps stack."""

    @abstractmethod
    def freeze(self) -> None:
        """Freeze the match info.

        The method is called after route resolution.

        After the call .add_app() is forbidden.

        """


class AbstractView(ABC):
    """Abstract class based view."""

    def __init__(self, request: Request) -> None:
        self._request = request

    @property
    def request(self) -> Request:
        """Request instance."""
        return self._request

    @abstractmethod
    def __await__(self) -> Generator[Any, None, StreamResponse]:
        """Execute the view handler."""


class AbstractResolver(ABC):
    """Abstract DNS resolver."""

    @abstractmethod
    async def resolve(self, host: str, port: int, family: int) -> List[Dict[str, Any]]:
        """Return IP address for given hostname"""

    @abstractmethod
    async def close(self) -> None:
        """Release resolver"""


if TYPE_CHECKING:  # pragma: no cover
    IterableBase = Iterable[Morsel[str]]
else:
    IterableBase = Iterable


ClearCookiePredicate = Callable[["Morsel[str]"], bool]


class AbstractCookieJar(Sized, IterableBase):
    """Abstract Cookie Jar."""

    def __init__(self, *, loop: Optional[asyncio.AbstractEventLoop] = None) -> None:
        self._loop = get_running_loop(loop)

    @abstractmethod
    def clear(self, predicate: Optional[ClearCookiePredicate] = None) -> None:
        """Clear all cookies if no predicate is passed."""

    @abstractmethod
    def clear_domain(self, domain: str) -> None:
        """Clear all cookies for domain and all subdomains."""

    @abstractmethod
    def update_cookies(self, cookies: LooseCookies, response_url: URL = URL()) -> None:
        """Update cookies."""

    @abstractmethod
    def filter_cookies(self, request_url: URL) -> "BaseCookie[str]":
        """Return the jar's cookies filtered by their attributes."""


class AbstractStreamWriter(ABC):
    """Abstract stream writer."""

    buffer_size = 0
    output_size = 0
    length = 0  # type: Optional[int]

    @abstractmethod
    async def write(self, chunk: bytes) -> None:
        """Write chunk into stream."""

    @abstractmethod
    async def write_eof(self, chunk: bytes = b"") -> None:
        """Write last chunk."""

    @abstractmethod
    async def drain(self) -> None:
        """Flush the write buffer."""

    @abstractmethod
    def enable_compression(self, encoding: str = "deflate") -> None:
        """Enable HTTP body compression"""

    @abstractmethod
    def enable_chunking(self) -> None:
        """Enable HTTP chunked mode"""

    @abstractmethod
    async def write_headers(
        self, status_line: str, headers: "CIMultiDict[str]"
    ) -> None:
        """Write HTTP headers"""


class AbstractAccessLogger(ABC):
    """Abstract writer to access log."""

    def __init__(self, logger: logging.Logger, log_format: str) -> None:
        self.logger = logger
        self.log_format = log_format

    @abstractmethod
    def log(self, request: BaseRequest, response: StreamResponse, time: float) -> None:
        """Emit log to logger."""

Directory Contents

Dirs: 2 × Files: 64

Name Size Perms Modified Actions
.hash DIR
- drwxr-xr-x 2023-12-06 03:19:40
Edit Download
- drwxr-xr-x 2023-12-06 03:19:40
Edit Download
5.38 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
2.64 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
43.87 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
9.06 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
8.00 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
36.02 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
10.29 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
49.66 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
13.25 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
5.98 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
4.61 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
25.63 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
1.78 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
2.53 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
31.83 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
24.76 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
5.84 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
1.13 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
325 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
31.68 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
13.38 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
2.06 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
7 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
11.50 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
4.97 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
20.35 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
962 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
20.72 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
14.95 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
1.72 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
17.51 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
16.86 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
9.87 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
10.53 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
7.39 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
4.04 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
22.02 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
27.23 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
26.92 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
5.90 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
10.93 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
2.01 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
38.62 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
16.85 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
8.57 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
4.88 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
183.17 KB lrw-r--r-- 2021-11-14 20:05:14
Edit Download
170 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
68 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
1.96 KB lrw-r--r-- 2021-11-14 20:05:14
Edit Download
207.99 KB lrw-r--r-- 2021-11-14 20:05:15
Edit Download
66.12 KB lrwxr-xr-x 2023-11-14 11:36:54
Edit Download
202 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
1.02 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
955.26 KB lrw-r--r-- 2021-11-14 20:05:16
Edit Download
523.54 KB lrwxr-xr-x 2023-11-14 11:36:54
Edit Download
25.95 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
216.08 KB lrw-r--r-- 2021-11-14 20:05:14
Edit Download
61.20 KB lrwxr-xr-x 2023-11-14 11:36:54
Edit Download
4.47 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
135.18 KB lrw-r--r-- 2021-11-14 20:05:15
Edit Download
37.37 KB lrwxr-xr-x 2023-11-14 11:36:54
Edit Download
1.52 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
6.71 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).