"""Get metadata on the group"""
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.group import Group
from ...models.server_error import ServerError
from ...types import Response
def _get_kwargs(
group_id: str,
) -> Dict[str, Any]:
_kwargs: Dict[str, Any] = {
"method": "get",
"url": "/group/{group_id}".format(
group_id=group_id,
),
}
return _kwargs
def _parse_response(
*, client: Union[AuthenticatedClient, Client], response: httpx.Response
) -> Union[Group, ServerError]:
if response.status_code == HTTPStatus.OK:
response_200 = Group.from_dict(response.json())
return response_200
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.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[Group, 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(
group_id: str,
*,
client: AuthenticatedClient,
) -> Response[Union[Group, ServerError]]:
"""Get metadata on the group
Args:
group_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[Union[Group, ServerError]]
"""
kwargs = _get_kwargs(
group_id=group_id,
)
response = client.get_httpx_client().request(
**kwargs,
)
return _build_response(client=client, response=response)
[docs]
def sync(
group_id: str,
*,
client: AuthenticatedClient,
) -> Union[Group]:
"""Get metadata on the group
Args:
group_id (str):
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[Group]
"""
response = sync_detailed(
group_id=group_id,
client=client,
)
if isinstance(response.parsed, ServerError):
raise errors.UnexpectedStatus(response.status_code, response.content)
return response.parsed
[docs]
async def asyncio_detailed(
group_id: str,
*,
client: AuthenticatedClient,
) -> Response[Union[Group, ServerError]]:
"""Get metadata on the group
Args:
group_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[Union[Group, ServerError]]
"""
kwargs = _get_kwargs(
group_id=group_id,
)
response = await client.get_async_httpx_client().request(**kwargs)
return _build_response(client=client, response=response)
[docs]
async def asyncio(
group_id: str,
*,
client: AuthenticatedClient,
) -> Union[Group]:
"""Get metadata on the group
Args:
group_id (str):
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[Group]
"""
response = await asyncio_detailed(
group_id=group_id,
client=client,
)
if isinstance(response.parsed, ServerError):
raise errors.UnexpectedStatus(response.status_code, response.content)
return response.parsed