cribl-control-plane 0.0.20__py3-none-any.whl → 0.0.21a2__py3-none-any.whl

cribl_control_plane/_version.py

@@ -3,10 +3,10 @@
 import importlib.metadata
 
 __title__: str = "cribl-control-plane"
-__version__: str = "0.0.20"
+__version__: str = "0.0.21a2"
 __openapi_doc_version__: str = "4.14.0-alpha.1753968519625-08e89eb4"
 __gen_version__: str = "2.660.0"
-__user_agent__: str = "speakeasy-sdk/python 0.0.20 2.660.0 4.14.0-alpha.1753968519625-08e89eb4 cribl-control-plane"
+__user_agent__: str = "speakeasy-sdk/python 0.0.21a2 2.660.0 4.14.0-alpha.1753968519625-08e89eb4 cribl-control-plane"
 
 try:
     if __package__ is not None:

cribl_control_plane/models/__init__.py

@@ -4748,7 +4748,11 @@ if TYPE_CHECKING:
         UpdatePacksByIDResponseTypedDict,
     )
     from .updatepacksop import (
+        UpdatePacksFile,
+        UpdatePacksFileTypedDict,
         UpdatePacksRequest,
+        UpdatePacksRequestBody,
+        UpdatePacksRequestBodyTypedDict,
         UpdatePacksRequestTypedDict,
         UpdatePacksResponse,
         UpdatePacksResponseTypedDict,
@@ -9165,7 +9169,11 @@ __all__ = [
     "UpdatePacksByIDRequestTypedDict",
     "UpdatePacksByIDResponse",
     "UpdatePacksByIDResponseTypedDict",
+    "UpdatePacksFile",
+    "UpdatePacksFileTypedDict",
     "UpdatePacksRequest",
+    "UpdatePacksRequestBody",
+    "UpdatePacksRequestBodyTypedDict",
     "UpdatePacksRequestTypedDict",
     "UpdatePacksResponse",
     "UpdatePacksResponseTypedDict",
@@ -13584,7 +13592,11 @@ _dynamic_imports: dict[str, str] = {
     "UpdatePacksByIDRequestTypedDict": ".updatepacksbyidop",
     "UpdatePacksByIDResponse": ".updatepacksbyidop",
     "UpdatePacksByIDResponseTypedDict": ".updatepacksbyidop",
+    "UpdatePacksFile": ".updatepacksop",
+    "UpdatePacksFileTypedDict": ".updatepacksop",
     "UpdatePacksRequest": ".updatepacksop",
+    "UpdatePacksRequestBody": ".updatepacksop",
+    "UpdatePacksRequestBodyTypedDict": ".updatepacksop",
     "UpdatePacksRequestTypedDict": ".updatepacksop",
     "UpdatePacksResponse": ".updatepacksop",
     "UpdatePacksResponseTypedDict": ".updatepacksop",

cribl_control_plane/models/updatepacksop.py

@@ -2,23 +2,84 @@
 
 from __future__ import annotations
 from cribl_control_plane.types import BaseModel
-from cribl_control_plane.utils import FieldMetadata, QueryParamMetadata
-from typing import Any, Dict, List, Optional
+from cribl_control_plane.utils import (
+    FieldMetadata,
+    MultipartFormMetadata,
+    QueryParamMetadata,
+    RequestMetadata,
+)
+import io
+import pydantic
+from typing import Any, Dict, IO, List, Optional, Union
 from typing_extensions import Annotated, NotRequired, TypedDict
 
 
+class UpdatePacksFileTypedDict(TypedDict):
+    file_name: str
+    content: Union[bytes, IO[bytes], io.BufferedReader]
+    content_type: NotRequired[str]
+
+
+class UpdatePacksFile(BaseModel):
+    file_name: Annotated[
+        str, pydantic.Field(alias="fileName"), FieldMetadata(multipart=True)
+    ]
+
+    content: Annotated[
+        Union[bytes, IO[bytes], io.BufferedReader],
+        pydantic.Field(alias=""),
+        FieldMetadata(multipart=MultipartFormMetadata(content=True)),
+    ]
+
+    content_type: Annotated[
+        Optional[str],
+        pydantic.Field(alias="Content-Type"),
+        FieldMetadata(multipart=True),
+    ] = None
+
+
+class UpdatePacksRequestBodyTypedDict(TypedDict):
+    r"""multipart upload of the pack file"""
+
+    file: UpdatePacksFileTypedDict
+    r"""The pack file to upload"""
+
+
+class UpdatePacksRequestBody(BaseModel):
+    r"""multipart upload of the pack file"""
+
+    file: Annotated[
+        UpdatePacksFile, FieldMetadata(multipart=MultipartFormMetadata(file=True))
+    ]
+    r"""The pack file to upload"""
+
+
 class UpdatePacksRequestTypedDict(TypedDict):
-    filename: NotRequired[str]
+    filename: str
     r"""the file to upload"""
+    size: int
+    r"""Size of the pack file in bytes"""
+    request_body: UpdatePacksRequestBodyTypedDict
+    r"""multipart upload of the pack file"""
 
 
 class UpdatePacksRequest(BaseModel):
     filename: Annotated[
-        Optional[str],
-        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
-    ] = None
+        str, FieldMetadata(query=QueryParamMetadata(style="form", explode=True))
+    ]
     r"""the file to upload"""
 
+    size: Annotated[
+        int, FieldMetadata(query=QueryParamMetadata(style="form", explode=True))
+    ]
+    r"""Size of the pack file in bytes"""
+
+    request_body: Annotated[
+        UpdatePacksRequestBody,
+        FieldMetadata(request=RequestMetadata(media_type="multipart/form-data")),
+    ]
+    r"""multipart upload of the pack file"""
+
 
 class UpdatePacksResponseTypedDict(TypedDict):
     r"""a list of any objects"""

cribl_control_plane/packs.py

@@ -451,7 +451,9 @@ class Packs(BaseSDK):
     def update_packs(
         self,
         *,
-        filename: Optional[str] = None,
+        filename: str,
+        size: int,
+        file: Union[models.UpdatePacksFile, models.UpdatePacksFileTypedDict],
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -462,6 +464,8 @@ class Packs(BaseSDK):
         Upload Pack
 
         :param filename: the file to upload
+        :param size: Size of the pack file in bytes
+        :param file: The pack file to upload
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -479,6 +483,10 @@ class Packs(BaseSDK):
 
         request = models.UpdatePacksRequest(
             filename=filename,
+            size=size,
+            request_body=models.UpdatePacksRequestBody(
+                file=utils.get_pydantic_model(file, models.UpdatePacksFile),
+            ),
         )
 
         req = self._build_request(
@@ -487,13 +495,20 @@ class Packs(BaseSDK):
             base_url=base_url,
             url_variables=url_variables,
             request=request,
-            request_body_required=False,
+            request_body_required=True,
             request_has_path_params=False,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
             security=self.sdk_configuration.security,
+            get_serialized_body=lambda: utils.serialize_request_body(
+                request.request_body,
+                False,
+                False,
+                "multipart",
+                models.UpdatePacksRequestBody,
+            ),
             timeout_ms=timeout_ms,
         )
 
@@ -538,7 +553,9 @@ class Packs(BaseSDK):
     async def update_packs_async(
         self,
         *,
-        filename: Optional[str] = None,
+        filename: str,
+        size: int,
+        file: Union[models.UpdatePacksFile, models.UpdatePacksFileTypedDict],
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -549,6 +566,8 @@ class Packs(BaseSDK):
         Upload Pack
 
         :param filename: the file to upload
+        :param size: Size of the pack file in bytes
+        :param file: The pack file to upload
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -566,6 +585,10 @@ class Packs(BaseSDK):
 
         request = models.UpdatePacksRequest(
             filename=filename,
+            size=size,
+            request_body=models.UpdatePacksRequestBody(
+                file=utils.get_pydantic_model(file, models.UpdatePacksFile),
+            ),
         )
 
         req = self._build_request_async(
@@ -574,13 +597,20 @@ class Packs(BaseSDK):
             base_url=base_url,
             url_variables=url_variables,
             request=request,
-            request_body_required=False,
+            request_body_required=True,
             request_has_path_params=False,
             request_has_query_params=True,
             user_agent_header="user-agent",
             accept_header_value="application/json",
             http_headers=http_headers,
             security=self.sdk_configuration.security,
+            get_serialized_body=lambda: utils.serialize_request_body(
+                request.request_body,
+                False,
+                False,
+                "multipart",
+                models.UpdatePacksRequestBody,
+            ),
             timeout_ms=timeout_ms,
         )
 

{cribl_control_plane-0.0.20.dist-info → cribl_control_plane-0.0.21a2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: cribl-control-plane
-Version: 0.0.20
+Version: 0.0.21a2
 Summary: Python Client SDK Generated by Speakeasy.
 Author: Speakeasy
 Requires-Python: >=3.9.2
@@ -31,6 +31,7 @@ Cribl API Reference: This API Reference lists available REST endpoints, along wi
   * [SDK Example Usage](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#sdk-example-usage)
   * [Authentication](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#authentication)
   * [Available Resources and Operations](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#available-resources-and-operations)
+  * [File uploads](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#file-uploads)
   * [Retries](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#retries)
   * [Error Handling](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#error-handling)
   * [Custom HTTP Client](https://github.com/criblio/cribl_control_plane_sdk_python/blob/master/#custom-http-client)
@@ -301,6 +302,39 @@ with CriblControlPlane(
 </details>
 <!-- End Available Resources and Operations [operations] -->
 
+<!-- Start File uploads [file-upload] -->
+## File uploads
+
+Certain SDK methods accept file objects as part of a request body or multi-part request. It is possible and typically recommended to upload files as a stream rather than reading the entire contents into memory. This avoids excessive memory consumption and potentially crashing with out-of-memory errors when working with very large files. The following example demonstrates how to attach a file stream to a request.
+
+> [!TIP]
+>
+> For endpoints that handle file uploads bytes arrays can also be used. However, using streams is recommended for large files.
+>
+
+```python
+from cribl_control_plane import CriblControlPlane, models
+import os
+
+
+with CriblControlPlane(
+    server_url="https://api.example.com",
+    security=models.Security(
+        bearer_auth=os.getenv("CRIBLCONTROLPLANE_BEARER_AUTH", ""),
+    ),
+) as ccp_client:
+
+    res = ccp_client.packs.update_packs(filename="example.file", size=779474, file={
+        "file_name": "example.file",
+        "content": open("example.file", "rb"),
+    })
+
+    # Handle response
+    print(res)
+
+```
+<!-- End File uploads [file-upload] -->
+
 <!-- Start Retries [retries] -->
 ## Retries
 

{cribl_control_plane-0.0.20.dist-info → cribl_control_plane-0.0.21a2.dist-info}/RECORD

@@ -4,7 +4,7 @@ cribl_control_plane/_hooks/clientcredentials.py,sha256=gVQkktlv3q4-AHOdbQl5r8i-G
 cribl_control_plane/_hooks/registration.py,sha256=1QZB41w6If7I9dXiOSQx6dhSc6BPWrnI5Q5bMOr4iVA,624
 cribl_control_plane/_hooks/sdkhooks.py,sha256=ggXjME1_Rdv8CVCg1XHqB83eYtbxzKyhXyfQ36Yc1gA,2816
 cribl_control_plane/_hooks/types.py,sha256=Tw_C4zTZm01rW_89VDEUpvQ8KQr1WxN0Gu_-s_fYSPc,2998
-cribl_control_plane/_version.py,sha256=Q27DsOHKatjShDpWRUePYtYGh13HXvh4Zmgeqj_PehQ,542
+cribl_control_plane/_version.py,sha256=JhVQal2YcNAqga4bHbJcNV5I-_-wWUMmDykvzwR6Ev8,546
 cribl_control_plane/auth_sdk.py,sha256=Jxw8hPHbBFay5eXcaRBtgdCC06mh5XHkRbZcIM0vvB8,7431
 cribl_control_plane/basesdk.py,sha256=amvvB5iPT7c-L6NLo2Rhu2f7xWaapsa6OfQ37SICXOw,11954
 cribl_control_plane/destinations.py,sha256=9L_VzqiAh8xAN4JNBsU7FT7ZFRiBuhtf-5mJBCbZj-g,65733
@@ -20,7 +20,7 @@ cribl_control_plane/groups_sdk.py,sha256=9tFiyKLd65XO-eTsLs74bUqE3g_0CJYeJ--vK-H
 cribl_control_plane/health.py,sha256=nK_Q4lDXi8zkfAqcIv9X4zBGi8BzomaBQWBD7TsSwLk,6743
 cribl_control_plane/httpclient.py,sha256=Eu73urOAiZQtdUIyOUnPccxCiBbWEKrXG-JrRG3SLM4,3946
 cribl_control_plane/lake.py,sha256=dHWnoO4KKOO8fncrdOqnc2sN4nGAWc6nX4UdNP4kx40,46484
-cribl_control_plane/models/__init__.py,sha256=2pUh9ZsWJQst_D0X5TOslvdnn91HiuBqY8hfu1AVNwI,577721
+cribl_control_plane/models/__init__.py,sha256=OCkOOnwz2j0N06eU1Euked1cuKNw0zVhn_Nqze67go8,578173
 cribl_control_plane/models/addhectokenrequest.py,sha256=mzQLKrMWlwxNheqEs5SM_yrT-gyenfCWgHKhmb5oXFQ,800
 cribl_control_plane/models/appmode.py,sha256=5xRJz9oP5ah4b6dcay4Q1IbQ9irm6k6x2BrTNysIMY4,300
 cribl_control_plane/models/authtoken.py,sha256=uW0aIs8j14CQzFM2ueY5GIWFulna91cigBWQ3oPlDgY,295
@@ -260,12 +260,12 @@ cribl_control_plane/models/updateinputbyidop.py,sha256=DtufjoD9UEPnKT2QOggfMDB1P
 cribl_control_plane/models/updateinputhectokenbyidandtokenop.py,sha256=-Q8ZP1yDmQmB9aylQNTs4zR1q6NH-Gi2fhlyiDyqWKI,1677
 cribl_control_plane/models/updateoutputbyidop.py,sha256=odGoTLgvR_AEYizuVMKjcDeB4Uua3BX_U-7OHw7wHiU,1333
 cribl_control_plane/models/updatepacksbyidop.py,sha256=nQeRQF-NTOCRMWz_gXfYlN0-I2OMM8Rovh_vAq73wzw,1965
-cribl_control_plane/models/updatepacksop.py,sha256=jXP_MUAh4cf9u7vo_cJ_zS7Ssv0kd-ZfCCe4yG3b3Zo,1073
+cribl_control_plane/models/updatepacksop.py,sha256=oH7fcrk4uBTiD0bXJFvavUTonH0G0c63GRPg7CCLlgI,2669
 cribl_control_plane/models/updatepipelinebyidop.py,sha256=CPCiszliWVcewMyZ26_R8OvtbJA8RwrEj_XQFoZTSJg,1420
 cribl_control_plane/models/updateroutesbyidop.py,sha256=k6vejvOHHqyfp1oR3aDXEXYIUu6NeRHBl7s9k-jcyiE,1440
 cribl_control_plane/models/updateworkersrestartop.py,sha256=OwX1snIrUTfghc0Pb2PpI5IO6NS-aL0BOMzWqLl8GAA,787
 cribl_control_plane/models/useraccesscontrollist.py,sha256=UNM3mdqFByd9GAovAi26z9y-5H15hrKDzw0M-f-Pn2o,483
-cribl_control_plane/packs.py,sha256=pIW3stXJ7gdJHkYDJ7LF-_I23g3v5E02iNWOnD1tTs8,38830
+cribl_control_plane/packs.py,sha256=Q6JnsLchHLbDb7lPDfS2AzGzrXqb-9QQ-uBOyHkeqUo,40014
 cribl_control_plane/pipelines.py,sha256=L-HbP4gyl05hxb4-HNvkFrk1w6xFccfNr4-AJy3Vjxo,36038
 cribl_control_plane/py.typed,sha256=zrp19r0G21lr2yRiMC0f8MFkQFGj9wMpSbboePMg8KM,59
 cribl_control_plane/routes_sdk.py,sha256=bxL7KZKdw4Ot78Q3V4Ea5SWrhnEM0fHdRUwQRDeF0Oc,31227
@@ -294,6 +294,6 @@ cribl_control_plane/utils/url.py,sha256=BgGPgcTA6MRK4bF8fjP2dUopN3NzEzxWMXPBVg8N
 cribl_control_plane/utils/values.py,sha256=CcaCXEa3xHhkUDROyXZocN8f0bdITftv9Y0P9lTf0YM,3517
 cribl_control_plane/versioning.py,sha256=-bUutXEf__ewPHzgZshBImZZyQILigzXp1H8ZBCFBbQ,93847
 cribl_control_plane/workers_sdk.py,sha256=qEt_s-Zfg8zyzWEHnOtqYzTiNzFSwEalG-1lSYzVJWc,22666
-cribl_control_plane-0.0.20.dist-info/METADATA,sha256=EHKSg18sYK5Chum-o7NUU6b1ObL0ORJbbjvvUOxdSyY,30841
-cribl_control_plane-0.0.20.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-cribl_control_plane-0.0.20.dist-info/RECORD,,
+cribl_control_plane-0.0.21a2.dist-info/METADATA,sha256=BX5vxlOINc69mlWSWeqdyQtOuN6YOTwBsye88qtOMSI,32093
+cribl_control_plane-0.0.21a2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+cribl_control_plane-0.0.21a2.dist-info/RECORD,,