nadeshiko-sdk 0.1.0__py3-none-any.whl

nadeshiko/api/media/segment_show_by_uuid.py

@@ -0,0 +1,193 @@
+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.segment import Segment
+from ...types import Response
+
+
+def _get_kwargs(
+    uuid: str,
+) -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/v1/media/segments/{uuid}".format(
+            uuid=quote(str(uuid), safe=""),
+        ),
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Error | Segment | None:
+    if response.status_code == 200:
+        response_200 = Segment.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 == 401:
+        response_401 = Error.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 403:
+        response_403 = Error.from_dict(response.json())
+
+        return response_403
+
+    if response.status_code == 404:
+        response_404 = Error.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 429:
+        response_429 = Error.from_dict(response.json())
+
+        return response_429
+
+    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 | Segment]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    uuid: str,
+    *,
+    client: AuthenticatedClient,
+) -> Response[Error | Segment]:
+    """Get segment by UUID
+
+     Get a specific segment by its UUID
+
+    Args:
+        uuid (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[Error | Segment]
+    """
+
+    kwargs = _get_kwargs(
+        uuid=uuid,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    uuid: str,
+    *,
+    client: AuthenticatedClient,
+) -> Error | Segment | None:
+    """Get segment by UUID
+
+     Get a specific segment by its UUID
+
+    Args:
+        uuid (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:
+        Error | Segment
+    """
+
+    return sync_detailed(
+        uuid=uuid,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    uuid: str,
+    *,
+    client: AuthenticatedClient,
+) -> Response[Error | Segment]:
+    """Get segment by UUID
+
+     Get a specific segment by its UUID
+
+    Args:
+        uuid (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[Error | Segment]
+    """
+
+    kwargs = _get_kwargs(
+        uuid=uuid,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    uuid: str,
+    *,
+    client: AuthenticatedClient,
+) -> Error | Segment | None:
+    """Get segment by UUID
+
+     Get a specific segment by its UUID
+
+    Args:
+        uuid (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:
+        Error | Segment
+    """
+
+    return (
+        await asyncio_detailed(
+            uuid=uuid,
+            client=client,
+        )
+    ).parsed

nadeshiko/api/media/seiyuu_show.py

@@ -0,0 +1,193 @@
+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.seiyuu_with_roles import SeiyuuWithRoles
+from ...types import Response
+
+
+def _get_kwargs(
+    id: int,
+) -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/v1/media/seiyuu/{id}".format(
+            id=quote(str(id), safe=""),
+        ),
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Error | SeiyuuWithRoles | None:
+    if response.status_code == 200:
+        response_200 = SeiyuuWithRoles.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 == 401:
+        response_401 = Error.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 403:
+        response_403 = Error.from_dict(response.json())
+
+        return response_403
+
+    if response.status_code == 404:
+        response_404 = Error.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 429:
+        response_429 = Error.from_dict(response.json())
+
+        return response_429
+
+    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 | SeiyuuWithRoles]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    id: int,
+    *,
+    client: AuthenticatedClient,
+) -> Response[Error | SeiyuuWithRoles]:
+    """Get seiyuu details
+
+     Returns a voice actor with all characters they voiced and media appearances.
+
+    Args:
+        id (int):  Example: 95991.
+
+    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 | SeiyuuWithRoles]
+    """
+
+    kwargs = _get_kwargs(
+        id=id,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    id: int,
+    *,
+    client: AuthenticatedClient,
+) -> Error | SeiyuuWithRoles | None:
+    """Get seiyuu details
+
+     Returns a voice actor with all characters they voiced and media appearances.
+
+    Args:
+        id (int):  Example: 95991.
+
+    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 | SeiyuuWithRoles
+    """
+
+    return sync_detailed(
+        id=id,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    id: int,
+    *,
+    client: AuthenticatedClient,
+) -> Response[Error | SeiyuuWithRoles]:
+    """Get seiyuu details
+
+     Returns a voice actor with all characters they voiced and media appearances.
+
+    Args:
+        id (int):  Example: 95991.
+
+    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 | SeiyuuWithRoles]
+    """
+
+    kwargs = _get_kwargs(
+        id=id,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    id: int,
+    *,
+    client: AuthenticatedClient,
+) -> Error | SeiyuuWithRoles | None:
+    """Get seiyuu details
+
+     Returns a voice actor with all characters they voiced and media appearances.
+
+    Args:
+        id (int):  Example: 95991.
+
+    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 | SeiyuuWithRoles
+    """
+
+    return (
+        await asyncio_detailed(
+            id=id,
+            client=client,
+        )
+    ).parsed

nadeshiko/api/search/__init__.py

@@ -0,0 +1,11 @@
+from typing import Any
+import httpx
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...types import Response
+
+from . import fetch_media_info
+from . import fetch_sentence_context
+from . import search_health_check
+from . import search_multiple
+from . import search

nadeshiko/api/search/fetch_media_info.py

@@ -0,0 +1,278 @@
+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.fetch_media_info_response import FetchMediaInfoResponse
+from ...models.fetch_media_info_type import FetchMediaInfoType
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    *,
+    size: int | Unset = 20,
+    cursor: int | Unset = 0,
+    query: str | Unset = UNSET,
+    type_: FetchMediaInfoType | Unset = UNSET,
+) -> dict[str, Any]:
+    params: dict[str, Any] = {}
+
+    params["size"] = size
+
+    params["cursor"] = cursor
+
+    params["query"] = query
+
+    json_type_: str | Unset = UNSET
+    if not isinstance(type_, Unset):
+        json_type_ = type_.value
+
+    params["type"] = json_type_
+
+    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": "/v1/search/media/info",
+        "params": params,
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Error | FetchMediaInfoResponse | None:
+    if response.status_code == 200:
+        response_200 = FetchMediaInfoResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 401:
+        response_401 = Error.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 403:
+        response_403 = Error.from_dict(response.json())
+
+        return response_403
+
+    if response.status_code == 429:
+        response_429 = Error.from_dict(response.json())
+
+        return response_429
+
+    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 | FetchMediaInfoResponse]:
+    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,
+    size: int | Unset = 20,
+    cursor: int | Unset = 0,
+    query: str | Unset = UNSET,
+    type_: FetchMediaInfoType | Unset = UNSET,
+) -> Response[Error | FetchMediaInfoResponse]:
+    """Fetch media info
+
+     Lists available media with metadata and supports filtering by type and search query.
+
+    Returns paginated results with comprehensive media information including cover/banner images,
+    episode counts, and genres.
+
+    **Use Cases**
+    - Browsing the media library
+    - Getting media metadata for display
+
+    **Requirements:**
+    - Required Scopes: `READ_MEDIA`
+
+    Args:
+        size (int | Unset):  Default: 20.
+        cursor (int | Unset):  Default: 0.
+        query (str | Unset):  Example: steins.
+        type_ (FetchMediaInfoType | Unset):  Example: anime.
+
+    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 | FetchMediaInfoResponse]
+    """
+
+    kwargs = _get_kwargs(
+        size=size,
+        cursor=cursor,
+        query=query,
+        type_=type_,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    size: int | Unset = 20,
+    cursor: int | Unset = 0,
+    query: str | Unset = UNSET,
+    type_: FetchMediaInfoType | Unset = UNSET,
+) -> Error | FetchMediaInfoResponse | None:
+    """Fetch media info
+
+     Lists available media with metadata and supports filtering by type and search query.
+
+    Returns paginated results with comprehensive media information including cover/banner images,
+    episode counts, and genres.
+
+    **Use Cases**
+    - Browsing the media library
+    - Getting media metadata for display
+
+    **Requirements:**
+    - Required Scopes: `READ_MEDIA`
+
+    Args:
+        size (int | Unset):  Default: 20.
+        cursor (int | Unset):  Default: 0.
+        query (str | Unset):  Example: steins.
+        type_ (FetchMediaInfoType | Unset):  Example: anime.
+
+    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 | FetchMediaInfoResponse
+    """
+
+    return sync_detailed(
+        client=client,
+        size=size,
+        cursor=cursor,
+        query=query,
+        type_=type_,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    size: int | Unset = 20,
+    cursor: int | Unset = 0,
+    query: str | Unset = UNSET,
+    type_: FetchMediaInfoType | Unset = UNSET,
+) -> Response[Error | FetchMediaInfoResponse]:
+    """Fetch media info
+
+     Lists available media with metadata and supports filtering by type and search query.
+
+    Returns paginated results with comprehensive media information including cover/banner images,
+    episode counts, and genres.
+
+    **Use Cases**
+    - Browsing the media library
+    - Getting media metadata for display
+
+    **Requirements:**
+    - Required Scopes: `READ_MEDIA`
+
+    Args:
+        size (int | Unset):  Default: 20.
+        cursor (int | Unset):  Default: 0.
+        query (str | Unset):  Example: steins.
+        type_ (FetchMediaInfoType | Unset):  Example: anime.
+
+    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 | FetchMediaInfoResponse]
+    """
+
+    kwargs = _get_kwargs(
+        size=size,
+        cursor=cursor,
+        query=query,
+        type_=type_,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    size: int | Unset = 20,
+    cursor: int | Unset = 0,
+    query: str | Unset = UNSET,
+    type_: FetchMediaInfoType | Unset = UNSET,
+) -> Error | FetchMediaInfoResponse | None:
+    """Fetch media info
+
+     Lists available media with metadata and supports filtering by type and search query.
+
+    Returns paginated results with comprehensive media information including cover/banner images,
+    episode counts, and genres.
+
+    **Use Cases**
+    - Browsing the media library
+    - Getting media metadata for display
+
+    **Requirements:**
+    - Required Scopes: `READ_MEDIA`
+
+    Args:
+        size (int | Unset):  Default: 20.
+        cursor (int | Unset):  Default: 0.
+        query (str | Unset):  Example: steins.
+        type_ (FetchMediaInfoType | Unset):  Example: anime.
+
+    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 | FetchMediaInfoResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            size=size,
+            cursor=cursor,
+            query=query,
+            type_=type_,
+        )
+    ).parsed