antfly-sdk 0.0.2.dev2__py3-none-any.whl

antfly/client_generated/api/data_operations/linear_merge.py

@@ -0,0 +1,338 @@
+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.error import Error
+from ...models.linear_merge_request import LinearMergeRequest
+from ...models.linear_merge_result import LinearMergeResult
+from ...types import Response
+
+
+def _get_kwargs(
+    table_name: str,
+    *,
+    body: LinearMergeRequest,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/db/v1/tables/{table_name}/merge".format(
+            table_name=quote(str(table_name), safe=""),
+        ),
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Error | LinearMergeResult | None:
+    if response.status_code == 200:
+        response_200 = LinearMergeResult.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 400:
+        response_400 = Error.from_dict(response.json())
+
+        return response_400
+
+    if response.status_code == 404:
+        response_404 = Error.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 413:
+        response_413 = Error.from_dict(response.json())
+
+        return response_413
+
+    if response.status_code == 415:
+        response_415 = Error.from_dict(response.json())
+
+        return response_415
+
+    if response.status_code == 500:
+        response_500 = Error.from_dict(response.json())
+
+        return response_500
+
+    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[Error | LinearMergeResult]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    table_name: str,
+    *,
+    client: AuthenticatedClient,
+    body: LinearMergeRequest,
+) -> Response[Error | LinearMergeResult]:
+    """Synchronize data from external sources (Shopify, Postgres, S3) using a linear merge
+
+     Synchronize and keep Antfly in sync with external data sources like Shopify,
+    Postgres, S3, or any sorted record source. Also known as: data synchronization,
+    database sync, incremental sync, e-commerce sync.
+
+    Both source and destination must be sorted by the same key. Performs three-way merge:
+    - Inserts new records from source
+    - Updates changed records
+    - Deletes Antfly records absent from source page
+
+    **Stateless & Idempotent**: No sync state between pages. Safe to restart
+    from any page if interrupted.
+
+    **Use Cases**: Sync production databases, e-commerce APIs (Shopify, WooCommerce),
+    data lake exports, or warehouse tables to Antfly for low-latency hybrid search.
+
+    **WARNING**: Not safe for concurrent merges with overlapping ranges.
+    Single-client sync API only.
+
+    Args:
+        table_name (str):
+        body (LinearMergeRequest): Linear merge operation for syncing sorted records from external
+            sources.
+            Use this to keep Antfly in sync with an external database or data source.
+
+            Requests may be sent as plain JSON or gzip-compressed JSON
+            (`Content-Encoding: gzip`).
+
+            Request bodies are limited to 64 MiB after decompression. Requests that
+            exceed this limit return HTTP 413.
+
+            **How it works:**
+            1. Send sorted records from your external source
+            2. Server upserts records that exist in your batch
+            3. Server deletes Antfly records in the key range that are absent from your batch
+            4. If stopped at shard boundary, use next_cursor for next request
+
+            **WARNING:** Not safe for concurrent operations with overlapping key ranges.
+
+    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[Error | LinearMergeResult]
+    """
+
+    kwargs = _get_kwargs(
+        table_name=table_name,
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    table_name: str,
+    *,
+    client: AuthenticatedClient,
+    body: LinearMergeRequest,
+) -> Error | LinearMergeResult | None:
+    """Synchronize data from external sources (Shopify, Postgres, S3) using a linear merge
+
+     Synchronize and keep Antfly in sync with external data sources like Shopify,
+    Postgres, S3, or any sorted record source. Also known as: data synchronization,
+    database sync, incremental sync, e-commerce sync.
+
+    Both source and destination must be sorted by the same key. Performs three-way merge:
+    - Inserts new records from source
+    - Updates changed records
+    - Deletes Antfly records absent from source page
+
+    **Stateless & Idempotent**: No sync state between pages. Safe to restart
+    from any page if interrupted.
+
+    **Use Cases**: Sync production databases, e-commerce APIs (Shopify, WooCommerce),
+    data lake exports, or warehouse tables to Antfly for low-latency hybrid search.
+
+    **WARNING**: Not safe for concurrent merges with overlapping ranges.
+    Single-client sync API only.
+
+    Args:
+        table_name (str):
+        body (LinearMergeRequest): Linear merge operation for syncing sorted records from external
+            sources.
+            Use this to keep Antfly in sync with an external database or data source.
+
+            Requests may be sent as plain JSON or gzip-compressed JSON
+            (`Content-Encoding: gzip`).
+
+            Request bodies are limited to 64 MiB after decompression. Requests that
+            exceed this limit return HTTP 413.
+
+            **How it works:**
+            1. Send sorted records from your external source
+            2. Server upserts records that exist in your batch
+            3. Server deletes Antfly records in the key range that are absent from your batch
+            4. If stopped at shard boundary, use next_cursor for next request
+
+            **WARNING:** Not safe for concurrent operations with overlapping key ranges.
+
+    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:
+        Error | LinearMergeResult
+    """
+
+    return sync_detailed(
+        table_name=table_name,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    table_name: str,
+    *,
+    client: AuthenticatedClient,
+    body: LinearMergeRequest,
+) -> Response[Error | LinearMergeResult]:
+    """Synchronize data from external sources (Shopify, Postgres, S3) using a linear merge
+
+     Synchronize and keep Antfly in sync with external data sources like Shopify,
+    Postgres, S3, or any sorted record source. Also known as: data synchronization,
+    database sync, incremental sync, e-commerce sync.
+
+    Both source and destination must be sorted by the same key. Performs three-way merge:
+    - Inserts new records from source
+    - Updates changed records
+    - Deletes Antfly records absent from source page
+
+    **Stateless & Idempotent**: No sync state between pages. Safe to restart
+    from any page if interrupted.
+
+    **Use Cases**: Sync production databases, e-commerce APIs (Shopify, WooCommerce),
+    data lake exports, or warehouse tables to Antfly for low-latency hybrid search.
+
+    **WARNING**: Not safe for concurrent merges with overlapping ranges.
+    Single-client sync API only.
+
+    Args:
+        table_name (str):
+        body (LinearMergeRequest): Linear merge operation for syncing sorted records from external
+            sources.
+            Use this to keep Antfly in sync with an external database or data source.
+
+            Requests may be sent as plain JSON or gzip-compressed JSON
+            (`Content-Encoding: gzip`).
+
+            Request bodies are limited to 64 MiB after decompression. Requests that
+            exceed this limit return HTTP 413.
+
+            **How it works:**
+            1. Send sorted records from your external source
+            2. Server upserts records that exist in your batch
+            3. Server deletes Antfly records in the key range that are absent from your batch
+            4. If stopped at shard boundary, use next_cursor for next request
+
+            **WARNING:** Not safe for concurrent operations with overlapping key ranges.
+
+    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[Error | LinearMergeResult]
+    """
+
+    kwargs = _get_kwargs(
+        table_name=table_name,
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    table_name: str,
+    *,
+    client: AuthenticatedClient,
+    body: LinearMergeRequest,
+) -> Error | LinearMergeResult | None:
+    """Synchronize data from external sources (Shopify, Postgres, S3) using a linear merge
+
+     Synchronize and keep Antfly in sync with external data sources like Shopify,
+    Postgres, S3, or any sorted record source. Also known as: data synchronization,
+    database sync, incremental sync, e-commerce sync.
+
+    Both source and destination must be sorted by the same key. Performs three-way merge:
+    - Inserts new records from source
+    - Updates changed records
+    - Deletes Antfly records absent from source page
+
+    **Stateless & Idempotent**: No sync state between pages. Safe to restart
+    from any page if interrupted.
+
+    **Use Cases**: Sync production databases, e-commerce APIs (Shopify, WooCommerce),
+    data lake exports, or warehouse tables to Antfly for low-latency hybrid search.
+
+    **WARNING**: Not safe for concurrent merges with overlapping ranges.
+    Single-client sync API only.
+
+    Args:
+        table_name (str):
+        body (LinearMergeRequest): Linear merge operation for syncing sorted records from external
+            sources.
+            Use this to keep Antfly in sync with an external database or data source.
+
+            Requests may be sent as plain JSON or gzip-compressed JSON
+            (`Content-Encoding: gzip`).
+
+            Request bodies are limited to 64 MiB after decompression. Requests that
+            exceed this limit return HTTP 413.
+
+            **How it works:**
+            1. Send sorted records from your external source
+            2. Server upserts records that exist in your batch
+            3. Server deletes Antfly records in the key range that are absent from your batch
+            4. If stopped at shard boundary, use next_cursor for next request
+
+            **WARNING:** Not safe for concurrent operations with overlapping key ranges.
+
+    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:
+        Error | LinearMergeResult
+    """
+
+    return (
+        await asyncio_detailed(
+            table_name=table_name,
+            client=client,
+            body=body,
+        )
+    ).parsed

antfly/client_generated/api/data_operations/list_transaction_sessions.py

@@ -0,0 +1,134 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.error import Error
+from ...models.transaction_session_list_response import TransactionSessionListResponse
+from ...types import Response
+
+
+def _get_kwargs() -> dict[str, Any]:
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/db/v1/transactions",
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Error | TransactionSessionListResponse | None:
+    if response.status_code == 200:
+        response_200 = TransactionSessionListResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 500:
+        response_500 = Error.from_dict(response.json())
+
+        return response_500
+
+    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[Error | TransactionSessionListResponse]:
+    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,
+) -> Response[Error | TransactionSessionListResponse]:
+    """List transaction sessions
+
+    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[Error | TransactionSessionListResponse]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+) -> Error | TransactionSessionListResponse | None:
+    """List transaction sessions
+
+    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:
+        Error | TransactionSessionListResponse
+    """
+
+    return sync_detailed(
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+) -> Response[Error | TransactionSessionListResponse]:
+    """List transaction sessions
+
+    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[Error | TransactionSessionListResponse]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+) -> Error | TransactionSessionListResponse | None:
+    """List transaction sessions
+
+    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:
+        Error | TransactionSessionListResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+        )
+    ).parsed

antfly/client_generated/api/data_operations/lookup_key.py

@@ -0,0 +1,206 @@
+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.error import Error
+from ...models.lookup_key_response_200 import LookupKeyResponse200
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    table_name: str,
+    key: str,
+    *,
+    fields: str | Unset = UNSET,
+) -> dict[str, Any]:
+
+    params: dict[str, Any] = {}
+
+    params["fields"] = fields
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/db/v1/tables/{table_name}/lookup/{key}".format(
+            table_name=quote(str(table_name), safe=""),
+            key=quote(str(key), safe=""),
+        ),
+        "params": params,
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Error | LookupKeyResponse200 | None:
+    if response.status_code == 200:
+        response_200 = LookupKeyResponse200.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 400:
+        response_400 = Error.from_dict(response.json())
+
+        return response_400
+
+    if response.status_code == 404:
+        response_404 = Error.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 500:
+        response_500 = Error.from_dict(response.json())
+
+        return response_500
+
+    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[Error | LookupKeyResponse200]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    table_name: str,
+    key: str,
+    *,
+    client: AuthenticatedClient,
+    fields: str | Unset = UNSET,
+) -> Response[Error | LookupKeyResponse200]:
+    """Lookup a key in a table
+
+    Args:
+        table_name (str):
+        key (str):
+        fields (str | Unset):
+
+    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[Error | LookupKeyResponse200]
+    """
+
+    kwargs = _get_kwargs(
+        table_name=table_name,
+        key=key,
+        fields=fields,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    table_name: str,
+    key: str,
+    *,
+    client: AuthenticatedClient,
+    fields: str | Unset = UNSET,
+) -> Error | LookupKeyResponse200 | None:
+    """Lookup a key in a table
+
+    Args:
+        table_name (str):
+        key (str):
+        fields (str | Unset):
+
+    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:
+        Error | LookupKeyResponse200
+    """
+
+    return sync_detailed(
+        table_name=table_name,
+        key=key,
+        client=client,
+        fields=fields,
+    ).parsed
+
+
+async def asyncio_detailed(
+    table_name: str,
+    key: str,
+    *,
+    client: AuthenticatedClient,
+    fields: str | Unset = UNSET,
+) -> Response[Error | LookupKeyResponse200]:
+    """Lookup a key in a table
+
+    Args:
+        table_name (str):
+        key (str):
+        fields (str | Unset):
+
+    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[Error | LookupKeyResponse200]
+    """
+
+    kwargs = _get_kwargs(
+        table_name=table_name,
+        key=key,
+        fields=fields,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    table_name: str,
+    key: str,
+    *,
+    client: AuthenticatedClient,
+    fields: str | Unset = UNSET,
+) -> Error | LookupKeyResponse200 | None:
+    """Lookup a key in a table
+
+    Args:
+        table_name (str):
+        key (str):
+        fields (str | Unset):
+
+    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:
+        Error | LookupKeyResponse200
+    """
+
+    return (
+        await asyncio_detailed(
+            table_name=table_name,
+            key=key,
+            client=client,
+            fields=fields,
+        )
+    ).parsed