studyfetch-sdk 0.1.0a17__py3-none-any.whl → 0.1.0a19__py3-none-any.whl

studyfetch_sdk/resources/v1/materials/materials.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import List
+from typing import List, Iterable, Optional
 
 import httpx
 
@@ -35,9 +35,13 @@ from ...._utils import maybe_transform, async_maybe_transform
 from ...._compat import cached_property
 from ....types.v1 import (
     material_list_params,
+    material_move_params,
     material_create_params,
+    material_rename_params,
     material_search_params,
+    material_batch_create_params,
     material_get_download_url_params,
+    material_create_and_process_params,
 )
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
@@ -48,7 +52,12 @@ from ...._response import (
 )
 from ...._base_client import make_request_options
 from ....types.v1.material import Material
+from ....types.v1.content_param import ContentParam
 from ....types.v1.material_list_response import MaterialListResponse
+from ....types.v1.material_debug_response import MaterialDebugResponse
+from ....types.v1.material_search_response import MaterialSearchResponse
+from ....types.v1.material_batch_create_response import MaterialBatchCreateResponse
+from ....types.v1.material_get_download_url_response import MaterialGetDownloadURLResponse
 
 __all__ = ["MaterialsResource", "AsyncMaterialsResource"]
 
@@ -88,7 +97,7 @@ class MaterialsResource(SyncAPIResource):
     def create(
         self,
         *,
-        content: material_create_params.Content,
+        content: ContentParam,
         name: str,
         folder_id: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -239,20 +248,92 @@ class MaterialsResource(SyncAPIResource):
     def batch_create(
         self,
         *,
+        materials: Iterable[material_batch_create_params.Material],
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> MaterialBatchCreateResponse:
+        """
+        Create batch upload URLs for multiple materials
+
+        Args:
+          materials: Array of materials to create
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
         return self._post(
             "/api/v1/materials/batch",
+            body=maybe_transform({"materials": materials}, material_batch_create_params.MaterialBatchCreateParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=MaterialBatchCreateResponse,
+        )
+
+    def create_and_process(
+        self,
+        *,
+        content: ContentParam,
+        name: str,
+        folder_id: str | NotGiven = NOT_GIVEN,
+        poll_interval_ms: float | NotGiven = NOT_GIVEN,
+        timeout_ms: float | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Material:
+        """Creates a material and waits for processing to finish before returning.
+
+        Useful
+        for synchronous API usage.
+
+        Args:
+          content: Content details
+
+          name: Name of the material
+
+          folder_id: Folder ID to place the material in
+
+          poll_interval_ms: Polling interval in milliseconds (default: 2 seconds)
+
+          timeout_ms: Maximum time to wait for processing in milliseconds (default: 5 minutes)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/api/v1/materials/upload-and-process",
+            body=maybe_transform(
+                {
+                    "content": content,
+                    "name": name,
+                    "folder_id": folder_id,
+                    "poll_interval_ms": poll_interval_ms,
+                    "timeout_ms": timeout_ms,
+                },
+                material_create_and_process_params.MaterialCreateAndProcessParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Material,
         )
 
     def debug(
@@ -265,8 +346,10 @@ class MaterialsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> MaterialDebugResponse:
         """
+        Get debug information for a material including extracted content
+
         Args:
           extra_headers: Send extra headers
 
@@ -278,29 +361,32 @@ class MaterialsResource(SyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._get(
             f"/api/v1/materials/{id}/debug",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=MaterialDebugResponse,
         )
 
     def get_download_url(
         self,
         id: str,
         *,
-        expires_in: str,
+        expires_in: float | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> MaterialGetDownloadURLResponse:
         """
+        Get temporary download URL for material
+
         Args:
+          expires_in: URL expiration time in seconds (default: 3600)
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -311,7 +397,6 @@ class MaterialsResource(SyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._get(
             f"/api/v1/materials/{id}/download-url",
             options=make_request_options(
@@ -323,22 +408,27 @@ class MaterialsResource(SyncAPIResource):
                     {"expires_in": expires_in}, material_get_download_url_params.MaterialGetDownloadURLParams
                 ),
             ),
-            cast_to=NoneType,
+            cast_to=MaterialGetDownloadURLResponse,
         )
 
     def move(
         self,
         id: str,
         *,
+        folder_id: Optional[str],
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> Material:
         """
+        Move material to a different folder
+
         Args:
+          folder_id: Target folder ID (null for root)
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -349,28 +439,33 @@ class MaterialsResource(SyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
             f"/api/v1/materials/{id}/move",
+            body=maybe_transform({"folder_id": folder_id}, material_move_params.MaterialMoveParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=Material,
         )
 
     def rename(
         self,
         id: str,
         *,
+        name: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> Material:
         """
+        Rename a material
+
         Args:
+          name: New name for the material
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -381,13 +476,13 @@ class MaterialsResource(SyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
             f"/api/v1/materials/{id}/rename",
+            body=maybe_transform({"name": name}, material_rename_params.MaterialRenameParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=Material,
         )
 
     def reprocess(
@@ -400,8 +495,10 @@ class MaterialsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> Material:
         """
+        Reprocess material to regenerate embeddings and extract content
+
         Args:
           extra_headers: Send extra headers
 
@@ -413,13 +510,12 @@ class MaterialsResource(SyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
             f"/api/v1/materials/{id}/reprocess",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=Material,
         )
 
     def search(
@@ -435,19 +531,18 @@ class MaterialsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> MaterialSearchResponse:
         """
-        Search materials using RAG
+        Search materials using RAG (Retrieval-Augmented Generation)
 
         Args:
           query: Search query
 
-          folder_ids: Optional: Limit search to materials within specific folders (includes
-              subfolders)
+          folder_ids: Limit search to materials within specific folders (includes subfolders)
 
-          material_ids: Optional: Limit search to specific material IDs
+          material_ids: Limit search to specific material IDs
 
-          top_k: Number of results to return (default: 5)
+          top_k: Number of results to return
 
           extra_headers: Send extra headers
 
@@ -457,7 +552,6 @@ class MaterialsResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
             "/api/v1/materials/search",
             body=maybe_transform(
@@ -472,7 +566,7 @@ class MaterialsResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=MaterialSearchResponse,
         )
 
 
@@ -511,7 +605,7 @@ class AsyncMaterialsResource(AsyncAPIResource):
     async def create(
         self,
         *,
-        content: material_create_params.Content,
+        content: ContentParam,
         name: str,
         folder_id: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -662,20 +756,94 @@ class AsyncMaterialsResource(AsyncAPIResource):
     async def batch_create(
         self,
         *,
+        materials: Iterable[material_batch_create_params.Material],
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> MaterialBatchCreateResponse:
+        """
+        Create batch upload URLs for multiple materials
+
+        Args:
+          materials: Array of materials to create
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
         return await self._post(
             "/api/v1/materials/batch",
+            body=await async_maybe_transform(
+                {"materials": materials}, material_batch_create_params.MaterialBatchCreateParams
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=MaterialBatchCreateResponse,
+        )
+
+    async def create_and_process(
+        self,
+        *,
+        content: ContentParam,
+        name: str,
+        folder_id: str | NotGiven = NOT_GIVEN,
+        poll_interval_ms: float | NotGiven = NOT_GIVEN,
+        timeout_ms: float | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Material:
+        """Creates a material and waits for processing to finish before returning.
+
+        Useful
+        for synchronous API usage.
+
+        Args:
+          content: Content details
+
+          name: Name of the material
+
+          folder_id: Folder ID to place the material in
+
+          poll_interval_ms: Polling interval in milliseconds (default: 2 seconds)
+
+          timeout_ms: Maximum time to wait for processing in milliseconds (default: 5 minutes)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/api/v1/materials/upload-and-process",
+            body=await async_maybe_transform(
+                {
+                    "content": content,
+                    "name": name,
+                    "folder_id": folder_id,
+                    "poll_interval_ms": poll_interval_ms,
+                    "timeout_ms": timeout_ms,
+                },
+                material_create_and_process_params.MaterialCreateAndProcessParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Material,
         )
 
     async def debug(
@@ -688,8 +856,10 @@ class AsyncMaterialsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> MaterialDebugResponse:
         """
+        Get debug information for a material including extracted content
+
         Args:
           extra_headers: Send extra headers
 
@@ -701,29 +871,32 @@ class AsyncMaterialsResource(AsyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._get(
             f"/api/v1/materials/{id}/debug",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=MaterialDebugResponse,
         )
 
     async def get_download_url(
         self,
         id: str,
         *,
-        expires_in: str,
+        expires_in: float | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> MaterialGetDownloadURLResponse:
         """
+        Get temporary download URL for material
+
         Args:
+          expires_in: URL expiration time in seconds (default: 3600)
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -734,7 +907,6 @@ class AsyncMaterialsResource(AsyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._get(
             f"/api/v1/materials/{id}/download-url",
             options=make_request_options(
@@ -746,22 +918,27 @@ class AsyncMaterialsResource(AsyncAPIResource):
                     {"expires_in": expires_in}, material_get_download_url_params.MaterialGetDownloadURLParams
                 ),
             ),
-            cast_to=NoneType,
+            cast_to=MaterialGetDownloadURLResponse,
         )
 
     async def move(
         self,
         id: str,
         *,
+        folder_id: Optional[str],
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> Material:
         """
+        Move material to a different folder
+
         Args:
+          folder_id: Target folder ID (null for root)
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -772,28 +949,33 @@ class AsyncMaterialsResource(AsyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
             f"/api/v1/materials/{id}/move",
+            body=await async_maybe_transform({"folder_id": folder_id}, material_move_params.MaterialMoveParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=Material,
         )
 
     async def rename(
         self,
         id: str,
         *,
+        name: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> Material:
         """
+        Rename a material
+
         Args:
+          name: New name for the material
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -804,13 +986,13 @@ class AsyncMaterialsResource(AsyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
             f"/api/v1/materials/{id}/rename",
+            body=await async_maybe_transform({"name": name}, material_rename_params.MaterialRenameParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=Material,
         )
 
     async def reprocess(
@@ -823,8 +1005,10 @@ class AsyncMaterialsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> Material:
         """
+        Reprocess material to regenerate embeddings and extract content
+
         Args:
           extra_headers: Send extra headers
 
@@ -836,13 +1020,12 @@ class AsyncMaterialsResource(AsyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
             f"/api/v1/materials/{id}/reprocess",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=Material,
         )
 
     async def search(
@@ -858,19 +1041,18 @@ class AsyncMaterialsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> MaterialSearchResponse:
         """
-        Search materials using RAG
+        Search materials using RAG (Retrieval-Augmented Generation)
 
         Args:
           query: Search query
 
-          folder_ids: Optional: Limit search to materials within specific folders (includes
-              subfolders)
+          folder_ids: Limit search to materials within specific folders (includes subfolders)
 
-          material_ids: Optional: Limit search to specific material IDs
+          material_ids: Limit search to specific material IDs
 
-          top_k: Number of results to return (default: 5)
+          top_k: Number of results to return
 
           extra_headers: Send extra headers
 
@@ -880,7 +1062,6 @@ class AsyncMaterialsResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
             "/api/v1/materials/search",
             body=await async_maybe_transform(
@@ -895,7 +1076,7 @@ class AsyncMaterialsResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=MaterialSearchResponse,
         )
 
 
@@ -918,6 +1099,9 @@ class MaterialsResourceWithRawResponse:
         self.batch_create = to_raw_response_wrapper(
             materials.batch_create,
         )
+        self.create_and_process = to_raw_response_wrapper(
+            materials.create_and_process,
+        )
         self.debug = to_raw_response_wrapper(
             materials.debug,
         )
@@ -969,6 +1153,9 @@ class AsyncMaterialsResourceWithRawResponse:
         self.batch_create = async_to_raw_response_wrapper(
             materials.batch_create,
         )
+        self.create_and_process = async_to_raw_response_wrapper(
+            materials.create_and_process,
+        )
         self.debug = async_to_raw_response_wrapper(
             materials.debug,
         )
@@ -1020,6 +1207,9 @@ class MaterialsResourceWithStreamingResponse:
         self.batch_create = to_streamed_response_wrapper(
             materials.batch_create,
         )
+        self.create_and_process = to_streamed_response_wrapper(
+            materials.create_and_process,
+        )
         self.debug = to_streamed_response_wrapper(
             materials.debug,
         )
@@ -1071,6 +1261,9 @@ class AsyncMaterialsResourceWithStreamingResponse:
         self.batch_create = async_to_streamed_response_wrapper(
             materials.batch_create,
         )
+        self.create_and_process = async_to_streamed_response_wrapper(
+            materials.create_and_process,
+        )
         self.debug = async_to_streamed_response_wrapper(
             materials.debug,
         )