feat(api): update via SDK Studio (#13)

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -25,20 +25,10 @@ jobs:
           RYE_INSTALL_OPTION: '--yes'
 
       - name: Install dependencies
-        run: |
-          rye sync --all-features
-
-      - name: Run ruff
-        run: |
-          rye run check:ruff
+        run: rye sync --all-features
 
-      - name: Run type checking
-        run: |
-          rye run typecheck
-
-      - name: Ensure importable
-        run: |
-          rye run python -c 'import kthcloud_go_deploy_v2'
+      - name: Run lints
+        run: ./scripts/lint
   test:
     name: test
     runs-on: ubuntu-latest

CONTRIBUTING.md

@@ -32,7 +32,7 @@ $ pip install -r requirements-dev.lock
 ## Modifying/Adding code
 
 Most of the SDK is generated code, and any modified code will be overridden on the next generation. The
-`src/kthcloud_go_deploy_v2/lib/` and `examples/` directories are exceptions and will never be overridden.
+`src/kthcloud_go_deploy_v_/lib/` and `examples/` directories are exceptions and will never be overridden.
 
 ## Adding and running examples
 

README.md

@@ -24,7 +24,7 @@ pip install --pre kthcloud
 The full API of this library can be found in [api.md](api.md).
 
 ```python
-from kthcloud_go_deploy_v2 import KthcloudGoDeployV2
+from kthcloud_go_deploy_v_ import KthcloudGoDeployV2
 
 client = KthcloudGoDeployV2()
 
@@ -49,7 +49,7 @@ Simply import `AsyncKthcloudGoDeployV2` instead of `KthcloudGoDeployV2` and use
 
 ```python
 import asyncio
-from kthcloud_go_deploy_v2 import AsyncKthcloudGoDeployV2
+from kthcloud_go_deploy_v_ import AsyncKthcloudGoDeployV2
 
 client = AsyncKthcloudGoDeployV2()
 
@@ -81,16 +81,16 @@ Typed requests and responses provide autocomplete and documentation within your
 
 ## Handling errors
 
-When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `kthcloud_go_deploy_v2.APIConnectionError` is raised.
+When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `kthcloud_go_deploy_v_.APIConnectionError` is raised.
 
 When the API returns a non-success status code (that is, 4xx or 5xx
-response), a subclass of `kthcloud_go_deploy_v2.APIStatusError` is raised, containing `status_code` and `response` properties.
+response), a subclass of `kthcloud_go_deploy_v_.APIStatusError` is raised, containing `status_code` and `response` properties.
 
-All errors inherit from `kthcloud_go_deploy_v2.APIError`.
+All errors inherit from `kthcloud_go_deploy_v_.APIError`.
 
 ```python
-import kthcloud_go_deploy_v2
-from kthcloud_go_deploy_v2 import KthcloudGoDeployV2
+import kthcloud_go_deploy_v_
+from kthcloud_go_deploy_v_ import KthcloudGoDeployV2
 
 client = KthcloudGoDeployV2()
 
@@ -102,12 +102,12 @@ try:
         ram=1,
         ssh_public_key="string",
     )
-except kthcloud_go_deploy_v2.APIConnectionError as e:
+except kthcloud_go_deploy_v_.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
-except kthcloud_go_deploy_v2.RateLimitError as e:
+except kthcloud_go_deploy_v_.RateLimitError as e:
     print("A 429 status code was received; we should back off a bit.")
-except kthcloud_go_deploy_v2.APIStatusError as e:
+except kthcloud_go_deploy_v_.APIStatusError as e:
     print("Another non-200-range status code was received")
     print(e.status_code)
     print(e.response)
@@ -135,7 +135,7 @@ Connection errors (for example, due to a network connectivity problem), 408 Requ
 You can use the `max_retries` option to configure or disable retry settings:
 
 ```python
-from kthcloud_go_deploy_v2 import KthcloudGoDeployV2
+from kthcloud_go_deploy_v_ import KthcloudGoDeployV2
 
 # Configure the default for all requests:
 client = KthcloudGoDeployV2(
@@ -159,7 +159,7 @@ By default requests time out after 1 minute. You can configure this with a `time
 which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
 
 ```python
-from kthcloud_go_deploy_v2 import KthcloudGoDeployV2
+from kthcloud_go_deploy_v_ import KthcloudGoDeployV2
 
 # Configure the default for all requests:
 client = KthcloudGoDeployV2(
@@ -215,7 +215,7 @@ if response.my_field is None:
 The "raw" Response object can be accessed by prefixing `.with_raw_response.` to any HTTP method call, e.g.,
 
 ```py
-from kthcloud_go_deploy_v2 import KthcloudGoDeployV2
+from kthcloud_go_deploy_v_ import KthcloudGoDeployV2
 
 client = KthcloudGoDeployV2()
 response = client.vms.with_raw_response.create(
@@ -231,9 +231,9 @@ vm = response.parse()  # get the object that `vms.create()` would have returned
 print(vm.id)
 ```
 
-These methods return an [`APIResponse`](https://github.com/kthcloud/python-sdk/tree/main/src/kthcloud_go_deploy_v2/_response.py) object.
+These methods return an [`APIResponse`](https://github.com/kthcloud/python-sdk/tree/main/src/kthcloud_go_deploy_v_/_response.py) object.
 
-The async client returns an [`AsyncAPIResponse`](https://github.com/kthcloud/python-sdk/tree/main/src/kthcloud_go_deploy_v2/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
+The async client returns an [`AsyncAPIResponse`](https://github.com/kthcloud/python-sdk/tree/main/src/kthcloud_go_deploy_v_/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
 
 #### `.with_streaming_response`
 
@@ -301,7 +301,7 @@ You can directly override the [httpx client](https://www.python-httpx.org/api/#c
 - Additional [advanced](https://www.python-httpx.org/advanced/#client-instances) functionality
 
 ```python
-from kthcloud_go_deploy_v2 import KthcloudGoDeployV2, DefaultHttpxClient
+from kthcloud_go_deploy_v_ import KthcloudGoDeployV2, DefaultHttpxClient
 
 client = KthcloudGoDeployV2(
     # Or use the `KTHCLOUD_GO_DEPLOY_V2_BASE_URL` env var

SECURITY.md

@@ -0,0 +1,27 @@
+# Security Policy
+
+## Reporting Security Issues
+
+This SDK is generated by [Stainless Software Inc](http://stainlessapi.com). Stainless takes security seriously, and encourages you to report any security vulnerability promptly so that appropriate action can be taken.
+
+To report a security issue, please contact the Stainless team at [email protected].
+
+## Responsible Disclosure
+
+We appreciate the efforts of security researchers and individuals who help us maintain the security of
+SDKs we generate. If you believe you have found a security vulnerability, please adhere to responsible
+disclosure practices by allowing us a reasonable amount of time to investigate and address the issue
+before making any information public.
+
+## Reporting Non-SDK Related Security Issues
+
+If you encounter security issues that are not directly related to SDKs but pertain to the services
+or products provided by Kthcloud Go Deploy V2 please follow the respective company's security reporting guidelines.
+
+### Kthcloud Go Deploy V2 Terms and Policies
+
+Please contact [email protected] for any questions or concerns regarding security of our services.
+
+---
+
+Thank you for helping us keep the SDKs and systems they interact with secure.

api.md

@@ -1,95 +1,95 @@
 # Shared Types
 
 ```python
-from kthcloud_go_deploy_v2.types import VmSnapshotRead
+from kthcloud_go_deploy_v_.types import VmSnapshotRead
 ```
 
-# GpuGroups
+# GPUGroups
 
 Types:
 
 ```python
-from kthcloud_go_deploy_v2.types import GpuGroup, GpuGroupListResponse
+from kthcloud_go_deploy_v_.types import GPUGroup, GPUGroupListResponse
 ```
 
 Methods:
 
-- <code title="get /v2/gpuGroups/{gpuGroupId}">client.gpu_groups.<a href="./src/kthcloud_go_deploy_v2/resources/gpu_groups.py">retrieve</a>(gpu_group_id) -> <a href="./src/kthcloud_go_deploy_v2/types/gpu_group.py">GpuGroup</a></code>
-- <code title="get /v2/gpuGroups">client.gpu_groups.<a href="./src/kthcloud_go_deploy_v2/resources/gpu_groups.py">list</a>(\*\*<a href="src/kthcloud_go_deploy_v2/types/gpu_group_list_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v2/types/gpu_group_list_response.py">GpuGroupListResponse</a></code>
+- <code title="get /v2/gpuGroups/{gpuGroupId}">client.gpu*groups.<a href="./src/kthcloud_go_deploy_v*/resources/gpu*groups.py">retrieve</a>(gpu_group_id) -> <a href="./src/kthcloud_go_deploy_v*/types/gpu_group.py">GPUGroup</a></code>
+- <code title="get /v2/gpuGroups">client.gpu*groups.<a href="./src/kthcloud_go_deploy_v*/resources/gpu*groups.py">list</a>(\*\*<a href="src/kthcloud_go_deploy_v*/types/gpu*group_list_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v*/types/gpu_group_list_response.py">GPUGroupListResponse</a></code>
 
-# GpuLeases
+# GPULeases
 
 Types:
 
 ```python
-from kthcloud_go_deploy_v2.types import (
-    GpuLeaseCreated,
-    GpuLeaseDeleted,
-    GpuLeaseRead,
-    GpuLeaseUpdated,
-    GpuLeaseListResponse,
+from kthcloud_go_deploy_v_.types import (
+    GPULeaseCreated,
+    GPULeaseDeleted,
+    GPULeaseRead,
+    GPULeaseUpdated,
+    GPULeaseListResponse,
 )
 ```
 
 Methods:
 
-- <code title="post /v2/gpuLeases">client.gpu_leases.<a href="./src/kthcloud_go_deploy_v2/resources/gpu_leases.py">create</a>(\*\*<a href="src/kthcloud_go_deploy_v2/types/gpu_lease_create_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v2/types/gpu_lease_created.py">GpuLeaseCreated</a></code>
-- <code title="get /v2/gpuLeases/{gpuLeaseId}">client.gpu_leases.<a href="./src/kthcloud_go_deploy_v2/resources/gpu_leases.py">retrieve</a>(gpu_lease_id) -> <a href="./src/kthcloud_go_deploy_v2/types/gpu_lease_read.py">GpuLeaseRead</a></code>
-- <code title="post /v2/gpuLeases/{gpuLeaseId}">client.gpu_leases.<a href="./src/kthcloud_go_deploy_v2/resources/gpu_leases.py">update</a>(gpu_lease_id, \*\*<a href="src/kthcloud_go_deploy_v2/types/gpu_lease_update_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v2/types/gpu_lease_updated.py">GpuLeaseUpdated</a></code>
-- <code title="get /v2/gpuLeases">client.gpu_leases.<a href="./src/kthcloud_go_deploy_v2/resources/gpu_leases.py">list</a>(\*\*<a href="src/kthcloud_go_deploy_v2/types/gpu_lease_list_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v2/types/gpu_lease_list_response.py">GpuLeaseListResponse</a></code>
-- <code title="delete /v2/gpuLeases/{gpuLeaseId}">client.gpu_leases.<a href="./src/kthcloud_go_deploy_v2/resources/gpu_leases.py">delete</a>(gpu_lease_id) -> <a href="./src/kthcloud_go_deploy_v2/types/gpu_lease_deleted.py">GpuLeaseDeleted</a></code>
+- <code title="post /v2/gpuLeases">client.gpu*leases.<a href="./src/kthcloud_go_deploy_v*/resources/gpu*leases.py">create</a>(\*\*<a href="src/kthcloud_go_deploy_v*/types/gpu*lease_create_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v*/types/gpu_lease_created.py">GPULeaseCreated</a></code>
+- <code title="get /v2/gpuLeases/{gpuLeaseId}">client.gpu*leases.<a href="./src/kthcloud_go_deploy_v*/resources/gpu*leases.py">retrieve</a>(gpu_lease_id) -> <a href="./src/kthcloud_go_deploy_v*/types/gpu_lease_read.py">GPULeaseRead</a></code>
+- <code title="post /v2/gpuLeases/{gpuLeaseId}">client.gpu*leases.<a href="./src/kthcloud_go_deploy_v*/resources/gpu*leases.py">update</a>(gpu_lease_id, \*\*<a href="src/kthcloud_go_deploy_v*/types/gpu*lease_update_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v*/types/gpu_lease_updated.py">GPULeaseUpdated</a></code>
+- <code title="get /v2/gpuLeases">client.gpu*leases.<a href="./src/kthcloud_go_deploy_v*/resources/gpu*leases.py">list</a>(\*\*<a href="src/kthcloud_go_deploy_v*/types/gpu*lease_list_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v*/types/gpu_lease_list_response.py">GPULeaseListResponse</a></code>
+- <code title="delete /v2/gpuLeases/{gpuLeaseId}">client.gpu*leases.<a href="./src/kthcloud_go_deploy_v*/resources/gpu*leases.py">delete</a>(gpu_lease_id) -> <a href="./src/kthcloud_go_deploy_v*/types/gpu_lease_deleted.py">GPULeaseDeleted</a></code>
 
 # Snapshots
 
 Types:
 
 ```python
-from kthcloud_go_deploy_v2.types import VmSnapshotCreated, SnapshotListResponse
+from kthcloud_go_deploy_v_.types import VmSnapshotCreated, SnapshotListResponse
 ```
 
 Methods:
 
-- <code title="post /v2/snapshots">client.snapshots.<a href="./src/kthcloud_go_deploy_v2/resources/snapshots.py">create</a>() -> <a href="./src/kthcloud_go_deploy_v2/types/vm_snapshot_created.py">VmSnapshotCreated</a></code>
-- <code title="get /v2/snapshots">client.snapshots.<a href="./src/kthcloud_go_deploy_v2/resources/snapshots.py">list</a>(\*\*<a href="src/kthcloud_go_deploy_v2/types/snapshot_list_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v2/types/snapshot_list_response.py">SnapshotListResponse</a></code>
+- <code title="post /v2/snapshots">client.snapshots.<a href="./src/kthcloud_go_deploy_v_/resources/snapshots.py">create</a>() -> <a href="./src/kthcloud_go_deploy_v_/types/vm_snapshot_created.py">VmSnapshotCreated</a></code>
+- <code title="get /v2/snapshots">client.snapshots.<a href="./src/kthcloud_go_deploy_v_/resources/snapshots.py">list</a>(\*\*<a href="src/kthcloud_go_deploy_v_/types/snapshot_list_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v_/types/snapshot_list_response.py">SnapshotListResponse</a></code>
 
 # VmActions
 
 Types:
 
 ```python
-from kthcloud_go_deploy_v2.types import VmActionCreated
+from kthcloud_go_deploy_v_.types import VmActionCreated
 ```
 
 Methods:
 
-- <code title="post /v2/vmActions">client.vm_actions.<a href="./src/kthcloud_go_deploy_v2/resources/vm_actions.py">create</a>(\*\*<a href="src/kthcloud_go_deploy_v2/types/vm_action_create_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v2/types/vm_action_created.py">VmActionCreated</a></code>
+- <code title="post /v2/vmActions">client.vm*actions.<a href="./src/kthcloud_go_deploy_v*/resources/vm*actions.py">create</a>(\*\*<a href="src/kthcloud_go_deploy_v*/types/vm*action_create_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v*/types/vm_action_created.py">VmActionCreated</a></code>
 
 # Vms
 
 Types:
 
 ```python
-from kthcloud_go_deploy_v2.types import VmCreated, VmDeleted, VmRead, VmUpdated, VmListResponse
+from kthcloud_go_deploy_v_.types import VmCreated, VmDeleted, VmRead, VmUpdated, VmListResponse
 ```
 
 Methods:
 
-- <code title="post /v2/vms">client.vms.<a href="./src/kthcloud_go_deploy_v2/resources/vms/vms.py">create</a>(\*\*<a href="src/kthcloud_go_deploy_v2/types/vm_create_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v2/types/vm_created.py">VmCreated</a></code>
-- <code title="get /v2/vms/{vmId}">client.vms.<a href="./src/kthcloud_go_deploy_v2/resources/vms/vms.py">retrieve</a>(vm_id) -> <a href="./src/kthcloud_go_deploy_v2/types/vm_read.py">VmRead</a></code>
-- <code title="post /v2/vms/{vmId}">client.vms.<a href="./src/kthcloud_go_deploy_v2/resources/vms/vms.py">update</a>(vm_id, \*\*<a href="src/kthcloud_go_deploy_v2/types/vm_update_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v2/types/vm_updated.py">VmUpdated</a></code>
-- <code title="get /v2/vms">client.vms.<a href="./src/kthcloud_go_deploy_v2/resources/vms/vms.py">list</a>(\*\*<a href="src/kthcloud_go_deploy_v2/types/vm_list_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v2/types/vm_list_response.py">VmListResponse</a></code>
-- <code title="delete /v2/vms/{vmId}">client.vms.<a href="./src/kthcloud_go_deploy_v2/resources/vms/vms.py">delete</a>(vm_id) -> <a href="./src/kthcloud_go_deploy_v2/types/vm_deleted.py">VmDeleted</a></code>
+- <code title="post /v2/vms">client.vms.<a href="./src/kthcloud_go_deploy_v_/resources/vms/vms.py">create</a>(\*\*<a href="src/kthcloud_go_deploy_v_/types/vm_create_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v_/types/vm_created.py">VmCreated</a></code>
+- <code title="get /v2/vms/{vmId}">client.vms.<a href="./src/kthcloud_go_deploy_v_/resources/vms/vms.py">retrieve</a>(vm*id) -> <a href="./src/kthcloud_go_deploy_v*/types/vm_read.py">VmRead</a></code>
+- <code title="post /v2/vms/{vmId}">client.vms.<a href="./src/kthcloud_go_deploy_v_/resources/vms/vms.py">update</a>(vm*id, \*\*<a href="src/kthcloud_go_deploy_v*/types/vm*update_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v*/types/vm_updated.py">VmUpdated</a></code>
+- <code title="get /v2/vms">client.vms.<a href="./src/kthcloud_go_deploy_v_/resources/vms/vms.py">list</a>(\*\*<a href="src/kthcloud_go_deploy_v_/types/vm_list_params.py">params</a>) -> <a href="./src/kthcloud_go_deploy_v_/types/vm_list_response.py">VmListResponse</a></code>
+- <code title="delete /v2/vms/{vmId}">client.vms.<a href="./src/kthcloud_go_deploy_v_/resources/vms/vms.py">delete</a>(vm*id) -> <a href="./src/kthcloud_go_deploy_v*/types/vm_deleted.py">VmDeleted</a></code>
 
 ## Snapshot
 
 Methods:
 
-- <code title="delete /v2/vms/{vmId}/snapshot/{snapshotId}">client.vms.snapshot.<a href="./src/kthcloud_go_deploy_v2/resources/vms/snapshot.py">delete</a>(snapshot_id, \*, vm_id) -> <a href="./src/kthcloud_go_deploy_v2/types/vms/vm_snapshot_deleted.py">VmSnapshotDeleted</a></code>
+- <code title="delete /v2/vms/{vmId}/snapshot/{snapshotId}">client.vms.snapshot.<a href="./src/kthcloud_go_deploy_v_/resources/vms/snapshot.py">delete</a>(snapshot*id, \*, vm_id) -> <a href="./src/kthcloud_go_deploy_v*/types/vms/vm_snapshot_deleted.py">VmSnapshotDeleted</a></code>
 
 ## Snapshots
 
 Types:
 
 ```python
-from kthcloud_go_deploy_v2.types.vms import VmSnapshotDeleted
+from kthcloud_go_deploy_v_.types.vms import VmSnapshotDeleted
 ```

mypy.ini

@@ -5,7 +5,7 @@ show_error_codes = True
 # Exclude _files.py because mypy isn't smart enough to apply
 # the correct type narrowing and as this is an internal module
 # it's fine to just use Pyright.
-exclude = ^(src/kthcloud_go_deploy_v2/_files\.py|_dev/.*\.py)$
+exclude = ^(src/kthcloud_go_deploy_v_/_files\.py|_dev/.*\.py)$
 
 strict_equality = True
 implicit_reexport = True

pyproject.toml

@@ -84,7 +84,7 @@ typecheck = { chain = [
   "typecheck:mypy"
 ]}
 "typecheck:pyright" = "pyright"
-"typecheck:verify-types" = "pyright --verifytypes kthcloud_go_deploy_v2 --ignoreexternal"
+"typecheck:verify-types" = "pyright --verifytypes kthcloud_go_deploy_v_ --ignoreexternal"
 "typecheck:mypy" = "mypy ."
 
 [build-system]
@@ -97,7 +97,7 @@ include = [
 ]
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/kthcloud_go_deploy_v2"]
+packages = ["src/kthcloud_go_deploy_v_"]
 
 [tool.hatch.metadata.hooks.fancy-pypi-readme]
 content-type = "text/markdown"
@@ -187,7 +187,7 @@ length-sort = true
 length-sort-straight = true
 combine-as-imports = true
 extra-standard-library = ["typing_extensions"]
-known-first-party = ["kthcloud_go_deploy_v2", "tests"]
+known-first-party = ["kthcloud_go_deploy_v_", "tests"]
 
 [tool.ruff.per-file-ignores]
 "bin/**.py" = ["T201", "T203"]

release-please-config.json

@@ -61,6 +61,6 @@
   ],
   "release-type": "python",
   "extra-files": [
-    "src/kthcloud_go_deploy_v2/_version.py"
+    "src/kthcloud_go_deploy_v_/_version.py"
   ]
 }

requirements-dev.lock

@@ -59,9 +59,9 @@ pluggy==1.3.0
     # via pytest
 py==1.11.0
     # via pytest
-pydantic==2.4.2
+pydantic==2.7.1
     # via kthcloud
-pydantic-core==2.10.1
+pydantic-core==2.18.2
     # via pydantic
 pyright==1.1.359
 pytest==7.1.1

requirements.lock

@@ -29,9 +29,9 @@ httpx==0.25.2
 idna==3.4
     # via anyio
     # via httpx
-pydantic==2.4.2
+pydantic==2.7.1
     # via kthcloud
-pydantic-core==2.10.1
+pydantic-core==2.18.2
     # via pydantic
 sniffio==1.3.0
     # via anyio