"""Create a new collection"""
from http import HTTPStatus
from typing import Any
from typing import Dict
from typing import Union
import httpx
from ... import errors
from ...client import AuthenticatedClient
from ...client import Client
from ...models.collection import Collection
from ...models.new_collection import NewCollection
from ...models.server_error import ServerError
from ...types import Response
def _get_kwargs(
*,
body: NewCollection,
) -> Dict[str, Any]:
headers: Dict[str, Any] = {}
_kwargs: Dict[str, Any] = {
"method": "post",
"url": "/collections",
}
_body = body.to_dict()
_kwargs["json"] = _body
headers["Content-Type"] = "application/json"
_kwargs["headers"] = headers
return _kwargs
def _parse_response(
*, client: Union[AuthenticatedClient, Client], response: httpx.Response
) -> Union[Collection, ServerError]:
if response.status_code == HTTPStatus.CREATED:
response_201 = Collection.from_dict(response.json())
return response_201
if response.status_code == HTTPStatus.BAD_REQUEST:
response_400 = ServerError.from_dict(response.json())
return response_400
if response.status_code == HTTPStatus.UNAUTHORIZED:
response_401 = ServerError.from_dict(response.json())
return response_401
if response.status_code == HTTPStatus.FORBIDDEN:
response_403 = ServerError.from_dict(response.json())
return response_403
if response.status_code == HTTPStatus.UNSUPPORTED_MEDIA_TYPE:
response_415 = ServerError.from_dict(response.json())
return response_415
if response.status_code == HTTPStatus.INTERNAL_SERVER_ERROR:
response_500 = ServerError.from_dict(response.json())
return response_500
raise errors.UnexpectedStatus(response.status_code, response.content)
def _build_response(
*, client: Union[AuthenticatedClient, Client], response: httpx.Response
) -> Response[Union[Collection, ServerError]]:
return Response(
status_code=HTTPStatus(response.status_code),
content=response.content,
headers=response.headers,
parsed=_parse_response(client=client, response=response),
)
[docs]
def sync_detailed(
*,
client: AuthenticatedClient,
body: NewCollection,
) -> Response[Union[Collection, ServerError]]:
"""Create a new collection
Create a new collection accessible to the currently logged-in user.
Args:
body (NewCollection): New collection request
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[Collection, ServerError]]
"""
kwargs = _get_kwargs(
body=body,
)
response = client.get_httpx_client().request(
**kwargs,
)
return _build_response(client=client, response=response)
[docs]
def sync(
*,
client: AuthenticatedClient,
body: NewCollection,
) -> Union[Collection]:
"""Create a new collection
Create a new collection accessible to the currently logged-in user.
Args:
body (NewCollection): New collection request
Raises:
errors.UnexpectedStatus: If the server returns a status code greater than or equal to 300.
httpx.TimeoutException: If the request takes longer than Client.timeout.
Returns:
Union[Collection]
"""
response = sync_detailed(
client=client,
body=body,
)
if isinstance(response.parsed, ServerError):
raise errors.UnexpectedStatus(response.status_code, response.content)
return response.parsed
[docs]
async def asyncio_detailed(
*,
client: AuthenticatedClient,
body: NewCollection,
) -> Response[Union[Collection, ServerError]]:
"""Create a new collection
Create a new collection accessible to the currently logged-in user.
Args:
body (NewCollection): New collection request
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[Collection, ServerError]]
"""
kwargs = _get_kwargs(
body=body,
)
response = await client.get_async_httpx_client().request(**kwargs)
return _build_response(client=client, response=response)
[docs]
async def asyncio(
*,
client: AuthenticatedClient,
body: NewCollection,
) -> Union[Collection]:
"""Create a new collection
Create a new collection accessible to the currently logged-in user.
Args:
body (NewCollection): New collection request
Raises:
errors.UnexpectedStatus: If the server returns a status code greater than or equal to 300.
httpx.TimeoutException: If the request takes longer than Client.timeout.
Returns:
Union[Collection]
"""
response = await asyncio_detailed(
client=client,
body=body,
)
if isinstance(response.parsed, ServerError):
raise errors.UnexpectedStatus(response.status_code, response.content)
return response.parsed