types-awscrt 0.29.0__py3-none-any.whl

awscrt-stubs/__init__.pyi

@@ -0,0 +1,33 @@
+"""
+Type annotations for awscrt module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from awscrt import aio as aio
+from awscrt import auth as auth
+from awscrt import crypto as crypto
+from awscrt import http as http
+from awscrt import io as io
+from awscrt import mqtt as mqtt
+from awscrt import mqtt5 as mqtt5
+from awscrt import mqtt_request_response as mqtt_request_response
+from awscrt import s3 as s3
+from awscrt import websocket as websocket
+
+__all__ = [
+    "aio",
+    "auth",
+    "crypto",
+    "http",
+    "io",
+    "mqtt",
+    "mqtt5",
+    "mqtt_request_response",
+    "s3",
+    "websocket",
+]
+__version__: str = ...
+
+class NativeResource:
+    def __init__(self) -> None: ...

awscrt-stubs/_test.pyi

@@ -0,0 +1,15 @@
+"""
+Type annotations for awscrt._test module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from awscrt import NativeResource as NativeResource
+from awscrt.io import ClientBootstrap as ClientBootstrap
+from awscrt.io import DefaultHostResolver as DefaultHostResolver
+from awscrt.io import EventLoopGroup as EventLoopGroup
+
+def native_memory_usage() -> int: ...
+def dump_native_memory() -> None: ...
+def join_all_native_threads(*, timeout_sec: float = ...) -> bool: ...
+def check_for_leaks(*, timeout_sec: float = ...) -> None: ...

awscrt-stubs/aio/__init__.pyi

@@ -0,0 +1,9 @@
+"""
+Type annotations for awscrt.aio module.
+
+Copyright 2025 Vlad Emelianov
+"""
+
+from awscrt.aio import http
+
+__all__ = ["http"]

awscrt-stubs/aio/http.pyi

@@ -0,0 +1,104 @@
+"""
+Type annotations for awscrt.aio.http module.
+
+Copyright 2025 Vlad Emelianov
+"""
+
+import asyncio
+from typing import AsyncIterator, Callable
+
+from awscrt.http import (
+    Http2Setting,
+    HttpClientConnectionBase,
+    HttpClientStreamBase,
+    HttpProxyOptions,
+    HttpRequest,
+)
+from awscrt.io import ClientBootstrap, SocketOptions, TlsConnectionOptions
+
+class AIOHttpClientConnectionUnified(HttpClientConnectionBase):
+    @classmethod
+    async def new(
+        cls,
+        host_name: str,
+        port: int,
+        bootstrap: ClientBootstrap | None = ...,
+        socket_options: SocketOptions | None = ...,
+        tls_connection_options: TlsConnectionOptions | None = ...,
+        proxy_options: HttpProxyOptions | None = ...,
+    ) -> AIOHttpClientConnectionUnified: ...
+    async def close(self) -> None: ...
+    def request(
+        self,
+        request: HttpRequest,
+        request_body_generator: AsyncIterator[bytes] | None = ...,
+        loop: asyncio.AbstractEventLoop | None = ...,
+    ) -> AIOHttpClientStreamUnified: ...
+
+class AIOHttpClientConnection(AIOHttpClientConnectionUnified):
+    @classmethod
+    async def new(
+        cls,
+        host_name: str,
+        port: int,
+        bootstrap: ClientBootstrap | None = ...,
+        socket_options: SocketOptions | None = ...,
+        tls_connection_options: TlsConnectionOptions | None = ...,
+        proxy_options: HttpProxyOptions | None = ...,
+    ) -> AIOHttpClientConnection: ...
+    def request(
+        self,
+        request: HttpRequest,
+        request_body_generator: AsyncIterator[bytes] | None = ...,
+        loop: asyncio.AbstractEventLoop | None = ...,
+    ) -> AIOHttpClientStream: ...
+
+class AIOHttp2ClientConnection(AIOHttpClientConnectionUnified):
+    @classmethod
+    async def new(
+        cls,
+        host_name: str,
+        port: int,
+        bootstrap: ClientBootstrap | None = ...,
+        socket_options: SocketOptions | None = ...,
+        tls_connection_options: TlsConnectionOptions | None = ...,
+        proxy_options: HttpProxyOptions | None = ...,
+        initial_settings: list[Http2Setting] | None = ...,
+        on_remote_settings_changed: Callable[[list[Http2Setting]], None] | None = ...,
+    ) -> AIOHttp2ClientConnection: ...
+    def request(
+        self,
+        request: HttpRequest,
+        request_body_generator: AsyncIterator[bytes] | None = ...,
+        loop: asyncio.AbstractEventLoop | None = ...,
+    ) -> AIOHttp2ClientStream: ...
+
+class AIOHttpClientStreamUnified(HttpClientStreamBase):
+    def __init__(
+        self,
+        connection: AIOHttpClientConnection,
+        request: HttpRequest,
+        request_body_generator: AsyncIterator[bytes] | None = ...,
+        loop: asyncio.AbstractEventLoop | None = ...,
+    ) -> None: ...
+    async def get_response_status_code(self) -> int: ...
+    async def get_response_headers(self) -> list[tuple[str, str]]: ...
+    async def get_next_response_chunk(self) -> bytes: ...
+    async def wait_for_completion(self) -> int: ...
+
+class AIOHttpClientStream(AIOHttpClientStreamUnified):
+    def __init__(
+        self,
+        connection: AIOHttpClientConnection,
+        request: HttpRequest,
+        loop: asyncio.AbstractEventLoop | None = ...,
+    ) -> None: ...
+
+class AIOHttp2ClientStream(AIOHttpClientStreamUnified):
+    def __init__(
+        self,
+        connection: AIOHttpClientConnection,
+        request: HttpRequest,
+        request_body_generator: AsyncIterator[bytes] | None = ...,
+        loop: asyncio.AbstractEventLoop | None = ...,
+    ) -> None: ...

awscrt-stubs/auth.pyi

@@ -0,0 +1,158 @@
+"""
+Type annotations for awscrt.auth module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from concurrent.futures import Future
+from datetime import datetime
+from enum import IntEnum
+from typing import Any, Callable, Sequence, TypeVar
+
+from awscrt import NativeResource as NativeResource
+from awscrt.http import HttpProxyOptions
+from awscrt.http import HttpRequest as HttpRequest
+from awscrt.io import ClientBootstrap as ClientBootstrap
+from awscrt.io import ClientTlsContext
+
+_R = TypeVar("_R")
+
+class AwsCredentials(NativeResource):
+    def __init__(
+        self,
+        access_key_id: str,
+        secret_access_key: str,
+        session_token: str | None = ...,
+        expiration: datetime | None = ...,
+    ) -> None: ...
+    @property
+    def access_key_id(self) -> str: ...
+    @property
+    def secret_access_key(self) -> str: ...
+    @property
+    def session_token(self) -> str: ...
+    @property
+    def expiration(self) -> datetime | None: ...
+    def __deepcopy__(self: _R, memo: Any) -> _R: ...
+
+class AwsCredentialsProviderBase(NativeResource): ...
+
+class AwsCredentialsProvider(AwsCredentialsProviderBase):
+    def __init__(self, binding: Any) -> None: ...
+    @classmethod
+    def new_default_chain(cls: type[_R], client_bootstrap: ClientBootstrap | None = ...) -> _R: ...
+    @classmethod
+    def new_static(
+        cls: type[_R],
+        access_key_id: str,
+        secret_access_key: str,
+        session_token: str | None = ...,
+    ) -> _R: ...
+    @classmethod
+    def new_profile(
+        cls: type[_R],
+        client_bootstrap: ClientBootstrap | None = ...,
+        profile_name: str | None = ...,
+        config_filepath: str | None = ...,
+        credentials_filepath: str | None = ...,
+    ) -> _R: ...
+    @classmethod
+    def new_process(cls: type[_R], profile_to_use: str | None = ...) -> _R: ...
+    @classmethod
+    def new_environment(cls: type[_R]) -> _R: ...
+    @classmethod
+    def new_chain(cls: type[_R], providers: list[AwsCredentialsProvider]) -> _R: ...
+    @classmethod
+    def new_delegate(cls: type[_R], get_credentials: Callable[[], AwsCredentials]) -> _R: ...
+    @classmethod
+    def new_cognito(
+        cls: type[_R],
+        *,
+        endpoint: str,
+        identity: str,
+        tls_ctx: ClientTlsContext,
+        logins: Sequence[tuple[str, str]] | None = ...,
+        custom_role_arn: str | None = ...,
+        client_bootstrap: ClientBootstrap | None = ...,
+        http_proxy_options: HttpProxyOptions | None = ...,
+    ) -> _R: ...
+    @classmethod
+    def new_x509(
+        cls: type[_R],
+        *,
+        endpoint: str,
+        thing_name: str,
+        role_alias: str,
+        tls_ctx: ClientTlsContext,
+        client_bootstrap: ClientBootstrap | None = ...,
+        http_proxy_options: HttpProxyOptions | None = ...,
+    ) -> _R: ...
+    def get_credentials(self) -> Future[AwsCredentials]: ...
+
+class AwsSigningAlgorithm(IntEnum):
+    V4 = 0
+    V4_ASYMMETRIC = 1
+    V4_S3EXPRESS = 2
+
+class AwsSignatureType(IntEnum):
+    HTTP_REQUEST_HEADERS = 0
+    HTTP_REQUEST_QUERY_PARAMS = 1
+
+class AwsSignedBodyValue:
+    EMPTY_SHA256: str
+    UNSIGNED_PAYLOAD: str
+    STREAMING_AWS4_HMAC_SHA256_PAYLOAD: str
+    STREAMING_AWS4_HMAC_SHA256_EVENTS: str
+
+class AwsSignedBodyHeaderType(IntEnum):
+    NONE = 0
+    X_AMZ_CONTENT_SHA_256 = 1
+
+class AwsSigningConfig(NativeResource):
+    def __init__(
+        self,
+        algorithm: AwsSigningAlgorithm = ...,
+        signature_type: AwsSignatureType = ...,
+        credentials_provider: AwsCredentialsProvider | None = ...,
+        region: str = ...,
+        service: str = ...,
+        date: datetime | None = ...,
+        should_sign_header: Callable[[str], bool] | None = ...,
+        use_double_uri_encode: bool = ...,
+        should_normalize_uri_path: bool = ...,
+        signed_body_value: str | None = ...,
+        signed_body_header_type: AwsSignedBodyHeaderType = ...,
+        expiration_in_seconds: int | None = ...,
+        omit_session_token: bool = ...,
+    ) -> None: ...
+    def replace(self: _R, **kwargs: Any) -> _R: ...
+    @property
+    def algorithm(self) -> AwsSigningAlgorithm: ...
+    @property
+    def signature_type(self) -> AwsSignatureType: ...
+    @property
+    def credentials_provider(self) -> AwsCredentialsProvider: ...
+    @property
+    def region(self) -> str: ...
+    @property
+    def service(self) -> str: ...
+    @property
+    def date(self) -> datetime: ...
+    @property
+    def should_sign_header(self) -> Callable[[str], bool] | None: ...
+    @property
+    def use_double_uri_encode(self) -> bool: ...
+    @property
+    def should_normalize_uri_path(self) -> bool: ...
+    @property
+    def signed_body_value(self) -> str | None: ...
+    @property
+    def signed_body_header_type(self) -> AwsSignedBodyHeaderType: ...
+    @property
+    def expiration_in_seconds(self) -> int | None: ...
+    @property
+    def omit_session_token(self) -> bool: ...
+
+def aws_sign_request(
+    http_request: HttpRequest, signing_config: AwsSigningConfig
+) -> Future[HttpRequest]: ...

awscrt-stubs/cbor.pyi

@@ -0,0 +1,77 @@
+"""
+Type annotations for awscrt.cbor module.
+
+Copyright 2025 Vlad Emelianov
+"""
+
+from enum import IntEnum
+from typing import Any, Callable
+
+from awscrt import NativeResource
+
+class AwsCborType(IntEnum):
+    Unknown = 0
+    UnsignedInt = 1
+    NegativeInt = 2
+    Float = 3
+    Bytes = 4
+    Text = 5
+    ArrayStart = 6
+    MapStart = 7
+    Tag = 8
+    Bool = 9
+    Null = 10
+    Undefined = 11
+    Break = 12
+    IndefBytes = 13
+    IndefStr = 14
+    IndefArray = 15
+    IndefMap = 16
+
+class AwsCborEncoder(NativeResource):
+    def __init__(self) -> None: ...
+    def get_encoded_data(self) -> bytes: ...
+    def reset(self) -> None: ...
+    def write_int(self, val: int) -> None: ...
+    def write_float(self, val: float) -> None: ...
+    def write_bytes(self, val: bytes) -> None: ...
+    def write_text(self, val: str) -> None: ...
+    def write_array_start(self, number_entries: int) -> None: ...
+    def write_map_start(self, number_entries: int) -> None: ...
+    def write_tag(self, tag_number: int) -> None: ...
+    def write_null(self) -> None: ...
+    def write_undefined(self) -> None: ...
+    def write_indef_array_start(self) -> None: ...
+    def write_indef_map_start(self) -> None: ...
+    def write_indef_bytes_start(self) -> None: ...
+    def write_indef_text_start(self) -> None: ...
+    def write_break(self) -> None: ...
+    def write_bool(self, val: bool) -> None: ...
+    def write_epoch_time(self, val: float) -> None: ...
+    def write_list(self, val: list[Any]) -> None: ...
+    def write_dict(self, val: dict[Any, Any]) -> None: ...
+    def write_data_item(self, data_item: Any) -> None: ...
+
+class AwsCborDecoder(NativeResource):
+    def __init__(
+        self, src: bytes, on_epoch_time: Callable[[float], Any] | None = ..., **kwargs: Any
+    ) -> None: ...
+    def _on_epoch_time_callback(self, epoch_secs: float) -> Any: ...
+    def peek_next_type(self) -> AwsCborType: ...
+    def get_remaining_bytes_len(self) -> int: ...
+    def get_remaining_bytes(self) -> bytes: ...
+    def reset_src(self, src: bytes) -> None: ...
+    def consume_next_single_element(self) -> None: ...
+    def consume_next_whole_data_item(self) -> None: ...
+    def pop_next_unsigned_int(self) -> int: ...
+    def pop_next_negative_int(self) -> int: ...
+    def pop_next_double(self) -> float: ...
+    def pop_next_bool(self) -> bool: ...
+    def pop_next_bytes(self) -> bytes: ...
+    def pop_next_text(self) -> str: ...
+    def pop_next_array_start(self) -> int: ...
+    def pop_next_map_start(self) -> int: ...
+    def pop_next_tag_val(self) -> int: ...
+    def pop_next_list(self) -> list[Any]: ...
+    def pop_next_map(self) -> dict[Any, Any]: ...
+    def pop_next_data_item(self) -> Any: ...

awscrt-stubs/checksums.pyi

@@ -0,0 +1,9 @@
+"""
+Type annotations for awscrt.checksums module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+def crc32(input: bytes, previous_crc32: int = ...) -> int: ...
+def crc32c(input: bytes, previous_crc32c: int = ...) -> int: ...
+def crc64nvme(input: bytes, previous_crc64nvme: int = 0) -> int: ...

awscrt-stubs/common.pyi

@@ -0,0 +1,9 @@
+"""
+Type annotations for awscrt.common module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+def get_cpu_group_count() -> int: ...
+def get_cpu_count_for_group(group_idx: int) -> int: ...
+def join_all_native_threads(*, timeout_sec: float = ...) -> bool: ...

awscrt-stubs/crypto.pyi

@@ -0,0 +1,121 @@
+"""
+Type annotations for awscrt.crypto module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from enum import IntEnum
+from typing import Any, NamedTuple
+
+from awscrt import NativeResource
+
+class Hash:
+    def __init__(self, native_handle: Any) -> None: ...
+    @staticmethod
+    def sha1_new() -> Hash: ...
+    @staticmethod
+    def sha256_new() -> Hash: ...
+    @staticmethod
+    def md5_new() -> Hash: ...
+    def update(self, to_hash: Any) -> None: ...
+    def digest(self, truncate_to: int = ...) -> str: ...
+
+class HMAC:
+    def __init__(self, native_handle: Any) -> None: ...
+    @staticmethod
+    def sha256_hmac_new(secret_key: str) -> HMAC: ...
+    def update(self, to_hmac: Any) -> None: ...
+    def digest(self, truncate_to: int = ...) -> str: ...
+
+class RSAEncryptionAlgorithm(IntEnum):
+    PKCS1_5 = 0
+    OAEP_SHA256 = 1
+    OAEP_SHA512 = 2
+
+class RSASignatureAlgorithm(IntEnum):
+    PKCS1_5_SHA256 = 0
+    PKCS1_5_SHA1 = 1
+    PSS_SHA256 = 2
+
+class RSA(NativeResource):
+    def __init__(self, binding: Any) -> None: ...
+    @staticmethod
+    def new_private_key_from_pem_data(
+        pem_data: str | bytes | bytearray | memoryview,
+    ) -> RSA: ...
+    @staticmethod
+    def new_public_key_from_pem_data(
+        pem_data: str | bytes | bytearray | memoryview,
+    ) -> RSA: ...
+    @staticmethod
+    def new_private_key_from_der_data(
+        der_data: str | bytes | bytearray | memoryview,
+    ) -> RSA: ...
+    @staticmethod
+    def new_public_key_from_der_data(der_data: bytes | bytearray | memoryview) -> RSA: ...
+    def encrypt(
+        self,
+        encryption_algorithm: RSAEncryptionAlgorithm,
+        plaintext: bytes | bytearray | memoryview,
+    ) -> bytes: ...
+    def decrypt(
+        self,
+        encryption_algorithm: RSAEncryptionAlgorithm,
+        ciphertext: bytes | bytearray | memoryview,
+    ) -> bytes: ...
+    def sign(
+        self,
+        signature_algorithm: RSASignatureAlgorithm,
+        digest: bytes | bytearray | memoryview,
+    ) -> bytes: ...
+    def verify(
+        self,
+        signature_algorithm: RSASignatureAlgorithm,
+        digest: bytes | bytearray | memoryview,
+        signature: bytes | bytearray | memoryview,
+    ) -> bool: ...
+
+class ED25519ExportFormat(IntEnum):
+    RAW = 0
+    OPENSSH_B64 = 1
+
+class ED25519(NativeResource):
+    def __init__(self, binding: Any) -> None: ...
+    @staticmethod
+    def new_generate() -> ED25519: ...
+    def export_public_key(self, export_format: ED25519ExportFormat) -> bytes: ...
+    def export_private_key(self, export_format: ED25519ExportFormat) -> bytes: ...
+
+class ECType(IntEnum):
+    P_256 = 0
+    P_384 = 1
+
+class ECExportFormat(IntEnum):
+    SEC1 = 0
+    PKCS8 = 1
+    SPKI = 2
+
+class ECRawSignature(NamedTuple):
+    r: bytes
+    s: bytes
+
+class ECPublicCoords(NamedTuple):
+    x: bytes
+    y: bytes
+
+class EC(NativeResource):
+    def __init__(self, binding: Any) -> None: ...
+    @staticmethod
+    def new_generate(type: ECType) -> EC: ...
+    @staticmethod
+    def new_key_from_der_data(der_data: bytes | bytearray | memoryview) -> EC: ...
+    @staticmethod
+    def decode_der_signature(signature: bytes) -> ECRawSignature: ...
+    @staticmethod
+    def encode_raw_signature(signature: ECRawSignature) -> bytes: ...
+    def export_key(self, export_format: ECExportFormat) -> bytes: ...
+    def get_public_coords(self) -> ECPublicCoords: ...
+    def sign(self, digest: bytes | bytearray | memoryview) -> bytes: ...
+    def verify(
+        self, digest: bytes | bytearray | memoryview, signature: bytes | bytearray | memoryview
+    ) -> bool: ...

awscrt-stubs/eventstream/__init__.pyi

@@ -0,0 +1,60 @@
+"""
+Type annotations for awscrt.eventstream module.
+
+Copyright 2024 Vlad Emelianov
+"""
+
+from enum import IntEnum
+from typing import Any
+from uuid import UUID
+
+__all__ = ["Header", "HeaderType"]
+
+class HeaderType(IntEnum):
+    BOOL_TRUE = 0
+    BOOL_FALSE = 1
+    BYTE = 2
+    INT16 = 3
+    INT32 = 4
+    INT64 = 5
+    BYTE_BUF = 6
+    STRING = 7
+    TIMESTAMP = 8
+    UUID = 9
+    def __format__(self, format_spec: str) -> str: ...
+
+class Header:
+    def __init__(self, name: str, value: Any, header_type: HeaderType) -> None: ...
+    @classmethod
+    def from_bool(cls, name: str, value: bool) -> Header: ...
+    @classmethod
+    def from_byte(cls, name: str, value: int) -> Header: ...
+    @classmethod
+    def from_int16(cls, name: str, value: int) -> Header: ...
+    @classmethod
+    def from_int32(cls, name: str, value: int) -> Header: ...
+    @classmethod
+    def from_int64(cls, name: str, value: int) -> Header: ...
+    @classmethod
+    def from_byte_buf(cls, name: str, value: bytes | bytearray) -> Header: ...
+    @classmethod
+    def from_string(cls, name: str, value: str) -> Header: ...
+    @classmethod
+    def from_timestamp(cls, name: str, value: int) -> Header: ...
+    @classmethod
+    def from_uuid(cls, name: str, value: UUID) -> Header: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def type(self) -> HeaderType: ...
+    @property
+    def value(self) -> Any: ...
+    def value_as_bool(self) -> bool: ...
+    def value_as_byte(self) -> int: ...
+    def value_as_int16(self) -> int: ...
+    def value_as_int32(self) -> int: ...
+    def value_as_int64(self) -> int: ...
+    def value_as_byte_buf(self) -> bytes | bytearray: ...
+    def value_as_string(self) -> str: ...
+    def value_as_timestamp(self) -> int: ...
+    def value_as_uuid(self) -> UUID: ...