sarvamai 0.1.23a7__tar.gz → 0.1.23a8__tar.gz

{sarvamai-0.1.23a7 → sarvamai-0.1.23a8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sarvamai
-Version: 0.1.23a7
+Version: 0.1.23a8
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers

{sarvamai-0.1.23a7 → sarvamai-0.1.23a8}/pyproject.toml

@@ -3,7 +3,7 @@ name = "sarvamai"
 
 [tool.poetry]
 name = "sarvamai"
-version = "0.1.23a7"
+version = "0.1.23a8"
 description = ""
 readme = "README.md"
 authors = []

{sarvamai-0.1.23a7 → sarvamai-0.1.23a8}/src/sarvamai/core/client_wrapper.py

@@ -23,10 +23,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "sarvamai/0.1.23a7",
+            "User-Agent": "sarvamai/0.1.23a8",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "sarvamai",
-            "X-Fern-SDK-Version": "0.1.23a7",
+            "X-Fern-SDK-Version": "0.1.23a8",
             **(self.get_custom_headers() or {}),
         }
         headers["api-subscription-key"] = self.api_subscription_key

{sarvamai-0.1.23a7 → sarvamai-0.1.23a8}/src/sarvamai/doc_digitization_job/client.py

@@ -1,16 +1,32 @@
 # This file was auto-generated by Fern from our API Definition.
+# This file was auto-generated by Fern from our API Definition.
 
 import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
-from ..requests.doc_digitization_job_parameters import DocDigitizationJobParametersParams
-from ..requests.doc_digitization_webhook_callback import DocDigitizationWebhookCallbackParams
-from ..types.doc_digitization_create_job_response import DocDigitizationCreateJobResponse
-from ..types.doc_digitization_download_files_response import DocDigitizationDownloadFilesResponse
-from ..types.doc_digitization_job_status_response import DocDigitizationJobStatusResponse
-from ..types.doc_digitization_upload_files_response import DocDigitizationUploadFilesResponse
+from ..requests.doc_digitization_job_parameters import (
+    DocDigitizationJobParametersParams,
+)
+from ..requests.doc_digitization_webhook_callback import (
+    DocDigitizationWebhookCallbackParams,
+)
+from ..types.doc_digitization_create_job_response import (
+    DocDigitizationCreateJobResponse,
+)
+from ..types.doc_digitization_download_files_response import (
+    DocDigitizationDownloadFilesResponse,
+)
+from ..types.doc_digitization_job_status_response import (
+    DocDigitizationJobStatusResponse,
+)
+from ..types.doc_digitization_upload_files_response import (
+    DocDigitizationUploadFilesResponse,
+)
+from ..types.doc_digitization_supported_language import DocDigitizationSupportedLanguage
+from ..types.doc_digitization_output_format import DocDigitizationOutputFormat
 from .raw_client import AsyncRawDocDigitizationJobClient, RawDocDigitizationJobClient
+from .job import DocDigitizationJob, AsyncDocDigitizationJob
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -99,12 +115,18 @@ class DocDigitizationJobClient:
         client.doc_digitization_job.initialise()
         """
         _response = self._raw_client.initialise(
-            job_parameters=job_parameters, callback=callback, request_options=request_options
+            job_parameters=job_parameters,
+            callback=callback,
+            request_options=request_options,
         )
         return _response.data
 
     def get_upload_links(
-        self, *, job_id: str, files: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
+        self,
+        *,
+        job_id: str,
+        files: typing.Sequence[str],
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> DocDigitizationUploadFilesResponse:
         """
         Returns presigned URLs for uploading input files.
@@ -142,7 +164,9 @@ class DocDigitizationJobClient:
             files=["files"],
         )
         """
-        _response = self._raw_client.get_upload_links(job_id=job_id, files=files, request_options=request_options)
+        _response = self._raw_client.get_upload_links(
+            job_id=job_id, files=files, request_options=request_options
+        )
         return _response.data
 
     def start(
@@ -269,13 +293,97 @@ class DocDigitizationJobClient:
             job_id="job_id",
         )
         """
-        _response = self._raw_client.get_download_links(job_id, request_options=request_options)
+        _response = self._raw_client.get_download_links(
+            job_id, request_options=request_options
+        )
         return _response.data
 
+    def create_job(
+        self,
+        language: DocDigitizationSupportedLanguage = "hi",
+        output_format: DocDigitizationOutputFormat = "html",
+        callback: typing.Optional[DocDigitizationWebhookCallbackParams] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DocDigitizationJob:
+        """
+        Create a new Document Digitization job.
+
+        Parameters
+        ----------
+        language : DocDigitizationSupportedLanguage, default="hi"
+            ISO language code for the document.
+
+        output_format : DocDigitizationOutputFormat, default="html"
+            Output format: "html" for structured HTML or "md" for Markdown.
+
+        callback : typing.Optional[DocDigitizationWebhookCallbackParams], default=OMIT
+            Optional webhook configuration for job completion notification.
+
+        request_options : typing.Optional[RequestOptions], default=None
+            Request-specific configuration.
+
+        Returns
+        -------
+        DocDigitizationJob
+            A handle to the newly created Document Digitization job.
+
+        Examples
+        --------
+        from sarvamai import SarvamAI
+
+        client = SarvamAI(api_subscription_key="YOUR_API_SUBSCRIPTION_KEY")
+
+        # Create job and get handle
+        job = client.doc_digitization_job.create_job(language="hi", output_format="md")
+
+        # Upload PDF, start, wait, download
+        job.upload_file("/path/to/document.pdf")
+        job.start()
+        job.wait_until_complete()
+        job.download_output("./output.md")
+        """
+        response = self.initialise(
+            job_parameters=DocDigitizationJobParametersParams(
+                language=language,
+                output_format=output_format,
+            ),
+            callback=callback,
+            request_options=request_options,
+        )
+        return DocDigitizationJob(job_id=response.job_id, client=self)
+
+    def get_job(self, job_id: str) -> DocDigitizationJob:
+        """
+        Get an existing Document Digitization job handle by job ID.
+
+        Parameters
+        ----------
+        job_id : str
+            The job ID of a previously created Document Digitization job.
+
+        Returns
+        -------
+        DocDigitizationJob
+            A job handle which can be used to check status, upload files, or download results.
+
+        Examples
+        --------
+        from sarvamai import SarvamAI
+
+        client = SarvamAI(api_subscription_key="YOUR_API_SUBSCRIPTION_KEY")
+
+        # Get existing job
+        job = client.doc_digitization_job.get_job(job_id="your-job-uuid")
+        status = job.get_status()
+        """
+        return DocDigitizationJob(job_id=job_id, client=self)
+
 
 class AsyncDocDigitizationJobClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._raw_client = AsyncRawDocDigitizationJobClient(client_wrapper=client_wrapper)
+        self._raw_client = AsyncRawDocDigitizationJobClient(
+            client_wrapper=client_wrapper
+        )
 
     @property
     def with_raw_response(self) -> AsyncRawDocDigitizationJobClient:
@@ -364,12 +472,18 @@ class AsyncDocDigitizationJobClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.initialise(
-            job_parameters=job_parameters, callback=callback, request_options=request_options
+            job_parameters=job_parameters,
+            callback=callback,
+            request_options=request_options,
         )
         return _response.data
 
     async def get_upload_links(
-        self, *, job_id: str, files: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
+        self,
+        *,
+        job_id: str,
+        files: typing.Sequence[str],
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> DocDigitizationUploadFilesResponse:
         """
         Returns presigned URLs for uploading input files.
@@ -415,7 +529,9 @@ class AsyncDocDigitizationJobClient:
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.get_upload_links(job_id=job_id, files=files, request_options=request_options)
+        _response = await self._raw_client.get_upload_links(
+            job_id=job_id, files=files, request_options=request_options
+        )
         return _response.data
 
     async def start(
@@ -469,7 +585,9 @@ class AsyncDocDigitizationJobClient:
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.start(job_id, request_options=request_options)
+        _response = await self._raw_client.start(
+            job_id, request_options=request_options
+        )
         return _response.data
 
     async def get_status(
@@ -521,7 +639,9 @@ class AsyncDocDigitizationJobClient:
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.get_status(job_id, request_options=request_options)
+        _response = await self._raw_client.get_status(
+            job_id, request_options=request_options
+        )
         return _response.data
 
     async def get_download_links(
@@ -566,5 +686,91 @@ class AsyncDocDigitizationJobClient:
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.get_download_links(job_id, request_options=request_options)
+        _response = await self._raw_client.get_download_links(
+            job_id, request_options=request_options
+        )
         return _response.data
+
+    async def create_job(
+        self,
+        language: DocDigitizationSupportedLanguage = "hi",
+        output_format: DocDigitizationOutputFormat = "html",
+        callback: typing.Optional[DocDigitizationWebhookCallbackParams] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncDocDigitizationJob:
+        """
+        Create a new Document Digitization job.
+
+        Parameters
+        ----------
+        language : DocDigitizationSupportedLanguage, default="hi"
+            ISO language code for the document.
+
+        output_format : DocDigitizationOutputFormat, default="html"
+            Output format: "html" for structured HTML or "md" for Markdown.
+
+        callback : typing.Optional[DocDigitizationWebhookCallbackParams], default=OMIT
+            Optional webhook configuration for job completion notification.
+
+        request_options : typing.Optional[RequestOptions], default=None
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncDocDigitizationJob
+            A handle to the newly created Document Digitization job.
+
+        Examples
+        --------
+        import asyncio
+        from sarvamai import AsyncSarvamAI
+
+        client = AsyncSarvamAI(api_subscription_key="YOUR_API_SUBSCRIPTION_KEY")
+
+        async def main():
+            job = await client.doc_digitization_job.create_job(language="hi", output_format="md")
+            await job.upload_file("/path/to/document.pdf")
+            await job.start()
+            await job.wait_until_complete()
+            await job.download_output("./output.md")
+
+        asyncio.run(main())
+        """
+        response = await self.initialise(
+            job_parameters=DocDigitizationJobParametersParams(
+                language=language,
+                output_format=output_format,
+            ),
+            callback=callback,
+            request_options=request_options,
+        )
+        return AsyncDocDigitizationJob(job_id=response.job_id, client=self)
+
+    def get_job(self, job_id: str) -> AsyncDocDigitizationJob:
+        """
+        Get an existing Document Digitization job handle by job ID.
+
+        Parameters
+        ----------
+        job_id : str
+            The job ID of a previously created Document Digitization job.
+
+        Returns
+        -------
+        AsyncDocDigitizationJob
+            A job handle which can be used to check status, upload files, or download results.
+
+        Examples
+        --------
+        import asyncio
+        from sarvamai import AsyncSarvamAI
+
+        client = AsyncSarvamAI(api_subscription_key="YOUR_API_SUBSCRIPTION_KEY")
+
+        async def main():
+            job = client.doc_digitization_job.get_job(job_id="your-job-uuid")
+            status = await job.get_status()
+
+        asyncio.run(main())
+        """
+        return AsyncDocDigitizationJob(job_id=job_id, client=self)