mirror of
https://github.com/davidhalter/typeshed.git
synced 2025-12-07 20:54:28 +08:00
313 lines
12 KiB
Python
313 lines
12 KiB
Python
import gzip
|
|
import http.client
|
|
import sys
|
|
import time
|
|
from _typeshed import Self, SupportsRead, SupportsWrite
|
|
from datetime import datetime
|
|
from io import BytesIO
|
|
from types import TracebackType
|
|
from typing import Any, Callable, Iterable, Mapping, Protocol, Union, overload
|
|
from typing_extensions import Literal
|
|
|
|
class _SupportsTimeTuple(Protocol):
|
|
def timetuple(self) -> time.struct_time: ...
|
|
|
|
_DateTimeComparable = Union[DateTime, datetime, str, _SupportsTimeTuple]
|
|
_Marshallable = Union[None, bool, int, float, str, bytes, tuple[Any, ...], list[Any], dict[Any, Any], datetime, DateTime, Binary]
|
|
_XMLDate = Union[int, datetime, tuple[int, ...], time.struct_time]
|
|
_HostType = Union[tuple[str, dict[str, str]], str]
|
|
|
|
def escape(s: str) -> str: ... # undocumented
|
|
|
|
MAXINT: int # undocumented
|
|
MININT: int # undocumented
|
|
|
|
PARSE_ERROR: int # undocumented
|
|
SERVER_ERROR: int # undocumented
|
|
APPLICATION_ERROR: int # undocumented
|
|
SYSTEM_ERROR: int # undocumented
|
|
TRANSPORT_ERROR: int # undocumented
|
|
|
|
NOT_WELLFORMED_ERROR: int # undocumented
|
|
UNSUPPORTED_ENCODING: int # undocumented
|
|
INVALID_ENCODING_CHAR: int # undocumented
|
|
INVALID_XMLRPC: int # undocumented
|
|
METHOD_NOT_FOUND: int # undocumented
|
|
INVALID_METHOD_PARAMS: int # undocumented
|
|
INTERNAL_ERROR: int # undocumented
|
|
|
|
class Error(Exception): ...
|
|
|
|
class ProtocolError(Error):
|
|
|
|
url: str
|
|
errcode: int
|
|
errmsg: str
|
|
headers: dict[str, str]
|
|
def __init__(self, url: str, errcode: int, errmsg: str, headers: dict[str, str]) -> None: ...
|
|
|
|
class ResponseError(Error): ...
|
|
|
|
class Fault(Error):
|
|
|
|
faultCode: int
|
|
faultString: str
|
|
def __init__(self, faultCode: int, faultString: str, **extra: Any) -> None: ...
|
|
|
|
boolean = bool
|
|
Boolean = bool
|
|
|
|
def _iso8601_format(value: datetime) -> str: ... # undocumented
|
|
def _strftime(value: _XMLDate) -> str: ... # undocumented
|
|
|
|
class DateTime:
|
|
|
|
value: str # undocumented
|
|
def __init__(self, value: int | str | datetime | time.struct_time | tuple[int, ...] = ...) -> None: ...
|
|
def __lt__(self, other: _DateTimeComparable) -> bool: ...
|
|
def __le__(self, other: _DateTimeComparable) -> bool: ...
|
|
def __gt__(self, other: _DateTimeComparable) -> bool: ...
|
|
def __ge__(self, other: _DateTimeComparable) -> bool: ...
|
|
def __eq__(self, other: _DateTimeComparable) -> bool: ... # type: ignore[override]
|
|
def make_comparable(self, other: _DateTimeComparable) -> tuple[str, str]: ... # undocumented
|
|
def timetuple(self) -> time.struct_time: ... # undocumented
|
|
def decode(self, data: Any) -> None: ...
|
|
def encode(self, out: SupportsWrite[str]) -> None: ...
|
|
|
|
def _datetime(data: Any) -> DateTime: ... # undocumented
|
|
def _datetime_type(data: str) -> datetime: ... # undocumented
|
|
|
|
class Binary:
|
|
|
|
data: bytes
|
|
def __init__(self, data: bytes | None = ...) -> None: ...
|
|
def decode(self, data: bytes) -> None: ...
|
|
def encode(self, out: SupportsWrite[str]) -> None: ...
|
|
|
|
def _binary(data: bytes) -> Binary: ... # undocumented
|
|
|
|
WRAPPERS: tuple[type[DateTime], type[Binary]] # undocumented
|
|
|
|
class ExpatParser: # undocumented
|
|
def __init__(self, target: Unmarshaller) -> None: ...
|
|
def feed(self, data: str | bytes) -> None: ...
|
|
def close(self) -> None: ...
|
|
|
|
class Marshaller:
|
|
|
|
dispatch: dict[
|
|
type[Any], Callable[[Marshaller, Any, Callable[[str], Any]], None]
|
|
] # TODO: Replace 'Any' with some kind of binding
|
|
|
|
memo: dict[Any, None]
|
|
data: None
|
|
encoding: str | None
|
|
allow_none: bool
|
|
def __init__(self, encoding: str | None = ..., allow_none: bool = ...) -> None: ...
|
|
def dumps(self, values: Fault | Iterable[_Marshallable]) -> str: ...
|
|
def __dump(self, value: _Marshallable, write: Callable[[str], Any]) -> None: ... # undocumented
|
|
def dump_nil(self, value: None, write: Callable[[str], Any]) -> None: ...
|
|
def dump_bool(self, value: bool, write: Callable[[str], Any]) -> None: ...
|
|
def dump_long(self, value: int, write: Callable[[str], Any]) -> None: ...
|
|
def dump_int(self, value: int, write: Callable[[str], Any]) -> None: ...
|
|
def dump_double(self, value: float, write: Callable[[str], Any]) -> None: ...
|
|
def dump_unicode(self, value: str, write: Callable[[str], Any], escape: Callable[[str], str] = ...) -> None: ...
|
|
def dump_bytes(self, value: bytes, write: Callable[[str], Any]) -> None: ...
|
|
def dump_array(self, value: Iterable[_Marshallable], write: Callable[[str], Any]) -> None: ...
|
|
def dump_struct(
|
|
self, value: Mapping[str, _Marshallable], write: Callable[[str], Any], escape: Callable[[str], str] = ...
|
|
) -> None: ...
|
|
def dump_datetime(self, value: _XMLDate, write: Callable[[str], Any]) -> None: ...
|
|
def dump_instance(self, value: object, write: Callable[[str], Any]) -> None: ...
|
|
|
|
class Unmarshaller:
|
|
|
|
dispatch: dict[str, Callable[[Unmarshaller, str], None]]
|
|
|
|
_type: str | None
|
|
_stack: list[_Marshallable]
|
|
_marks: list[int]
|
|
_data: list[str]
|
|
_value: bool
|
|
_methodname: str | None
|
|
_encoding: str
|
|
append: Callable[[Any], None]
|
|
_use_datetime: bool
|
|
_use_builtin_types: bool
|
|
def __init__(self, use_datetime: bool = ..., use_builtin_types: bool = ...) -> None: ...
|
|
def close(self) -> tuple[_Marshallable, ...]: ...
|
|
def getmethodname(self) -> str | None: ...
|
|
def xml(self, encoding: str, standalone: Any) -> None: ... # Standalone is ignored
|
|
def start(self, tag: str, attrs: dict[str, str]) -> None: ...
|
|
def data(self, text: str) -> None: ...
|
|
def end(self, tag: str) -> None: ...
|
|
def end_dispatch(self, tag: str, data: str) -> None: ...
|
|
def end_nil(self, data: str) -> None: ...
|
|
def end_boolean(self, data: str) -> None: ...
|
|
def end_int(self, data: str) -> None: ...
|
|
def end_double(self, data: str) -> None: ...
|
|
def end_bigdecimal(self, data: str) -> None: ...
|
|
def end_string(self, data: str) -> None: ...
|
|
def end_array(self, data: str) -> None: ...
|
|
def end_struct(self, data: str) -> None: ...
|
|
def end_base64(self, data: str) -> None: ...
|
|
def end_dateTime(self, data: str) -> None: ...
|
|
def end_value(self, data: str) -> None: ...
|
|
def end_params(self, data: str) -> None: ...
|
|
def end_fault(self, data: str) -> None: ...
|
|
def end_methodName(self, data: str) -> None: ...
|
|
|
|
class _MultiCallMethod: # undocumented
|
|
|
|
__call_list: list[tuple[str, tuple[_Marshallable, ...]]]
|
|
__name: str
|
|
def __init__(self, call_list: list[tuple[str, _Marshallable]], name: str) -> None: ...
|
|
def __getattr__(self, name: str) -> _MultiCallMethod: ...
|
|
def __call__(self, *args: _Marshallable) -> None: ...
|
|
|
|
class MultiCallIterator: # undocumented
|
|
|
|
results: list[list[_Marshallable]]
|
|
def __init__(self, results: list[list[_Marshallable]]) -> None: ...
|
|
def __getitem__(self, i: int) -> _Marshallable: ...
|
|
|
|
class MultiCall:
|
|
|
|
__server: ServerProxy
|
|
__call_list: list[tuple[str, tuple[_Marshallable, ...]]]
|
|
def __init__(self, server: ServerProxy) -> None: ...
|
|
def __getattr__(self, item: str) -> _MultiCallMethod: ...
|
|
def __call__(self) -> MultiCallIterator: ...
|
|
|
|
# A little white lie
|
|
FastMarshaller: Marshaller | None
|
|
FastParser: ExpatParser | None
|
|
FastUnmarshaller: Unmarshaller | None
|
|
|
|
def getparser(use_datetime: bool = ..., use_builtin_types: bool = ...) -> tuple[ExpatParser, Unmarshaller]: ...
|
|
def dumps(
|
|
params: Fault | tuple[_Marshallable, ...],
|
|
methodname: str | None = ...,
|
|
methodresponse: bool | None = ...,
|
|
encoding: str | None = ...,
|
|
allow_none: bool = ...,
|
|
) -> str: ...
|
|
def loads(data: str, use_datetime: bool = ..., use_builtin_types: bool = ...) -> tuple[tuple[_Marshallable, ...], str | None]: ...
|
|
def gzip_encode(data: bytes) -> bytes: ... # undocumented
|
|
def gzip_decode(data: bytes, max_decode: int = ...) -> bytes: ... # undocumented
|
|
|
|
class GzipDecodedResponse(gzip.GzipFile): # undocumented
|
|
|
|
io: BytesIO
|
|
def __init__(self, response: SupportsRead[bytes]) -> None: ...
|
|
def close(self) -> None: ...
|
|
|
|
class _Method: # undocumented
|
|
|
|
__send: Callable[[str, tuple[_Marshallable, ...]], _Marshallable]
|
|
__name: str
|
|
def __init__(self, send: Callable[[str, tuple[_Marshallable, ...]], _Marshallable], name: str) -> None: ...
|
|
def __getattr__(self, name: str) -> _Method: ...
|
|
def __call__(self, *args: _Marshallable) -> _Marshallable: ...
|
|
|
|
class Transport:
|
|
|
|
user_agent: str
|
|
accept_gzip_encoding: bool
|
|
encode_threshold: int | None
|
|
|
|
_use_datetime: bool
|
|
_use_builtin_types: bool
|
|
_connection: tuple[_HostType | None, http.client.HTTPConnection | None]
|
|
_headers: list[tuple[str, str]]
|
|
_extra_headers: list[tuple[str, str]]
|
|
|
|
if sys.version_info >= (3, 8):
|
|
def __init__(
|
|
self, use_datetime: bool = ..., use_builtin_types: bool = ..., *, headers: Iterable[tuple[str, str]] = ...
|
|
) -> None: ...
|
|
else:
|
|
def __init__(self, use_datetime: bool = ..., use_builtin_types: bool = ...) -> None: ...
|
|
|
|
def request(self, host: _HostType, handler: str, request_body: bytes, verbose: bool = ...) -> tuple[_Marshallable, ...]: ...
|
|
def single_request(
|
|
self, host: _HostType, handler: str, request_body: bytes, verbose: bool = ...
|
|
) -> tuple[_Marshallable, ...]: ...
|
|
def getparser(self) -> tuple[ExpatParser, Unmarshaller]: ...
|
|
def get_host_info(self, host: _HostType) -> tuple[str, list[tuple[str, str]], dict[str, str]]: ...
|
|
def make_connection(self, host: _HostType) -> http.client.HTTPConnection: ...
|
|
def close(self) -> None: ...
|
|
def send_request(self, host: _HostType, handler: str, request_body: bytes, debug: bool) -> http.client.HTTPConnection: ...
|
|
def send_headers(self, connection: http.client.HTTPConnection, headers: list[tuple[str, str]]) -> None: ...
|
|
def send_content(self, connection: http.client.HTTPConnection, request_body: bytes) -> None: ...
|
|
def parse_response(self, response: http.client.HTTPResponse) -> tuple[_Marshallable, ...]: ...
|
|
|
|
class SafeTransport(Transport):
|
|
|
|
if sys.version_info >= (3, 8):
|
|
def __init__(
|
|
self,
|
|
use_datetime: bool = ...,
|
|
use_builtin_types: bool = ...,
|
|
*,
|
|
headers: Iterable[tuple[str, str]] = ...,
|
|
context: Any | None = ...,
|
|
) -> None: ...
|
|
else:
|
|
def __init__(self, use_datetime: bool = ..., use_builtin_types: bool = ..., *, context: Any | None = ...) -> None: ...
|
|
|
|
def make_connection(self, host: _HostType) -> http.client.HTTPSConnection: ...
|
|
|
|
class ServerProxy:
|
|
|
|
__host: str
|
|
__handler: str
|
|
__transport: Transport
|
|
__encoding: str
|
|
__verbose: bool
|
|
__allow_none: bool
|
|
|
|
if sys.version_info >= (3, 8):
|
|
def __init__(
|
|
self,
|
|
uri: str,
|
|
transport: Transport | None = ...,
|
|
encoding: str | None = ...,
|
|
verbose: bool = ...,
|
|
allow_none: bool = ...,
|
|
use_datetime: bool = ...,
|
|
use_builtin_types: bool = ...,
|
|
*,
|
|
headers: Iterable[tuple[str, str]] = ...,
|
|
context: Any | None = ...,
|
|
) -> None: ...
|
|
else:
|
|
def __init__(
|
|
self,
|
|
uri: str,
|
|
transport: Transport | None = ...,
|
|
encoding: str | None = ...,
|
|
verbose: bool = ...,
|
|
allow_none: bool = ...,
|
|
use_datetime: bool = ...,
|
|
use_builtin_types: bool = ...,
|
|
*,
|
|
context: Any | None = ...,
|
|
) -> None: ...
|
|
|
|
def __getattr__(self, name: str) -> _Method: ...
|
|
@overload
|
|
def __call__(self, attr: Literal["close"]) -> Callable[[], None]: ...
|
|
@overload
|
|
def __call__(self, attr: Literal["transport"]) -> Transport: ...
|
|
@overload
|
|
def __call__(self, attr: str) -> Callable[[], None] | Transport: ...
|
|
def __enter__(self: Self) -> Self: ...
|
|
def __exit__(
|
|
self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: TracebackType | None
|
|
) -> None: ...
|
|
def __close(self) -> None: ... # undocumented
|
|
def __request(self, methodname: str, params: tuple[_Marshallable, ...]) -> tuple[_Marshallable, ...]: ... # undocumented
|
|
|
|
Server = ServerProxy
|