minikai 0.1.7__py3-none-any.whl

minikai/api/users/post_api_users_minis.py

@@ -0,0 +1,187 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union, cast
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+from ...models.http_validation_problem_details import HttpValidationProblemDetails
+from typing import cast
+
+
+
+def _get_kwargs(
+    user_id: str,
+    mini_id: int,
+
+) -> dict[str, Any]:
+    
+
+    
+
+    
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/api/Users/{user_id}/minis/{mini_id}".format(user_id=user_id,mini_id=mini_id,),
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: Union[AuthenticatedClient, Client], response: httpx.Response) -> Optional[Union[Any, HttpValidationProblemDetails]]:
+    if response.status_code == 204:
+        response_204 = cast(Any, None)
+        return response_204
+
+    if response.status_code == 400:
+        response_400 = HttpValidationProblemDetails.from_dict(response.json())
+
+
+
+        return response_400
+
+    if response.status_code == 404:
+        response_404 = cast(Any, None)
+        return response_404
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: Union[AuthenticatedClient, Client], response: httpx.Response) -> Response[Union[Any, HttpValidationProblemDetails]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    user_id: str,
+    mini_id: int,
+    *,
+    client: Union[AuthenticatedClient, Client],
+
+) -> Response[Union[Any, HttpValidationProblemDetails]]:
+    """ 
+    Args:
+        user_id (str):
+        mini_id (int):
+
+    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[Union[Any, HttpValidationProblemDetails]]
+     """
+
+
+    kwargs = _get_kwargs(
+        user_id=user_id,
+mini_id=mini_id,
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+def sync(
+    user_id: str,
+    mini_id: int,
+    *,
+    client: Union[AuthenticatedClient, Client],
+
+) -> Optional[Union[Any, HttpValidationProblemDetails]]:
+    """ 
+    Args:
+        user_id (str):
+        mini_id (int):
+
+    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:
+        Union[Any, HttpValidationProblemDetails]
+     """
+
+
+    return sync_detailed(
+        user_id=user_id,
+mini_id=mini_id,
+client=client,
+
+    ).parsed
+
+async def asyncio_detailed(
+    user_id: str,
+    mini_id: int,
+    *,
+    client: Union[AuthenticatedClient, Client],
+
+) -> Response[Union[Any, HttpValidationProblemDetails]]:
+    """ 
+    Args:
+        user_id (str):
+        mini_id (int):
+
+    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[Union[Any, HttpValidationProblemDetails]]
+     """
+
+
+    kwargs = _get_kwargs(
+        user_id=user_id,
+mini_id=mini_id,
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+
+async def asyncio(
+    user_id: str,
+    mini_id: int,
+    *,
+    client: Union[AuthenticatedClient, Client],
+
+) -> Optional[Union[Any, HttpValidationProblemDetails]]:
+    """ 
+    Args:
+        user_id (str):
+        mini_id (int):
+
+    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:
+        Union[Any, HttpValidationProblemDetails]
+     """
+
+
+    return (await asyncio_detailed(
+        user_id=user_id,
+mini_id=mini_id,
+client=client,
+
+    )).parsed

minikai/client.py

@@ -0,0 +1,271 @@
+import ssl
+from typing import Any, Union, Optional
+
+from attrs import define, field, evolve
+import httpx
+
+
+
+
+
+@define
+class Client:
+    """A class for keeping track of data related to the API
+
+    The following are accepted as keyword arguments and will be used to construct httpx Clients internally:
+
+        ``base_url``: The base URL for the API, all requests are made to a relative path to this URL
+
+        ``cookies``: A dictionary of cookies to be sent with every request
+
+        ``headers``: A dictionary of headers to be sent with every request
+
+        ``timeout``: The maximum amount of a time a request can take. API functions will raise
+        httpx.TimeoutException if this is exceeded.
+
+        ``verify_ssl``: Whether or not to verify the SSL certificate of the API server. This should be True in production,
+        but can be set to False for testing purposes.
+
+        ``follow_redirects``: Whether or not to follow redirects. Default value is False.
+
+        ``httpx_args``: A dictionary of additional arguments to be passed to the ``httpx.Client`` and ``httpx.AsyncClient`` constructor.
+
+
+    Attributes:
+        raise_on_unexpected_status: Whether or not to raise an errors.UnexpectedStatus if the API returns a
+            status code that was not documented in the source OpenAPI document. Can also be provided as a keyword
+            argument to the constructor.
+    """
+    raise_on_unexpected_status: bool = field(default=False, kw_only=True)
+    _base_url: str = field(alias="base_url")
+    _cookies: dict[str, str] = field(factory=dict, kw_only=True, alias="cookies")
+    _headers: dict[str, str] = field(factory=dict, kw_only=True, alias="headers")
+    _timeout: Optional[httpx.Timeout] = field(default=None, kw_only=True, alias="timeout")
+    _verify_ssl: Union[str, bool, ssl.SSLContext] = field(default=True, kw_only=True, alias="verify_ssl")
+    _follow_redirects: bool = field(default=False, kw_only=True, alias="follow_redirects")
+    _httpx_args: dict[str, Any] = field(factory=dict, kw_only=True, alias="httpx_args")
+    _client: Optional[httpx.Client] = field(default=None, init=False)
+    _async_client: Optional[httpx.AsyncClient] = field(default=None, init=False)
+
+    def with_headers(self, headers: dict[str, str]) -> "Client":
+        """Get a new client matching this one with additional headers"""
+        if self._client is not None:
+            self._client.headers.update(headers)
+        if self._async_client is not None:
+            self._async_client.headers.update(headers)
+        return evolve(self, headers={**self._headers, **headers})
+
+    def with_cookies(self, cookies: dict[str, str]) -> "Client":
+        """Get a new client matching this one with additional cookies"""
+        if self._client is not None:
+            self._client.cookies.update(cookies)
+        if self._async_client is not None:
+            self._async_client.cookies.update(cookies)
+        return evolve(self, cookies={**self._cookies, **cookies})
+
+    def with_timeout(self, timeout: httpx.Timeout) -> "Client":
+        """Get a new client matching this one with a new timeout (in seconds)"""
+        if self._client is not None:
+            self._client.timeout = timeout
+        if self._async_client is not None:
+            self._async_client.timeout = timeout
+        return evolve(self, timeout=timeout)
+
+    def set_httpx_client(self, client: httpx.Client) -> "Client":
+        """Manually set the underlying httpx.Client
+
+        **NOTE**: This will override any other settings on the client, including cookies, headers, and timeout.
+        """
+        self._client = client
+        return self
+
+    def get_httpx_client(self) -> httpx.Client:
+        """Get the underlying httpx.Client, constructing a new one if not previously set"""
+        if self._client is None:
+            self._client = httpx.Client(
+                base_url=self._base_url,
+                cookies=self._cookies,
+                headers=self._headers,
+                timeout=self._timeout,
+                verify=self._verify_ssl,
+                follow_redirects=self._follow_redirects,
+                **self._httpx_args,
+            )
+        return self._client
+
+    def __enter__(self) -> "Client":
+        """Enter a context manager for self.client—you cannot enter twice (see httpx docs)"""
+        self.get_httpx_client().__enter__()
+        return self
+
+    def __exit__(self, *args: Any, **kwargs: Any) -> None:
+        """Exit a context manager for internal httpx.Client (see httpx docs)"""
+        self.get_httpx_client().__exit__(*args, **kwargs)
+
+    def set_async_httpx_client(self, async_client: httpx.AsyncClient) -> "Client":
+        """Manually the underlying httpx.AsyncClient
+
+        **NOTE**: This will override any other settings on the client, including cookies, headers, and timeout.
+        """
+        self._async_client = async_client
+        return self
+
+    def get_async_httpx_client(self) -> httpx.AsyncClient:
+        """Get the underlying httpx.AsyncClient, constructing a new one if not previously set"""
+        if self._async_client is None:
+            self._async_client = httpx.AsyncClient(
+                base_url=self._base_url,
+                cookies=self._cookies,
+                headers=self._headers,
+                timeout=self._timeout,
+                verify=self._verify_ssl,
+                follow_redirects=self._follow_redirects,
+                **self._httpx_args,
+            )
+        return self._async_client
+
+    async def __aenter__(self) -> "Client":
+        """Enter a context manager for underlying httpx.AsyncClient—you cannot enter twice (see httpx docs)"""
+        await self.get_async_httpx_client().__aenter__()
+        return self
+
+    async def __aexit__(self, *args: Any, **kwargs: Any) -> None:
+        """Exit a context manager for underlying httpx.AsyncClient (see httpx docs)"""
+        await self.get_async_httpx_client().__aexit__(*args, **kwargs)
+
+
+@define
+class AuthenticatedClient:
+    """A Client which has been authenticated for use on secured endpoints
+
+    The following are accepted as keyword arguments and will be used to construct httpx Clients internally:
+
+        ``base_url``: The base URL for the API, all requests are made to a relative path to this URL
+
+        ``cookies``: A dictionary of cookies to be sent with every request
+
+        ``headers``: A dictionary of headers to be sent with every request
+
+        ``timeout``: The maximum amount of a time a request can take. API functions will raise
+        httpx.TimeoutException if this is exceeded.
+
+        ``verify_ssl``: Whether or not to verify the SSL certificate of the API server. This should be True in production,
+        but can be set to False for testing purposes.
+
+        ``follow_redirects``: Whether or not to follow redirects. Default value is False.
+
+        ``httpx_args``: A dictionary of additional arguments to be passed to the ``httpx.Client`` and ``httpx.AsyncClient`` constructor.
+
+
+    Attributes:
+        raise_on_unexpected_status: Whether or not to raise an errors.UnexpectedStatus if the API returns a
+            status code that was not documented in the source OpenAPI document. Can also be provided as a keyword
+            argument to the constructor.
+        token: The token to use for authentication
+        prefix: The prefix to use for the Authorization header
+        auth_header_name: The name of the Authorization header
+    """
+
+    raise_on_unexpected_status: bool = field(default=False, kw_only=True)
+    _base_url: str = field(alias="base_url")
+    _cookies: dict[str, str] = field(factory=dict, kw_only=True, alias="cookies")
+    _headers: dict[str, str] = field(factory=dict, kw_only=True, alias="headers")
+    _timeout: Optional[httpx.Timeout] = field(default=None, kw_only=True, alias="timeout")
+    _verify_ssl: Union[str, bool, ssl.SSLContext] = field(default=True, kw_only=True, alias="verify_ssl")
+    _follow_redirects: bool = field(default=False, kw_only=True, alias="follow_redirects")
+    _httpx_args: dict[str, Any] = field(factory=dict, kw_only=True, alias="httpx_args")
+    _client: Optional[httpx.Client] = field(default=None, init=False)
+    _async_client: Optional[httpx.AsyncClient] = field(default=None, init=False)
+
+    token: str
+    prefix: str = "Bearer"
+    auth_header_name: str = "Authorization"
+
+    def with_headers(self, headers: dict[str, str]) -> "AuthenticatedClient":
+        """Get a new client matching this one with additional headers"""
+        if self._client is not None:
+            self._client.headers.update(headers)
+        if self._async_client is not None:
+            self._async_client.headers.update(headers)
+        return evolve(self, headers={**self._headers, **headers})
+
+    def with_cookies(self, cookies: dict[str, str]) -> "AuthenticatedClient":
+        """Get a new client matching this one with additional cookies"""
+        if self._client is not None:
+            self._client.cookies.update(cookies)
+        if self._async_client is not None:
+            self._async_client.cookies.update(cookies)
+        return evolve(self, cookies={**self._cookies, **cookies})
+
+    def with_timeout(self, timeout: httpx.Timeout) -> "AuthenticatedClient":
+        """Get a new client matching this one with a new timeout (in seconds)"""
+        if self._client is not None:
+            self._client.timeout = timeout
+        if self._async_client is not None:
+            self._async_client.timeout = timeout
+        return evolve(self, timeout=timeout)
+
+    def set_httpx_client(self, client: httpx.Client) -> "AuthenticatedClient":
+        """Manually set the underlying httpx.Client
+
+        **NOTE**: This will override any other settings on the client, including cookies, headers, and timeout.
+        """
+        self._client = client
+        return self
+
+    def get_httpx_client(self) -> httpx.Client:
+        """Get the underlying httpx.Client, constructing a new one if not previously set"""
+        if self._client is None:
+            self._headers[self.auth_header_name] = f"{self.prefix} {self.token}" if self.prefix else self.token
+            self._client = httpx.Client(
+                base_url=self._base_url,
+                cookies=self._cookies,
+                headers=self._headers,
+                timeout=self._timeout,
+                verify=self._verify_ssl,
+                follow_redirects=self._follow_redirects,
+                **self._httpx_args,
+            )
+        return self._client
+
+    def __enter__(self) -> "AuthenticatedClient":
+        """Enter a context manager for self.client—you cannot enter twice (see httpx docs)"""
+        self.get_httpx_client().__enter__()
+        return self
+
+    def __exit__(self, *args: Any, **kwargs: Any) -> None:
+        """Exit a context manager for internal httpx.Client (see httpx docs)"""
+        self.get_httpx_client().__exit__(*args, **kwargs)
+
+    def set_async_httpx_client(self, async_client: httpx.AsyncClient) -> "AuthenticatedClient":
+        """Manually the underlying httpx.AsyncClient
+
+        **NOTE**: This will override any other settings on the client, including cookies, headers, and timeout.
+        """
+        self._async_client = async_client
+        return self
+
+    def get_async_httpx_client(self) -> httpx.AsyncClient:
+        """Get the underlying httpx.AsyncClient, constructing a new one if not previously set"""
+        if self._async_client is None:
+            self._headers[self.auth_header_name] = f"{self.prefix} {self.token}" if self.prefix else self.token
+            self._async_client = httpx.AsyncClient(
+                base_url=self._base_url,
+                cookies=self._cookies,
+                headers=self._headers,
+                timeout=self._timeout,
+                verify=self._verify_ssl,
+                follow_redirects=self._follow_redirects,
+                **self._httpx_args,
+            )
+        return self._async_client
+
+    async def __aenter__(self) -> "AuthenticatedClient":
+        """Enter a context manager for underlying httpx.AsyncClient—you cannot enter twice (see httpx docs)"""
+        await self.get_async_httpx_client().__aenter__()
+        return self
+
+    async def __aexit__(self, *args: Any, **kwargs: Any) -> None:
+        """Exit a context manager for underlying httpx.AsyncClient (see httpx docs)"""
+        await self.get_async_httpx_client().__aexit__(*args, **kwargs)
+

minikai/errors.py

@@ -0,0 +1,14 @@
+""" Contains shared errors types that can be raised from API functions """
+
+class UnexpectedStatus(Exception):
+    """Raised by api functions when the response status an undocumented status and Client.raise_on_unexpected_status is True"""
+
+    def __init__(self, status_code: int, content: bytes):
+        self.status_code = status_code
+        self.content = content
+
+        super().__init__(
+            f"Unexpected status code: {status_code}\n\nResponse content:\n{content.decode(errors='ignore')}"
+        )
+
+__all__ = ["UnexpectedStatus"]

minikai/models/__init__.py

@@ -0,0 +1,103 @@
+""" Contains all the data models used in inputs/outputs """
+
+from .add_attachments_body import AddAttachmentsBody
+from .batch_upsert_result import BatchUpsertResult
+from .create_group_command import CreateGroupCommand
+from .create_mini_command import CreateMiniCommand
+from .create_record_command import CreateRecordCommand
+from .create_record_command_tags import CreateRecordCommandTags
+from .cursor_paginated_list_of_record_dto import CursorPaginatedListOfRecordDto
+from .document_file_dto import DocumentFileDto
+from .document_file_metadata_dto import DocumentFileMetadataDto
+from .failed_upsert_item import FailedUpsertItem
+from .form_field import FormField
+from .form_field_dto import FormFieldDto
+from .form_field_type import FormFieldType
+from .group_dto import GroupDto
+from .http_validation_problem_details import HttpValidationProblemDetails
+from .http_validation_problem_details_errors import HttpValidationProblemDetailsErrors
+from .mini_dto import MiniDto
+from .mini_template_dto import MiniTemplateDto
+from .paginated_list_of_record_dto import PaginatedListOfRecordDto
+from .patch_mini_command import PatchMiniCommand
+from .problem_details import ProblemDetails
+from .record import Record
+from .record_attachment import RecordAttachment
+from .record_attachment_dto import RecordAttachmentDto
+from .record_attachment_dto_metadata_type_0 import RecordAttachmentDtoMetadataType0
+from .record_attachment_metadata_type_0 import RecordAttachmentMetadataType0
+from .record_authorization import RecordAuthorization
+from .record_authorization_dto import RecordAuthorizationDto
+from .record_dto import RecordDto
+from .record_dto_tags import RecordDtoTags
+from .record_relation import RecordRelation
+from .record_relation_dto import RecordRelationDto
+from .record_state import RecordState
+from .record_tag import RecordTag
+from .record_tag_dto import RecordTagDto
+from .slim_mini_dto import SlimMiniDto
+from .tool_dto import ToolDto
+from .update_attachments_body import UpdateAttachmentsBody
+from .update_group_command import UpdateGroupCommand
+from .update_mini_command import UpdateMiniCommand
+from .update_mini_template_workspaces_command import UpdateMiniTemplateWorkspacesCommand
+from .update_record_command import UpdateRecordCommand
+from .update_record_command_tags import UpdateRecordCommandTags
+from .upsert_record_dto import UpsertRecordDto
+from .upsert_record_dto_tags import UpsertRecordDtoTags
+from .upsert_records_by_external_uri_command import UpsertRecordsByExternalUriCommand
+from .user_dto import UserDto
+from .user_to_mini_dto import UserToMiniDto
+from .workspace_dto import WorkspaceDto
+
+__all__ = (
+    "AddAttachmentsBody",
+    "BatchUpsertResult",
+    "CreateGroupCommand",
+    "CreateMiniCommand",
+    "CreateRecordCommand",
+    "CreateRecordCommandTags",
+    "CursorPaginatedListOfRecordDto",
+    "DocumentFileDto",
+    "DocumentFileMetadataDto",
+    "FailedUpsertItem",
+    "FormField",
+    "FormFieldDto",
+    "FormFieldType",
+    "GroupDto",
+    "HttpValidationProblemDetails",
+    "HttpValidationProblemDetailsErrors",
+    "MiniDto",
+    "MiniTemplateDto",
+    "PaginatedListOfRecordDto",
+    "PatchMiniCommand",
+    "ProblemDetails",
+    "Record",
+    "RecordAttachment",
+    "RecordAttachmentDto",
+    "RecordAttachmentDtoMetadataType0",
+    "RecordAttachmentMetadataType0",
+    "RecordAuthorization",
+    "RecordAuthorizationDto",
+    "RecordDto",
+    "RecordDtoTags",
+    "RecordRelation",
+    "RecordRelationDto",
+    "RecordState",
+    "RecordTag",
+    "RecordTagDto",
+    "SlimMiniDto",
+    "ToolDto",
+    "UpdateAttachmentsBody",
+    "UpdateGroupCommand",
+    "UpdateMiniCommand",
+    "UpdateMiniTemplateWorkspacesCommand",
+    "UpdateRecordCommand",
+    "UpdateRecordCommandTags",
+    "UpsertRecordDto",
+    "UpsertRecordDtoTags",
+    "UpsertRecordsByExternalUriCommand",
+    "UserDto",
+    "UserToMiniDto",
+    "WorkspaceDto",
+)