kc-sdk-python 3.0.0__tar.gz → 4.0.0__tar.gz

{kc_sdk_python-3.0.0/kc_sdk_python.egg-info → kc_sdk_python-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kc-sdk-python
-Version: 3.0.0
+Version: 4.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
@@ -45,6 +45,10 @@ 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.
 
+> **Using Claude Code?** This repo ships a [Claude Code skill](.claude/skills/kvindo-python-sdk/SKILL.md)
+> that teaches Claude how to script Kvindo Cloud with this SDK — clone this repo (or otherwise have
+> it on disk) and open Claude Code there to pick it up automatically.
+
 ## Install
 
 ```sh
@@ -59,6 +63,9 @@ Dependencies: `requests`, `marshmallow-dataclass`, `py-ulid`.
 from kc_api import KcClient
 
 client = KcClient("YOUR_API_TOKEN")  # api_url defaults to https://cloud-api.kvindo.ru
+# TLS certificate verification is on by default (verify_ssl=True). Pass
+# verify_ssl=False only to point this SDK at a genuinely self-hosted instance
+# with a self-signed cert.
 
 # List (label-filtered, paginated)
 resp = client.vms.get_by_labels({"env": "prod"}, max_page_size=50)
@@ -100,7 +107,9 @@ 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)).
+- **[kc-mcp-server](https://github.com/Kvindo/kc-mcp-server)** — MCP server for Kvindo Cloud ([npm](https://www.npmjs.com/package/kc-mcp-server)), for managing resources from Claude Desktop/Code and other MCP clients.
 - **[Kvindo Cloud console](https://cloud.kvindo.com)** — web UI and API.
+- **[Claude Code skill](.claude/skills/kvindo-python-sdk/SKILL.md)** — lets Claude script Kvindo Cloud with this SDK conversationally.
 
 ## License
 

{kc_sdk_python-3.0.0 → kc_sdk_python-4.0.0}/README.md

@@ -11,6 +11,10 @@ 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.
 
+> **Using Claude Code?** This repo ships a [Claude Code skill](.claude/skills/kvindo-python-sdk/SKILL.md)
+> that teaches Claude how to script Kvindo Cloud with this SDK — clone this repo (or otherwise have
+> it on disk) and open Claude Code there to pick it up automatically.
+
 ## Install
 
 ```sh
@@ -25,6 +29,9 @@ Dependencies: `requests`, `marshmallow-dataclass`, `py-ulid`.
 from kc_api import KcClient
 
 client = KcClient("YOUR_API_TOKEN")  # api_url defaults to https://cloud-api.kvindo.ru
+# TLS certificate verification is on by default (verify_ssl=True). Pass
+# verify_ssl=False only to point this SDK at a genuinely self-hosted instance
+# with a self-signed cert.
 
 # List (label-filtered, paginated)
 resp = client.vms.get_by_labels({"env": "prod"}, max_page_size=50)
@@ -66,7 +73,9 @@ 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)).
+- **[kc-mcp-server](https://github.com/Kvindo/kc-mcp-server)** — MCP server for Kvindo Cloud ([npm](https://www.npmjs.com/package/kc-mcp-server)), for managing resources from Claude Desktop/Code and other MCP clients.
 - **[Kvindo Cloud console](https://cloud.kvindo.com)** — web UI and API.
+- **[Claude Code skill](.claude/skills/kvindo-python-sdk/SKILL.md)** — lets Claude script Kvindo Cloud with this SDK conversationally.
 
 ## License
 

{kc_sdk_python-3.0.0 → kc_sdk_python-4.0.0}/kc_api.py

@@ -46,7 +46,7 @@ logger = logging.getLogger(__name__)
 # requests, marshmallow-dataclass and py-ulid.
 def create_http_client_with_retries(
     retry_statuses=[500, 502, 503, 504, 520, 521],
-    verify_ssl: bool = False,
+    verify_ssl: bool = True,
 ) -> requests.Session:
     """Build a `requests.Session` that retries idempotent failures with backoff.
 
@@ -55,8 +55,10 @@ def create_http_client_with_retries(
             server-side; 520 = web server returned an unknown error;
             521 = origin down (Cloudflare-specific).
         verify_ssl: enable/disable TLS certificate verification. Defaults to
-            False because internal/dev endpoints use self-signed certs; pass
-            True against public prod.
+            True — every real Kvindo Cloud API host (dev and public prod) has
+            a valid, publicly-trusted certificate. Pass False only to point
+            this SDK at a genuinely self-hosted instance with a self-signed
+            cert.
 
     Returns:
         A configured `requests.Session` (reuse it for connection pooling).
@@ -143,6 +145,10 @@ class KcApiModificationErrorCode(Enum):
     """deleteProtection=true; clear it before deleting."""
     BadData = "BadData"
     """Request was malformed."""
+    QuotaExceeded = "QuotaExceeded"
+    """The organization's quota for this resource type/parameter would be exceeded, counting
+    resources that are submitted but not yet reconciled ("holds"). Not retryable - the caller
+    must delete resources or raise the quota. HTTP 409."""
 
 
 @dataclass
@@ -285,7 +291,7 @@ class KcResourceGetByLabelsResponse(object):
 
 # HTTP statuses the API uses to carry a structured (deserializable) body. Anything
 # outside this set is an unexpected transport/server failure and is raised instead.
-_HANDLED_STATUS_CODES = [200, 400, 401, 403, 422]
+_HANDLED_STATUS_CODES = [200, 400, 401, 403, 409, 422]
 
 
 class KcResourceClient:
@@ -304,6 +310,7 @@ class KcResourceClient:
         token: str,
         api_url: str = "https://cloud-api.kvindo.ru",
         log_extra: dict = None,
+        verify_ssl: bool = True,
     ):
         """
         Args:
@@ -311,11 +318,16 @@ class KcResourceClient:
             token: the bearer token; a leading "Bearer " prefix is stripped if present.
             api_url: base URL of the Cloud API (no trailing slash).
             log_extra: optional dict merged into every debug log record's `extra`.
+            verify_ssl: enable/disable TLS certificate verification for every
+                request this client makes. Defaults to True; pass False only
+                to point this SDK at a genuinely self-hosted instance with a
+                self-signed cert.
         """
         self.__token = token.replace("Bearer ", "")
         self.__resource_type = resource_type
         self.__api_url = api_url
         self.__log_extra = log_extra if log_extra is not None else {}
+        self.__verify_ssl = verify_ssl
 
     def __headers(self) -> dict:
         """Standard auth + content-type headers for every request."""
@@ -342,7 +354,7 @@ class KcResourceClient:
         """
         url = f"{self.__api_url}/api/v1/{self.__resource_type}/{id}"
 
-        response = create_http_client_with_retries().delete(url, headers=self.__headers())
+        response = create_http_client_with_retries(verify_ssl=self.__verify_ssl).delete(url, headers=self.__headers())
 
         logger.debug(
             f"Got {response.status_code} status code while making request DELETE {url}\nResponse body: {response.text}",
@@ -376,7 +388,7 @@ class KcResourceClient:
         """
         url = f"{self.__api_url}/api/v1/{self.__resource_type}/{id}"
 
-        response = create_http_client_with_retries().get(url, headers=self.__headers())
+        response = create_http_client_with_retries(verify_ssl=self.__verify_ssl).get(url, headers=self.__headers())
 
         logger.debug(
             f"Got {response.status_code} status code while making request GET {url}\nResponse body: {response.text}",
@@ -418,7 +430,7 @@ class KcResourceClient:
         }
 
         url = create_url_with_query_params(url, params)
-        response = create_http_client_with_retries().get(url, headers=self.__headers())
+        response = create_http_client_with_retries(verify_ssl=self.__verify_ssl).get(url, headers=self.__headers())
 
         logger.debug(
             f"Got {response.status_code} status code while making request GET {url}\nResponse body: {response.text}",
@@ -447,7 +459,7 @@ class KcResourceClient:
         """
         url = f"{self.__api_url}/api/v1/{self.__resource_type}/request/{request_id}"
 
-        response = create_http_client_with_retries().get(url, headers=self.__headers())
+        response = create_http_client_with_retries(verify_ssl=self.__verify_ssl).get(url, headers=self.__headers())
 
         logger.debug(
             f"Got {response.status_code} status code while making request GET {url}\nResponse body: {response.text}",
@@ -533,7 +545,7 @@ class KcResourceClient:
 
         url = f"{self.__api_url}/api/v1/{self.__resource_type}"
 
-        response = create_http_client_with_retries().put(url, json=data, headers=self.__headers())
+        response = create_http_client_with_retries(verify_ssl=self.__verify_ssl).put(url, json=data, headers=self.__headers())
 
         logger.debug(
             f"Got {response.status_code} status code while making request PUT {url}\nRequest body: {data}\nResponse body: {response.text}",
@@ -624,18 +636,13 @@ class KcClient:
     kubernetes_node_groups: KcResourceClient
     kubernetes_users: KcResourceClient
     kubernetes_user_roles: KcResourceClient
-    postgresqls: KcResourceClient
     postgresql_standalones: KcResourceClient
-    postgresql_node_groups: KcResourceClient
     postgresql_parameters_sets: KcResourceClient
-    etcd: KcResourceClient
-    etcd_node_group: KcResourceClient
     open_vpns: KcResourceClient
     open_vpn_users: KcResourceClient
     open_vpn_user_settings: KcResourceClient
     gitlabs: KcResourceClient
     gitlab_runners: KcResourceClient
-    grafanas: KcResourceClient
     ollamas: KcResourceClient
 
     # IaM / org
@@ -658,6 +665,7 @@ class KcClient:
         token: str,
         api_url: str = "https://cloud-api.kvindo.ru",
         log_extra: dict = None,
+        verify_ssl: bool = True,
     ):
         """
         Args:
@@ -665,16 +673,21 @@ class KcClient:
             api_url: base URL of the Cloud API (no trailing slash).
             log_extra: optional dict merged into every debug log record's `extra`;
                 propagated to every per-resource client.
+            verify_ssl: enable/disable TLS certificate verification for every
+                request this client (and every per-resource client it builds)
+                makes. Defaults to True; pass False only to point this SDK at
+                a genuinely self-hosted instance with a self-signed cert.
         """
         self.__log_extra = log_extra if log_extra is not None else {}
         self.__token = token.replace("Bearer ", "")
         self.__api_url = api_url
+        self.__verify_ssl = verify_ssl
         # Cached response of get_transaction_collection_keys (lazy, fetched once).
         self._transaction_collection_keys = None
 
         def _r(resource_type: str) -> KcResourceClient:
-            """Build a per-type client sharing this client's token/url/log_extra."""
-            return KcResourceClient(resource_type, token, api_url, log_extra)
+            """Build a per-type client sharing this client's token/url/log_extra/verify_ssl."""
+            return KcResourceClient(resource_type, token, api_url, log_extra, verify_ssl)
 
         # Compute
         self.vms = _r("vm")
@@ -726,18 +739,13 @@ class KcClient:
         self.kubernetes_node_groups = _r("kubernetes-node-group")
         self.kubernetes_users = _r("kubernetes-user")
         self.kubernetes_user_roles = _r("kubernetes-user-role")
-        self.postgresqls = _r("postgresql")
         self.postgresql_standalones = _r("postgresql-standalone")
-        self.postgresql_node_groups = _r("postgresql-node-group")
         self.postgresql_parameters_sets = _r("postgresql-parameters-set")
-        self.etcd = _r("etcd")
-        self.etcd_node_group = _r("etcd-node-group")
         self.open_vpns = _r("open-vpn")
         self.open_vpn_users = _r("open-vpn-user")
         self.open_vpn_user_settings = _r("open-vpn-user-settings")
         self.gitlabs = _r("gitlab")
         self.gitlab_runners = _r("gitlab-runner")
-        self.grafanas = _r("grafana")
         self.ollamas = _r("ollama")
 
         # IaM / org
@@ -764,10 +772,22 @@ class KcClient:
 
         Returns:
             The raw list returned by the transaction-spec endpoint.
+
+        Raises:
+            Exception: on an unexpected HTTP status. Unlike the per-resource
+                methods, any non-200 here is treated as unhandled (this
+                endpoint has no typed error-code contract) — previously this
+                method cached whatever `.json()` returned regardless of status,
+                so a transient failure (e.g. an auth blip) got cached as if it
+                were the real key list, permanently, for this instance's life.
         """
         if self._transaction_collection_keys is None:
             url = f"{self.__api_url}/api/v1/internal/transaction-spec"
             headers = {"Authorization": f"Bearer {self.__token}"}
-            response = create_http_client_with_retries().get(url, headers=headers)
+            response = create_http_client_with_retries(verify_ssl=self.__verify_ssl).get(url, headers=headers)
+            if response.status_code != 200:
+                raise Exception(
+                    f"Got {response.status_code} status code while making request GET {url}\nResponse body: {response.text}"
+                )
             self._transaction_collection_keys = response.json()
         return self._transaction_collection_keys

{kc_sdk_python-3.0.0 → kc_sdk_python-4.0.0/kc_sdk_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kc-sdk-python
-Version: 3.0.0
+Version: 4.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
@@ -45,6 +45,10 @@ 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.
 
+> **Using Claude Code?** This repo ships a [Claude Code skill](.claude/skills/kvindo-python-sdk/SKILL.md)
+> that teaches Claude how to script Kvindo Cloud with this SDK — clone this repo (or otherwise have
+> it on disk) and open Claude Code there to pick it up automatically.
+
 ## Install
 
 ```sh
@@ -59,6 +63,9 @@ Dependencies: `requests`, `marshmallow-dataclass`, `py-ulid`.
 from kc_api import KcClient
 
 client = KcClient("YOUR_API_TOKEN")  # api_url defaults to https://cloud-api.kvindo.ru
+# TLS certificate verification is on by default (verify_ssl=True). Pass
+# verify_ssl=False only to point this SDK at a genuinely self-hosted instance
+# with a self-signed cert.
 
 # List (label-filtered, paginated)
 resp = client.vms.get_by_labels({"env": "prod"}, max_page_size=50)
@@ -100,7 +107,9 @@ 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)).
+- **[kc-mcp-server](https://github.com/Kvindo/kc-mcp-server)** — MCP server for Kvindo Cloud ([npm](https://www.npmjs.com/package/kc-mcp-server)), for managing resources from Claude Desktop/Code and other MCP clients.
 - **[Kvindo Cloud console](https://cloud.kvindo.com)** — web UI and API.
+- **[Claude Code skill](.claude/skills/kvindo-python-sdk/SKILL.md)** — lets Claude script Kvindo Cloud with this SDK conversationally.
 
 ## License
 

{kc_sdk_python-3.0.0 → kc_sdk_python-4.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kc-sdk-python"
-version = "3.0.0"
+version = "4.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"