cribl-control-plane 0.0.20__py3-none-any.whl → 0.0.21a1__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.21a1"
 __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.21a1 2.660.0 4.14.0-alpha.1753968519625-08e89eb4 cribl-control-plane"
 
 try:
     if __package__ is not None:

cribl_control_plane/models/updatepacksop.py

@@ -3,16 +3,31 @@
 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
+import io
+from typing import Any, Dict, IO, List, Optional, Union
 from typing_extensions import Annotated, NotRequired, TypedDict
 
 
 class UpdatePacksRequestTypedDict(TypedDict):
+    size: int
+    r"""Size of the pack file in bytes"""
+    request_body: Union[bytes, IO[bytes], io.BufferedReader]
+    r"""file data"""
     filename: NotRequired[str]
     r"""the file to upload"""
 
 
 class UpdatePacksRequest(BaseModel):
+    size: Annotated[
+        int, FieldMetadata(query=QueryParamMetadata(style="form", explode=True))
+    ]
+    r"""Size of the pack file in bytes"""
+
+    request_body: Annotated[
+        Union[bytes, IO[bytes], io.BufferedReader], FieldMetadata(request=True)
+    ]
+    r"""file data"""
+
     filename: Annotated[
         Optional[str],
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),

cribl_control_plane/packs.py

@@ -6,7 +6,8 @@ from cribl_control_plane._hooks import HookContext
 from cribl_control_plane.types import OptionalNullable, UNSET
 from cribl_control_plane.utils import get_security_from_env
 from cribl_control_plane.utils.unmarshal_json_response import unmarshal_json_response
-from typing import Any, List, Mapping, Optional, Union
+import io
+from typing import Any, IO, List, Mapping, Optional, Union
 
 
 class Packs(BaseSDK):
@@ -451,6 +452,8 @@ class Packs(BaseSDK):
     def update_packs(
         self,
         *,
+        size: int,
+        request_body: Union[bytes, IO[bytes], io.BufferedReader],
         filename: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
@@ -461,6 +464,8 @@ class Packs(BaseSDK):
 
         Upload Pack
 
+        :param size: Size of the pack file in bytes
+        :param request_body: file data
         :param filename: the file to upload
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
@@ -479,6 +484,8 @@ class Packs(BaseSDK):
 
         request = models.UpdatePacksRequest(
             filename=filename,
+            size=size,
+            request_body=request_body,
         )
 
         req = self._build_request(
@@ -487,13 +494,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,
+                "raw",
+                Union[bytes, IO[bytes], io.BufferedReader],
+            ),
             timeout_ms=timeout_ms,
         )
 
@@ -538,6 +552,8 @@ class Packs(BaseSDK):
     async def update_packs_async(
         self,
         *,
+        size: int,
+        request_body: Union[bytes, IO[bytes], io.BufferedReader],
         filename: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
@@ -548,6 +564,8 @@ class Packs(BaseSDK):
 
         Upload Pack
 
+        :param size: Size of the pack file in bytes
+        :param request_body: file data
         :param filename: the file to upload
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
@@ -566,6 +584,8 @@ class Packs(BaseSDK):
 
         request = models.UpdatePacksRequest(
             filename=filename,
+            size=size,
+            request_body=request_body,
         )
 
         req = self._build_request_async(
@@ -574,13 +594,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,
+                "raw",
+                Union[bytes, IO[bytes], io.BufferedReader],
+            ),
             timeout_ms=timeout_ms,
         )
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: cribl-control-plane
-Version: 0.0.20
+Version: 0.0.21a1
 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,36 @@ 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(size=779474, request_body=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.21a1.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=ZnqjqZBFBwWWPOslk2weR_VRAOHrHngTOGA1eeRqZmw,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
@@ -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=G5UhEf4aAXRQVTH8ZogiuTo3QpcrDfYbdqG7-i9QWUk,1520
 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=syPegLRmrD9ERdPv4w8IamWqcZGhoTudXVtL1BPQHgI,39822
 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.21a1.dist-info/METADATA,sha256=xDWVKkC0ywSAGo0f1RE4b4kfNMMRPCGiJXRcSPKgJsw,32011
+cribl_control_plane-0.0.21a1.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+cribl_control_plane-0.0.21a1.dist-info/RECORD,,