File: connection.py

package info (click to toggle)
python-gql 4.0.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,900 kB
  • sloc: python: 21,677; makefile: 54
file content (68 lines) | stat: -rw-r--r-- 1,778 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
import abc
from typing import Any, Dict, List, Optional


class AdapterConnection(abc.ABC):
    """Abstract interface for subscription connections.

    This allows different WebSocket implementations to be used interchangeably.
    """

    url: str
    connect_args: Dict[str, Any]
    subprotocols: Optional[List[str]]

    def __init__(self, url: str, connect_args: Optional[Dict[str, Any]]):
        """Initialize the connection adapter."""
        self.url: str = url

        if connect_args is None:
            connect_args = {}
        self.connect_args = connect_args

        self.subprotocols = None

    @abc.abstractmethod
    async def connect(self) -> None:
        """Connect to the server."""
        pass  # pragma: no cover

    @abc.abstractmethod
    async def send(self, message: str) -> None:
        """Send message to the server.

        Args:
            message: String message to send

        Raises:
            TransportConnectionFailed: If connection closed
        """
        pass  # pragma: no cover

    @abc.abstractmethod
    async def receive(self) -> str:
        """Receive message from the server.

        Returns:
            String message received

        Raises:
            TransportConnectionFailed: If connection closed
            TransportProtocolError: If protocol error or binary data received
        """
        pass  # pragma: no cover

    @abc.abstractmethod
    async def close(self) -> None:
        """Close the connection."""
        pass  # pragma: no cover

    @property
    @abc.abstractmethod
    def response_headers(self) -> Dict[str, str]:
        """Get the response headers from the connection.

        Returns:
            Dictionary of response headers
        """
        pass  # pragma: no cover