Skip to content

Commit d00a4ed

Browse files
committed
change params to use :typeddict: tag
1 parent bee3595 commit d00a4ed

10 files changed

Lines changed: 59 additions & 58 deletions

File tree

src/runloop_api_client/sdk/async_.py

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ async def create(
5656
) -> AsyncDevbox:
5757
"""Provision a new devbox and wait until it reaches ``running`` state.
5858
59-
:param params: Keyword arguments forwarded to the devbox creation API
59+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxCreateParams` for available parameters
6060
:return: Wrapper bound to the newly created devbox
6161
:rtype: AsyncDevbox
6262
"""
@@ -74,7 +74,7 @@ async def create_from_blueprint_id(
7474
7575
:param blueprint_id: Blueprint ID to create from
7676
:type blueprint_id: str
77-
:param params: Additional creation parameters (metadata, launch parameters, etc.)
77+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExtraCreateParams` for available parameters
7878
:return: Wrapper bound to the newly created devbox
7979
:rtype: AsyncDevbox
8080
"""
@@ -93,7 +93,7 @@ async def create_from_blueprint_name(
9393
9494
:param blueprint_name: Blueprint name to create from
9595
:type blueprint_name: str
96-
:param params: Additional creation parameters (metadata, launch parameters, etc.)
96+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExtraCreateParams` for available parameters
9797
:return: Wrapper bound to the newly created devbox
9898
:rtype: AsyncDevbox
9999
"""
@@ -112,7 +112,7 @@ async def create_from_snapshot(
112112
113113
:param snapshot_id: Snapshot ID to create from
114114
:type snapshot_id: str
115-
:param params: Additional creation parameters (metadata, launch parameters, etc.)
115+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExtraCreateParams` for available parameters
116116
:return: Wrapper bound to the newly created devbox
117117
:rtype: AsyncDevbox
118118
"""
@@ -138,7 +138,7 @@ async def list(
138138
) -> list[AsyncDevbox]:
139139
"""List devboxes accessible to the caller.
140140
141-
:param params: Filtering and pagination parameters
141+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxListParams` for available parameters
142142
:return: Collection of devbox wrappers
143143
:rtype: list[AsyncDevbox]
144144
"""
@@ -174,7 +174,7 @@ async def list(
174174
) -> list[AsyncSnapshot]:
175175
"""List snapshots created from devboxes.
176176
177-
:param params: Filtering and pagination parameters
177+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDiskSnapshotListParams` for available parameters
178178
:return: Snapshot wrappers for each record
179179
:rtype: list[AsyncSnapshot]
180180
"""
@@ -224,7 +224,7 @@ async def create(
224224
) -> AsyncBlueprint:
225225
"""Create a blueprint and wait for the build to finish.
226226
227-
:param params: Blueprint definition (Dockerfile, metadata, etc.)
227+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKBlueprintCreateParams` for available parameters
228228
:return: Wrapper bound to the finished blueprint
229229
:rtype: AsyncBlueprint
230230
"""
@@ -249,7 +249,7 @@ async def list(
249249
) -> list[AsyncBlueprint]:
250250
"""List available blueprints.
251251
252-
:param params: Filtering and pagination parameters
252+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKBlueprintListParams` for available parameters
253253
:return: Blueprint wrappers for each record
254254
:rtype: list[AsyncBlueprint]
255255
"""
@@ -287,7 +287,7 @@ async def create(
287287
) -> AsyncStorageObject:
288288
"""Create a storage object and obtain an upload URL.
289289
290-
:param params: Object creation parameters (name, content type, metadata)
290+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKObjectCreateParams` for available parameters
291291
:return: Wrapper with upload URL set for immediate uploads
292292
:rtype: AsyncStorageObject
293293
"""
@@ -310,7 +310,7 @@ async def list(
310310
) -> list[AsyncStorageObject]:
311311
"""List storage objects owned by the caller.
312312
313-
:param params: Filtering and pagination parameters
313+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKObjectListParams` for available parameters
314314
:return: Storage object wrappers for each record
315315
:rtype: list[AsyncStorageObject]
316316
"""
@@ -338,7 +338,7 @@ async def upload_from_file(
338338
:type content_type: ContentType | None, optional
339339
:param metadata: Optional key-value metadata, defaults to None
340340
:type metadata: Optional[Dict[str, str]], optional
341-
:param options: Additional request configuration
341+
:param options: See :typeddict:`~runloop_api_client.sdk._types.LongRequestOptions` for available options
342342
:return: Wrapper for the uploaded object
343343
:rtype: AsyncStorageObject
344344
:raises OSError: If the local file cannot be read
@@ -373,7 +373,7 @@ async def upload_from_text(
373373
:type name: str
374374
:param metadata: Optional key-value metadata, defaults to None
375375
:type metadata: Optional[Dict[str, str]], optional
376-
:param options: Additional request configuration
376+
:param options: See :typeddict:`~runloop_api_client.sdk._types.LongRequestOptions` for available options
377377
:return: Wrapper for the uploaded object
378378
:rtype: AsyncStorageObject
379379
"""
@@ -401,7 +401,7 @@ async def upload_from_bytes(
401401
:type content_type: ContentType
402402
:param metadata: Optional key-value metadata, defaults to None
403403
:type metadata: Optional[Dict[str, str]], optional
404-
:param options: Additional request configuration
404+
:param options: See :typeddict:`~runloop_api_client.sdk._types.LongRequestOptions` for available options
405405
:return: Wrapper for the uploaded object
406406
:rtype: AsyncStorageObject
407407
"""

src/runloop_api_client/sdk/async_blueprint.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ async def create_devbox(
9393
) -> "AsyncDevbox":
9494
"""Create a devbox derived from the blueprint.
9595
96-
:param params: Creation parameters to forward to the devbox API
96+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExtraCreateParams` for available parameters
9797
:return: Wrapper bound to the running devbox
9898
:rtype: AsyncDevbox
9999
"""

src/runloop_api_client/sdk/async_devbox.py

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -215,7 +215,7 @@ async def snapshot_disk(
215215
Captures the current state of the devbox disk, which can be used to create
216216
new devboxes with the same state.
217217
218-
:param params: Snapshot metadata, naming, and polling configuration
218+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxSnapshotDiskParams` for available parameters
219219
:return: Wrapper representing the completed snapshot
220220
:rtype: AsyncSnapshot
221221
"""
@@ -236,7 +236,7 @@ async def snapshot_disk_async(
236236
Starts the snapshot creation process and returns immediately without waiting
237237
for completion. Use snapshot.await_completed() to wait for completion.
238238
239-
:param params: Snapshot metadata and naming options
239+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxSnapshotDiskAsyncParams` for available parameters
240240
:return: Wrapper representing the snapshot request
241241
:rtype: AsyncSnapshot
242242
"""
@@ -371,7 +371,7 @@ async def exec(
371371
) -> AsyncExecutionResult:
372372
"""Execute a command synchronously and wait for completion.
373373
374-
:param params: Command parameters, streaming callbacks, and polling config
374+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExecuteParams` for available parameters
375375
:return: Wrapper with exit status and output helpers
376376
:rtype: AsyncExecutionResult
377377
@@ -428,7 +428,7 @@ async def exec_async(
428428
for process management. Use execution.result() to wait for completion or
429429
execution.kill() to terminate the process.
430430
431-
:param params: Command parameters and streaming callbacks
431+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExecuteAsyncParams` for available parameters
432432
:return: Handle for managing the running process
433433
:rtype: AsyncExecution
434434
@@ -471,7 +471,7 @@ async def read(
471471
) -> str:
472472
"""Read a file from the devbox.
473473
474-
:param params: Parameters such as ``path``
474+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxReadFileContentsParams` for available parameters
475475
:return: File contents
476476
:rtype: str
477477
@@ -492,7 +492,7 @@ async def write(
492492
493493
Creates or overwrites the file at the specified path.
494494
495-
:param params: Parameters such as ``file_path`` and ``contents``
495+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxWriteFileContentsParams` for available parameters
496496
:return: Execution metadata for the write command
497497
:rtype: DevboxExecutionDetailView
498498
@@ -510,7 +510,7 @@ async def download(
510510
) -> bytes:
511511
"""Download a file from the devbox.
512512
513-
:param params: Parameters such as ``path``
513+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxDownloadFileParams` for available parameters
514514
:return: Raw file contents
515515
:rtype: bytes
516516
@@ -531,7 +531,7 @@ async def upload(
531531
) -> object:
532532
"""Upload a file to the devbox.
533533
534-
:param params: Parameters such as destination ``path`` and local ``file``
534+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxUploadFileParams` for available parameters
535535
:return: API response confirming the upload
536536
:rtype: object
537537
@@ -579,7 +579,7 @@ async def create_tunnel(
579579
) -> DevboxTunnelView:
580580
"""Create a network tunnel to expose a devbox port publicly.
581581
582-
:param params: Parameters such as the devbox ``port`` to expose
582+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxCreateTunnelParams` for available parameters
583583
:return: Details about the public endpoint
584584
:rtype: DevboxTunnelView
585585
@@ -598,7 +598,7 @@ async def remove_tunnel(
598598
) -> object:
599599
"""Remove a network tunnel, disabling public access to the port.
600600
601-
:param params: Parameters such as the ``port`` to close
601+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxRemoveTunnelParams` for available parameters
602602
:return: Response confirming the tunnel removal
603603
:rtype: object
604604

src/runloop_api_client/sdk/async_snapshot.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ async def update(
6969
) -> DevboxSnapshotView:
7070
"""Update snapshot metadata.
7171
72-
:param params: Fields to update on the snapshot
72+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDiskSnapshotUpdateParams` for available parameters
7373
:return: Updated snapshot details
7474
:rtype: DevboxSnapshotView
7575
"""
@@ -114,7 +114,7 @@ async def create_devbox(
114114
) -> "AsyncDevbox":
115115
"""Create a devbox restored from this snapshot.
116116
117-
:param params: Creation parameters forwarded to the devbox API
117+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExtraCreateParams` for available parameters
118118
:return: Wrapper bound to the running devbox
119119
:rtype: AsyncDevbox
120120
"""

src/runloop_api_client/sdk/async_storage_object.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ async def get_download_url(
8787
) -> ObjectDownloadURLView:
8888
"""Request a signed download URL for the object.
8989
90-
:param params: Parameters controlling the download URL (e.g., expiry)
90+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKObjectDownloadParams` for available parameters
9191
:return: URL + metadata describing the download
9292
:rtype: ObjectDownloadURLView
9393
"""
@@ -102,7 +102,7 @@ async def download_as_bytes(
102102
) -> bytes:
103103
"""Download the object contents as bytes.
104104
105-
:param params: Parameters forwarded to ``get_download_url``
105+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKObjectDownloadParams` for available parameters
106106
:return: Entire object payload
107107
:rtype: bytes
108108
"""
@@ -119,7 +119,7 @@ async def download_as_text(
119119
) -> str:
120120
"""Download the object contents as UTF-8 text.
121121
122-
:param params: Parameters forwarded to ``get_download_url``
122+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKObjectDownloadParams` for available parameters
123123
:return: Entire object payload decoded as UTF-8
124124
:rtype: str
125125
"""

src/runloop_api_client/sdk/blueprint.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ def create_devbox(
9393
) -> "Devbox":
9494
"""Create a devbox derived from the blueprint.
9595
96-
:param params: Creation parameters to forward to the devbox API
96+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExtraCreateParams` for available parameters
9797
:return: Wrapper bound to the running devbox
9898
:rtype: Devbox
9999
"""

src/runloop_api_client/sdk/devbox.py

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -223,7 +223,7 @@ def snapshot_disk(
223223
Captures the current state of the devbox disk, which can be used to create
224224
new devboxes with the same state.
225225
226-
:param params: Snapshot metadata, naming, and polling configuration
226+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxSnapshotDiskParams` for available parameters
227227
:return: Wrapper representing the completed snapshot
228228
:rtype: Snapshot
229229
"""
@@ -244,7 +244,7 @@ def snapshot_disk_async(
244244
Starts the snapshot creation process and returns immediately without waiting
245245
for completion. Use snapshot.await_completed() to wait for completion.
246246
247-
:param params: Snapshot metadata and naming options
247+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxSnapshotDiskAsyncParams` for available parameters
248248
:return: Wrapper representing the snapshot (may still be processing)
249249
:rtype: Snapshot
250250
"""
@@ -395,7 +395,7 @@ def exec(
395395
) -> ExecutionResult:
396396
"""Execute a command synchronously and wait for completion.
397397
398-
:param params: Command parameters, streaming callbacks, and polling config
398+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExecuteParams` for available parameters
399399
:return: Wrapper with exit status and output helpers
400400
:rtype: ExecutionResult
401401
@@ -442,7 +442,7 @@ def exec_async(
442442
for process management. Use execution.result() to wait for completion or
443443
execution.kill() to terminate the process.
444444
445-
:param params: Command parameters and streaming callbacks
445+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExecuteAsyncParams` for available parameters
446446
:return: Handle for managing the running process
447447
:rtype: Execution
448448
@@ -485,7 +485,7 @@ def read(
485485
) -> str:
486486
"""Read a file from the devbox.
487487
488-
:param params: Parameters such as ``path``
488+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxReadFileContentsParams` for available parameters
489489
:return: File contents
490490
:rtype: str
491491
@@ -506,7 +506,7 @@ def write(
506506
507507
Creates or overwrites the file at the specified path.
508508
509-
:param params: Parameters such as ``file_path`` and ``contents``
509+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxWriteFileContentsParams` for available parameters
510510
:return: Execution metadata for the write command
511511
:rtype: DevboxExecutionDetailView
512512
@@ -524,7 +524,7 @@ def download(
524524
) -> bytes:
525525
"""Download a file from the devbox.
526526
527-
:param params: Parameters such as ``path``
527+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxDownloadFileParams` for available parameters
528528
:return: Raw file contents
529529
:rtype: bytes
530530
@@ -545,7 +545,7 @@ def upload(
545545
) -> object:
546546
"""Upload a file to the devbox.
547547
548-
:param params: Parameters such as destination ``path`` and local ``file``
548+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxUploadFileParams` for available parameters
549549
:return: API response confirming the upload
550550
:rtype: object
551551
@@ -593,7 +593,7 @@ def create_tunnel(
593593
) -> DevboxTunnelView:
594594
"""Create a network tunnel to expose a devbox port publicly.
595595
596-
:param params: Parameters such as the devbox ``port`` to expose
596+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxCreateTunnelParams` for available parameters
597597
:return: Details about the public endpoint
598598
:rtype: DevboxTunnelView
599599
@@ -612,7 +612,7 @@ def remove_tunnel(
612612
) -> object:
613613
"""Remove a network tunnel, disabling public access to the port.
614614
615-
:param params: Parameters such as the ``port`` to close
615+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxRemoveTunnelParams` for available parameters
616616
:return: Response confirming the tunnel removal
617617
:rtype: object
618618

src/runloop_api_client/sdk/snapshot.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ def update(
6969
) -> DevboxSnapshotView:
7070
"""Update snapshot metadata.
7171
72-
:param params: Fields to update on the snapshot
72+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDiskSnapshotUpdateParams` for available parameters
7373
:return: Updated snapshot details
7474
:rtype: DevboxSnapshotView
7575
"""
@@ -114,7 +114,7 @@ def create_devbox(
114114
) -> "Devbox":
115115
"""Create a devbox restored from this snapshot.
116116
117-
:param params: Creation parameters to forward to the devbox API
117+
:param params: See :typeddict:`~runloop_api_client.sdk._types.SDKDevboxExtraCreateParams` for available parameters
118118
:return: Wrapper bound to the running devbox
119119
:rtype: Devbox
120120
"""

0 commit comments

Comments
 (0)