client.py

# This file was auto-generated by Fern from our API Definition.

from __future__ import annotations

import typing

from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
from ...core.request_options import RequestOptions
from ...types.annotation_ref import AnnotationRef
from ...types.doc_fonts_list200response import DocFontsList200Response
from ...types.doc_fonts_resolve200response import DocFontsResolve200Response
from ...types.font_resolve_run import FontResolveRun
from .raw_client import AsyncRawFontsClient, RawFontsClient

if typing.TYPE_CHECKING:
    from .programs.client import AsyncProgramsClient, ProgramsClient
# this is used as the default value for optional parameters
OMIT = typing.cast(typing.Any, ...)


class FontsClient:
    def __init__(self, *, client_wrapper: SyncClientWrapper):
        self._raw_client = RawFontsClient(client_wrapper=client_wrapper)
        self._client_wrapper = client_wrapper
        self._programs: typing.Optional[ProgramsClient] = None

    @property
    def with_raw_response(self) -> RawFontsClient:
        """
        Retrieves a raw implementation of this client that returns raw responses.

        Returns
        -------
        RawFontsClient
        """
        return self._raw_client

    def list(
        self,
        doc_id: str,
        layer_name: str,
        *,
        document_password: typing.Optional[str] = None,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> DocFontsList200Response:
        """
        Parameters
        ----------
        doc_id : str

        layer_name : str

        document_password : typing.Optional[str]
            Base64-encoded password for an encrypted document. Valid only with the API token (403 anywhere else). An encrypted document answers 422 DocPasswordRequired when the header is absent. Viewer doc JWTs use the SDK password-session flow instead.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        DocFontsList200Response
            OK

        Examples
        --------
        from cloudpdf import CloudPDFClient

        client = CloudPDFClient(
            token="YOUR_TOKEN",
        )
        client.doc.fonts.list(
            doc_id="docId",
            layer_name="layerName",
        )
        """
        _response = self._raw_client.list(
            doc_id, layer_name, document_password=document_password, request_options=request_options
        )
        return _response.data

    def resolve(
        self,
        doc_id: str,
        layer_name: str,
        *,
        runs: typing.Sequence[FontResolveRun],
        document_password: typing.Optional[str] = None,
        annotation: typing.Optional[AnnotationRef] = OMIT,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> DocFontsResolve200Response:
        """
        Parameters
        ----------
        doc_id : str

        layer_name : str

        runs : typing.Sequence[FontResolveRun]

        document_password : typing.Optional[str]
            Base64-encoded password for an encrypted document. Valid only with the API token (403 anywhere else). An encrypted document answers 422 DocPasswordRequired when the header is absent. Viewer doc JWTs use the SDK password-session flow instead.

        annotation : typing.Optional[AnnotationRef]

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        DocFontsResolve200Response
            OK

        Examples
        --------
        from cloudpdf import CloudPDFClient, FontResolveRun

        client = CloudPDFClient(
            token="YOUR_TOKEN",
        )
        client.doc.fonts.resolve(
            doc_id="docId",
            layer_name="layerName",
            runs=[
                FontResolveRun(
                    text="text",
                )
            ],
        )
        """
        _response = self._raw_client.resolve(
            doc_id,
            layer_name,
            runs=runs,
            document_password=document_password,
            annotation=annotation,
            request_options=request_options,
        )
        return _response.data

    @property
    def programs(self):
        if self._programs is None:
            from .programs.client import ProgramsClient  # noqa: E402

            self._programs = ProgramsClient(client_wrapper=self._client_wrapper)
        return self._programs


class AsyncFontsClient:
    def __init__(self, *, client_wrapper: AsyncClientWrapper):
        self._raw_client = AsyncRawFontsClient(client_wrapper=client_wrapper)
        self._client_wrapper = client_wrapper
        self._programs: typing.Optional[AsyncProgramsClient] = None

    @property
    def with_raw_response(self) -> AsyncRawFontsClient:
        """
        Retrieves a raw implementation of this client that returns raw responses.

        Returns
        -------
        AsyncRawFontsClient
        """
        return self._raw_client

    async def list(
        self,
        doc_id: str,
        layer_name: str,
        *,
        document_password: typing.Optional[str] = None,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> DocFontsList200Response:
        """
        Parameters
        ----------
        doc_id : str

        layer_name : str

        document_password : typing.Optional[str]
            Base64-encoded password for an encrypted document. Valid only with the API token (403 anywhere else). An encrypted document answers 422 DocPasswordRequired when the header is absent. Viewer doc JWTs use the SDK password-session flow instead.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        DocFontsList200Response
            OK

        Examples
        --------
        import asyncio

        from cloudpdf import AsyncCloudPDFClient

        client = AsyncCloudPDFClient(
            token="YOUR_TOKEN",
        )


        async def main() -> None:
            await client.doc.fonts.list(
                doc_id="docId",
                layer_name="layerName",
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.list(
            doc_id, layer_name, document_password=document_password, request_options=request_options
        )
        return _response.data

    async def resolve(
        self,
        doc_id: str,
        layer_name: str,
        *,
        runs: typing.Sequence[FontResolveRun],
        document_password: typing.Optional[str] = None,
        annotation: typing.Optional[AnnotationRef] = OMIT,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> DocFontsResolve200Response:
        """
        Parameters
        ----------
        doc_id : str

        layer_name : str

        runs : typing.Sequence[FontResolveRun]

        document_password : typing.Optional[str]
            Base64-encoded password for an encrypted document. Valid only with the API token (403 anywhere else). An encrypted document answers 422 DocPasswordRequired when the header is absent. Viewer doc JWTs use the SDK password-session flow instead.

        annotation : typing.Optional[AnnotationRef]

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        DocFontsResolve200Response
            OK

        Examples
        --------
        import asyncio

        from cloudpdf import AsyncCloudPDFClient, FontResolveRun

        client = AsyncCloudPDFClient(
            token="YOUR_TOKEN",
        )


        async def main() -> None:
            await client.doc.fonts.resolve(
                doc_id="docId",
                layer_name="layerName",
                runs=[
                    FontResolveRun(
                        text="text",
                    )
                ],
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.resolve(
            doc_id,
            layer_name,
            runs=runs,
            document_password=document_password,
            annotation=annotation,
            request_options=request_options,
        )
        return _response.data

    @property
    def programs(self):
        if self._programs is None:
            from .programs.client import AsyncProgramsClient  # noqa: E402

            self._programs = AsyncProgramsClient(client_wrapper=self._client_wrapper)
        return self._programs