kc-sdk-python 0.1.0__tar.gz → 1.0.0__tar.gz

kc_sdk_python-1.0.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: kc-sdk-python
+Version: 1.0.0
+Summary: Kvindo Cloud Python SDK — typed client for managing Kvindo Cloud infrastructure (VMs, S3, Kubernetes, load balancers, VPCs, PostgreSQL) via the REST API
+Author: Kvindo
+License-Expression: MIT
+Project-URL: Homepage, https://cloud.kvindo.com
+Project-URL: Repository, https://github.com/Kvindo/kc-sdk-python
+Project-URL: Documentation, https://github.com/Kvindo/kc-sdk-python#readme
+Project-URL: Bug Tracker, https://github.com/Kvindo/kc-sdk-python/issues
+Keywords: kvindo,kvindo-cloud,cloud,cloud-api,iaas,infrastructure,infrastructure-as-code,sdk,api-client,rest-api,devops,vm,kubernetes,s3,object-storage,load-balancer,vpc,postgresql
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Internet
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: marshmallow-dataclass
+Requires-Dist: py-ulid
+Dynamic: license-file
+
+# kc-sdk-python — Kvindo Cloud Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/kc-sdk-python)](https://pypi.org/project/kc-sdk-python/)
+[![Python versions](https://img.shields.io/pypi/pyversions/kc-sdk-python)](https://pypi.org/project/kc-sdk-python/)
+[![License: MIT](https://img.shields.io/pypi/l/kc-sdk-python)](LICENSE)
+
+Official **Python SDK / client for the [Kvindo Cloud](https://cloud.kvindo.com) API** — manage
+cloud infrastructure as code from Python: VMs, volumes, S3 object storage, Kubernetes, load
+balancers, VPCs, VPNs, and managed PostgreSQL.
+
+A thin, typed client over the REST API: one resource client per resource type, all sharing the
+same create / read / update / delete / list contract.
+
+## Install
+
+```sh
+pip install kc-sdk-python
+```
+
+Dependencies: `requests`, `marshmallow-dataclass`, `py-ulid`.
+
+## Usage
+
+```python
+from kc_api import KcClient
+
+client = KcClient("YOUR_API_TOKEN")  # api_url defaults to https://cloud-api.kvindo.ru
+
+# List (label-filtered, paginated)
+resp = client.vms.get_by_labels({"env": "prod"}, max_page_size=50)
+for vm in resp.resources:
+    print(vm["metadata"]["name"])
+
+# Read one
+vm = client.vms.read("01H...")
+print(vm.resource)
+
+# Create / update (async) then wait for it to reconcile
+created = client.vms.create_or_update({
+    "metadata": {"name": "my-vm", "folderId": "01H..."},
+    "spec": {"offerId": "g3-1c2-100", "state": "running", ...},
+})
+status = client.vms.wait_request_satisfied(created.requestId, timeout_seconds=300)
+assert status.succeeded
+
+# Delete (optionally block until reconciled)
+client.vms.delete("01H...", wait=True)
+```
+
+Create / update / delete are **asynchronous**: they return a `requestId`; poll
+`read_request(requestId)` or use `wait_request_satisfied(...)`. Every response
+object carries `errorMessage` / `errorCode` (a typed `KcApi*ErrorCode`) which are
+`None` on success.
+
+### Available resources
+
+`KcClient` exposes one `KcResourceClient` per type, e.g. `client.vms`,
+`client.volumes`, `client.s3_buckets`, `client.kubernetes`,
+`client.load_balancers`, `client.vpcs`, `client.postgresql_standalones`,
+`client.folders`, `client.transactions`, … (the surface mirrors the official
+Kvindo Cloud API).
+
+## Related projects
+
+Part of the Kvindo Cloud developer toolchain:
+
+- **[kc CLI](https://github.com/Kvindo/kc-cli)** — kubectl-style command-line client for Kvindo Cloud.
+- **[terraform-provider-kvindo](https://github.com/Kvindo/terraform-provider-kvindo)** — Terraform provider ([Registry](https://registry.terraform.io/providers/kvindo/kvindo/latest)).
+- **[Kvindo Cloud console](https://cloud.kvindo.com)** — web UI and API.
+
+## License
+
+MIT

kc_sdk_python-0.1.0/kc_sdk_python.egg-info/PKG-INFO → kc_sdk_python-1.0.0/README.md

@@ -1,30 +1,15 @@
-Metadata-Version: 2.4
-Name: kc-sdk-python
-Version: 0.1.0
-Summary: Python SDK / client for the Kvindo Cloud API
-Author: Kvindo
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/Kvindo/kc-sdk-python
-Project-URL: Repository, https://github.com/Kvindo/kc-sdk-python
-Keywords: kvindo,cloud,sdk,client,api
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Classifier: Intended Audience :: Developers
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests
-Requires-Dist: marshmallow-dataclass
-Requires-Dist: py-ulid
-Dynamic: license-file
-
-# kc-sdk-python
-
-Python SDK / client for the **Kvindo Cloud API**.
-
-A thin, typed client over the REST API: one resource client per resource type
-(VMs, volumes, load balancers, kubernetes, S3, VPCs, …), all sharing the same
-create / read / update / delete / list contract.
+# kc-sdk-python — Kvindo Cloud Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/kc-sdk-python)](https://pypi.org/project/kc-sdk-python/)
+[![Python versions](https://img.shields.io/pypi/pyversions/kc-sdk-python)](https://pypi.org/project/kc-sdk-python/)
+[![License: MIT](https://img.shields.io/pypi/l/kc-sdk-python)](LICENSE)
+
+Official **Python SDK / client for the [Kvindo Cloud](https://cloud.kvindo.com) API** — manage
+cloud infrastructure as code from Python: VMs, volumes, S3 object storage, Kubernetes, load
+balancers, VPCs, VPNs, and managed PostgreSQL.
+
+A thin, typed client over the REST API: one resource client per resource type, all sharing the
+same create / read / update / delete / list contract.
 
 ## Install
 
@@ -75,6 +60,14 @@ object carries `errorMessage` / `errorCode` (a typed `KcApi*ErrorCode`) which ar
 `client.folders`, `client.transactions`, … (the surface mirrors the official
 Kvindo Cloud API).
 
+## Related projects
+
+Part of the Kvindo Cloud developer toolchain:
+
+- **[kc CLI](https://github.com/Kvindo/kc-cli)** — kubectl-style command-line client for Kvindo Cloud.
+- **[terraform-provider-kvindo](https://github.com/Kvindo/terraform-provider-kvindo)** — Terraform provider ([Registry](https://registry.terraform.io/providers/kvindo/kvindo/latest)).
+- **[Kvindo Cloud console](https://cloud.kvindo.com)** — web UI and API.
+
 ## License
 
 MIT

{kc_sdk_python-0.1.0 → kc_sdk_python-1.0.0}/kc_api.py

@@ -520,13 +520,16 @@ class KcResourceClient:
 
         # Inject a ULID id when absent so the call is idempotent and the caller can
         # poll the returned requestId. Two body shapes are supported:
+        # py-ulid's ULID has no __str__/__repr__ override, so str(ULID()) yields
+        # "<ulid.ulid.ULID object at 0x...>" instead of the Crockford-base32 string the
+        # API requires — always use .generate() to get the actual string form.
         if "metadata" in data:
             # Envelope shape: id lives under metadata.
             if "id" not in data["metadata"] or not data["metadata"]["id"]:
-                data["metadata"]["id"] = str(ULID())
+                data["metadata"]["id"] = ULID().generate()
         elif "id" not in data or not data["id"]:
             # Flat shape: id at the top level.
-            data["id"] = str(ULID())
+            data["id"] = ULID().generate()
 
         url = f"{self.__api_url}/api/v1/{self.__resource_type}"
 
@@ -594,7 +597,6 @@ class KcClient:
     route_table_attachments: KcResourceClient
     route_table_routes: KcResourceClient
     security_groups: KcResourceClient
-    nat_gateways: KcResourceClient
 
     # Load balancer
     load_balancers: KcResourceClient
@@ -634,7 +636,6 @@ class KcClient:
     gitlabs: KcResourceClient
     gitlab_runners: KcResourceClient
     grafanas: KcResourceClient
-    victoria_metrics: KcResourceClient
     ollamas: KcResourceClient
 
     # IaM / org
@@ -698,7 +699,6 @@ class KcClient:
         self.route_table_attachments = _r("route-table-attachment")
         self.route_table_routes = _r("route-table-route")
         self.security_groups = _r("security-group")
-        self.nat_gateways = _r("nat-gateway")
 
         # Load balancer
         self.load_balancers = _r("loadbalancer")
@@ -738,7 +738,6 @@ class KcClient:
         self.gitlabs = _r("gitlab")
         self.gitlab_runners = _r("gitlab-runner")
         self.grafanas = _r("grafana")
-        self.victoria_metrics = _r("victoria-metrics")
         self.ollamas = _r("ollama")
 
         # IaM / org

kc_sdk_python-1.0.0/kc_sdk_python.egg-info/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: kc-sdk-python
+Version: 1.0.0
+Summary: Kvindo Cloud Python SDK — typed client for managing Kvindo Cloud infrastructure (VMs, S3, Kubernetes, load balancers, VPCs, PostgreSQL) via the REST API
+Author: Kvindo
+License-Expression: MIT
+Project-URL: Homepage, https://cloud.kvindo.com
+Project-URL: Repository, https://github.com/Kvindo/kc-sdk-python
+Project-URL: Documentation, https://github.com/Kvindo/kc-sdk-python#readme
+Project-URL: Bug Tracker, https://github.com/Kvindo/kc-sdk-python/issues
+Keywords: kvindo,kvindo-cloud,cloud,cloud-api,iaas,infrastructure,infrastructure-as-code,sdk,api-client,rest-api,devops,vm,kubernetes,s3,object-storage,load-balancer,vpc,postgresql
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Internet
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: marshmallow-dataclass
+Requires-Dist: py-ulid
+Dynamic: license-file
+
+# kc-sdk-python — Kvindo Cloud Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/kc-sdk-python)](https://pypi.org/project/kc-sdk-python/)
+[![Python versions](https://img.shields.io/pypi/pyversions/kc-sdk-python)](https://pypi.org/project/kc-sdk-python/)
+[![License: MIT](https://img.shields.io/pypi/l/kc-sdk-python)](LICENSE)
+
+Official **Python SDK / client for the [Kvindo Cloud](https://cloud.kvindo.com) API** — manage
+cloud infrastructure as code from Python: VMs, volumes, S3 object storage, Kubernetes, load
+balancers, VPCs, VPNs, and managed PostgreSQL.
+
+A thin, typed client over the REST API: one resource client per resource type, all sharing the
+same create / read / update / delete / list contract.
+
+## Install
+
+```sh
+pip install kc-sdk-python
+```
+
+Dependencies: `requests`, `marshmallow-dataclass`, `py-ulid`.
+
+## Usage
+
+```python
+from kc_api import KcClient
+
+client = KcClient("YOUR_API_TOKEN")  # api_url defaults to https://cloud-api.kvindo.ru
+
+# List (label-filtered, paginated)
+resp = client.vms.get_by_labels({"env": "prod"}, max_page_size=50)
+for vm in resp.resources:
+    print(vm["metadata"]["name"])
+
+# Read one
+vm = client.vms.read("01H...")
+print(vm.resource)
+
+# Create / update (async) then wait for it to reconcile
+created = client.vms.create_or_update({
+    "metadata": {"name": "my-vm", "folderId": "01H..."},
+    "spec": {"offerId": "g3-1c2-100", "state": "running", ...},
+})
+status = client.vms.wait_request_satisfied(created.requestId, timeout_seconds=300)
+assert status.succeeded
+
+# Delete (optionally block until reconciled)
+client.vms.delete("01H...", wait=True)
+```
+
+Create / update / delete are **asynchronous**: they return a `requestId`; poll
+`read_request(requestId)` or use `wait_request_satisfied(...)`. Every response
+object carries `errorMessage` / `errorCode` (a typed `KcApi*ErrorCode`) which are
+`None` on success.
+
+### Available resources
+
+`KcClient` exposes one `KcResourceClient` per type, e.g. `client.vms`,
+`client.volumes`, `client.s3_buckets`, `client.kubernetes`,
+`client.load_balancers`, `client.vpcs`, `client.postgresql_standalones`,
+`client.folders`, `client.transactions`, … (the surface mirrors the official
+Kvindo Cloud API).
+
+## Related projects
+
+Part of the Kvindo Cloud developer toolchain:
+
+- **[kc CLI](https://github.com/Kvindo/kc-cli)** — kubectl-style command-line client for Kvindo Cloud.
+- **[terraform-provider-kvindo](https://github.com/Kvindo/terraform-provider-kvindo)** — Terraform provider ([Registry](https://registry.terraform.io/providers/kvindo/kvindo/latest)).
+- **[Kvindo Cloud console](https://cloud.kvindo.com)** — web UI and API.
+
+## License
+
+MIT

kc_sdk_python-1.0.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["setuptools>=77.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kc-sdk-python"
+version = "1.0.0"
+description = "Kvindo Cloud Python SDK — typed client for managing Kvindo Cloud infrastructure (VMs, S3, Kubernetes, load balancers, VPCs, PostgreSQL) via the REST API"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Kvindo" }]
+keywords = [
+    "kvindo",
+    "kvindo-cloud",
+    "cloud",
+    "cloud-api",
+    "iaas",
+    "infrastructure",
+    "infrastructure-as-code",
+    "sdk",
+    "api-client",
+    "rest-api",
+    "devops",
+    "vm",
+    "kubernetes",
+    "s3",
+    "object-storage",
+    "load-balancer",
+    "vpc",
+    "postgresql",
+]
+dependencies = [
+    "requests",
+    "marshmallow-dataclass",
+    "py-ulid",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Internet",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://cloud.kvindo.com"
+Repository = "https://github.com/Kvindo/kc-sdk-python"
+Documentation = "https://github.com/Kvindo/kc-sdk-python#readme"
+"Bug Tracker" = "https://github.com/Kvindo/kc-sdk-python/issues"
+
+[tool.setuptools]
+py-modules = ["kc_api"]

kc_sdk_python-0.1.0/PKG-INFO

@@ -1,80 +0,0 @@
-Metadata-Version: 2.4
-Name: kc-sdk-python
-Version: 0.1.0
-Summary: Python SDK / client for the Kvindo Cloud API
-Author: Kvindo
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/Kvindo/kc-sdk-python
-Project-URL: Repository, https://github.com/Kvindo/kc-sdk-python
-Keywords: kvindo,cloud,sdk,client,api
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Classifier: Intended Audience :: Developers
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests
-Requires-Dist: marshmallow-dataclass
-Requires-Dist: py-ulid
-Dynamic: license-file
-
-# kc-sdk-python
-
-Python SDK / client for the **Kvindo Cloud API**.
-
-A thin, typed client over the REST API: one resource client per resource type
-(VMs, volumes, load balancers, kubernetes, S3, VPCs, …), all sharing the same
-create / read / update / delete / list contract.
-
-## Install
-
-```sh
-pip install kc-sdk-python
-```
-
-Dependencies: `requests`, `marshmallow-dataclass`, `py-ulid`.
-
-## Usage
-
-```python
-from kc_api import KcClient
-
-client = KcClient("YOUR_API_TOKEN")  # api_url defaults to https://cloud-api.kvindo.ru
-
-# List (label-filtered, paginated)
-resp = client.vms.get_by_labels({"env": "prod"}, max_page_size=50)
-for vm in resp.resources:
-    print(vm["metadata"]["name"])
-
-# Read one
-vm = client.vms.read("01H...")
-print(vm.resource)
-
-# Create / update (async) then wait for it to reconcile
-created = client.vms.create_or_update({
-    "metadata": {"name": "my-vm", "folderId": "01H..."},
-    "spec": {"offerId": "g3-1c2-100", "state": "running", ...},
-})
-status = client.vms.wait_request_satisfied(created.requestId, timeout_seconds=300)
-assert status.succeeded
-
-# Delete (optionally block until reconciled)
-client.vms.delete("01H...", wait=True)
-```
-
-Create / update / delete are **asynchronous**: they return a `requestId`; poll
-`read_request(requestId)` or use `wait_request_satisfied(...)`. Every response
-object carries `errorMessage` / `errorCode` (a typed `KcApi*ErrorCode`) which are
-`None` on success.
-
-### Available resources
-
-`KcClient` exposes one `KcResourceClient` per type, e.g. `client.vms`,
-`client.volumes`, `client.s3_buckets`, `client.kubernetes`,
-`client.load_balancers`, `client.vpcs`, `client.postgresql_standalones`,
-`client.folders`, `client.transactions`, … (the surface mirrors the official
-Kvindo Cloud API).
-
-## License
-
-MIT

kc_sdk_python-0.1.0/README.md

@@ -1,60 +0,0 @@
-# kc-sdk-python
-
-Python SDK / client for the **Kvindo Cloud API**.
-
-A thin, typed client over the REST API: one resource client per resource type
-(VMs, volumes, load balancers, kubernetes, S3, VPCs, …), all sharing the same
-create / read / update / delete / list contract.
-
-## Install
-
-```sh
-pip install kc-sdk-python
-```
-
-Dependencies: `requests`, `marshmallow-dataclass`, `py-ulid`.
-
-## Usage
-
-```python
-from kc_api import KcClient
-
-client = KcClient("YOUR_API_TOKEN")  # api_url defaults to https://cloud-api.kvindo.ru
-
-# List (label-filtered, paginated)
-resp = client.vms.get_by_labels({"env": "prod"}, max_page_size=50)
-for vm in resp.resources:
-    print(vm["metadata"]["name"])
-
-# Read one
-vm = client.vms.read("01H...")
-print(vm.resource)
-
-# Create / update (async) then wait for it to reconcile
-created = client.vms.create_or_update({
-    "metadata": {"name": "my-vm", "folderId": "01H..."},
-    "spec": {"offerId": "g3-1c2-100", "state": "running", ...},
-})
-status = client.vms.wait_request_satisfied(created.requestId, timeout_seconds=300)
-assert status.succeeded
-
-# Delete (optionally block until reconciled)
-client.vms.delete("01H...", wait=True)
-```
-
-Create / update / delete are **asynchronous**: they return a `requestId`; poll
-`read_request(requestId)` or use `wait_request_satisfied(...)`. Every response
-object carries `errorMessage` / `errorCode` (a typed `KcApi*ErrorCode`) which are
-`None` on success.
-
-### Available resources
-
-`KcClient` exposes one `KcResourceClient` per type, e.g. `client.vms`,
-`client.volumes`, `client.s3_buckets`, `client.kubernetes`,
-`client.load_balancers`, `client.vpcs`, `client.postgresql_standalones`,
-`client.folders`, `client.transactions`, … (the surface mirrors the official
-Kvindo Cloud API).
-
-## License
-
-MIT

kc_sdk_python-0.1.0/pyproject.toml

@@ -1,31 +0,0 @@
-[build-system]
-requires = ["setuptools>=77.0"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "kc-sdk-python"
-version = "0.1.0"
-description = "Python SDK / client for the Kvindo Cloud API"
-readme = "README.md"
-requires-python = ">=3.8"
-license = "MIT"
-license-files = ["LICENSE"]
-authors = [{ name = "Kvindo" }]
-keywords = ["kvindo", "cloud", "sdk", "client", "api"]
-dependencies = [
-    "requests",
-    "marshmallow-dataclass",
-    "py-ulid",
-]
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "Operating System :: OS Independent",
-    "Intended Audience :: Developers",
-]
-
-[project.urls]
-Homepage = "https://github.com/Kvindo/kc-sdk-python"
-Repository = "https://github.com/Kvindo/kc-sdk-python"
-
-[tool.setuptools]
-py-modules = ["kc_api"]