selectwin 0.1.0__py3-none-any.whl

selectwin/__init__.py

@@ -0,0 +1,59 @@
+"""Official Selectwin Python SDK.
+
+A generated core (openapi-python-client, httpx sync + async) plus a hand-written
+DX shell: typed client, typed errors, auto-retries, idempotency, sync/async
+pagination and webhook signature verification.
+"""
+
+from __future__ import annotations
+
+from .client import AsyncSelectwin, Selectwin, SDK_VERSION
+from .errors import (
+    APIConnectionError,
+    APIError,
+    AuthenticationError,
+    CardError,
+    ConflictError,
+    NotFoundError,
+    PermissionDeniedError,
+    RateLimitError,
+    SelectwinError,
+    SignatureVerificationError,
+    ValidationError,
+    error_from_status,
+)
+from .pagination import AsyncPager, SyncPager
+from .webhook_events import WEBHOOK_EVENT_TYPES, WebhookEventType, is_webhook_event_type
+from .webhooks import SelectwinEvent, construct_event
+
+__version__ = SDK_VERSION
+
+__all__ = [
+    "__version__",
+    # clients
+    "Selectwin",
+    "AsyncSelectwin",
+    # errors
+    "SelectwinError",
+    "APIConnectionError",
+    "APIError",
+    "AuthenticationError",
+    "PermissionDeniedError",
+    "NotFoundError",
+    "ConflictError",
+    "ValidationError",
+    "CardError",
+    "RateLimitError",
+    "SignatureVerificationError",
+    "error_from_status",
+    # pagination
+    "SyncPager",
+    "AsyncPager",
+    # webhooks
+    "construct_event",
+    "SelectwinEvent",
+    # webhook event catalog
+    "WEBHOOK_EVENT_TYPES",
+    "WebhookEventType",
+    "is_webhook_event_type",
+]

selectwin/_core/__init__.py

@@ -0,0 +1,8 @@
+"""A client library for accessing Selectwin Public API"""
+
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)

selectwin/_core/api/__init__.py

@@ -0,0 +1 @@
+"""Contains methods for accessing the API"""

selectwin/_core/api/addresses/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

selectwin/_core/api/addresses/create_address.py

@@ -0,0 +1,160 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.create_address_body import CreateAddressBody
+from ...models.create_address_response_201 import CreateAddressResponse201
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: CreateAddressBody,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/v1/addresses",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> CreateAddressResponse201 | None:
+    if response.status_code == 201:
+        response_201 = CreateAddressResponse201.from_dict(response.json())
+
+        return response_201
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[CreateAddressResponse201]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: CreateAddressBody,
+) -> Response[CreateAddressResponse201]:
+    """Create an address
+
+    Args:
+        body (CreateAddressBody):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[CreateAddressResponse201]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    body: CreateAddressBody,
+) -> CreateAddressResponse201 | None:
+    """Create an address
+
+    Args:
+        body (CreateAddressBody):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        CreateAddressResponse201
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: CreateAddressBody,
+) -> Response[CreateAddressResponse201]:
+    """Create an address
+
+    Args:
+        body (CreateAddressBody):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[CreateAddressResponse201]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    body: CreateAddressBody,
+) -> CreateAddressResponse201 | None:
+    """Create an address
+
+    Args:
+        body (CreateAddressBody):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        CreateAddressResponse201
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed

selectwin/_core/api/addresses/delete_address.py

@@ -0,0 +1,155 @@
+from http import HTTPStatus
+from typing import Any
+from urllib.parse import quote
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.delete_address_response_200 import DeleteAddressResponse200
+from ...types import Response
+
+
+def _get_kwargs(
+    address_id: str,
+) -> dict[str, Any]:
+
+    _kwargs: dict[str, Any] = {
+        "method": "delete",
+        "url": "/v1/addresses/{address_id}".format(
+            address_id=quote(str(address_id), safe=""),
+        ),
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> DeleteAddressResponse200 | None:
+    if response.status_code == 200:
+        response_200 = DeleteAddressResponse200.from_dict(response.json())
+
+        return response_200
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[DeleteAddressResponse200]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    address_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[DeleteAddressResponse200]:
+    """Delete an address
+
+    Args:
+        address_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[DeleteAddressResponse200]
+    """
+
+    kwargs = _get_kwargs(
+        address_id=address_id,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    address_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> DeleteAddressResponse200 | None:
+    """Delete an address
+
+    Args:
+        address_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        DeleteAddressResponse200
+    """
+
+    return sync_detailed(
+        address_id=address_id,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    address_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[DeleteAddressResponse200]:
+    """Delete an address
+
+    Args:
+        address_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[DeleteAddressResponse200]
+    """
+
+    kwargs = _get_kwargs(
+        address_id=address_id,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    address_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> DeleteAddressResponse200 | None:
+    """Delete an address
+
+    Args:
+        address_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        DeleteAddressResponse200
+    """
+
+    return (
+        await asyncio_detailed(
+            address_id=address_id,
+            client=client,
+        )
+    ).parsed

selectwin/_core/api/addresses/get_address.py

@@ -0,0 +1,155 @@
+from http import HTTPStatus
+from typing import Any
+from urllib.parse import quote
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.get_address_response_200 import GetAddressResponse200
+from ...types import Response
+
+
+def _get_kwargs(
+    address_id: str,
+) -> dict[str, Any]:
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/v1/addresses/{address_id}".format(
+            address_id=quote(str(address_id), safe=""),
+        ),
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> GetAddressResponse200 | None:
+    if response.status_code == 200:
+        response_200 = GetAddressResponse200.from_dict(response.json())
+
+        return response_200
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[GetAddressResponse200]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    address_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[GetAddressResponse200]:
+    """Retrieve an address
+
+    Args:
+        address_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[GetAddressResponse200]
+    """
+
+    kwargs = _get_kwargs(
+        address_id=address_id,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    address_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> GetAddressResponse200 | None:
+    """Retrieve an address
+
+    Args:
+        address_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        GetAddressResponse200
+    """
+
+    return sync_detailed(
+        address_id=address_id,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    address_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[GetAddressResponse200]:
+    """Retrieve an address
+
+    Args:
+        address_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[GetAddressResponse200]
+    """
+
+    kwargs = _get_kwargs(
+        address_id=address_id,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    address_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> GetAddressResponse200 | None:
+    """Retrieve an address
+
+    Args:
+        address_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        GetAddressResponse200
+    """
+
+    return (
+        await asyncio_detailed(
+            address_id=address_id,
+            client=client,
+        )
+    ).parsed