intelion-cloud 0.2.3__tar.gz → 0.4.0__tar.gz

{intelion_cloud-0.2.3 → intelion_cloud-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intelion-cloud
-Version: 0.2.3
+Version: 0.4.0
 Summary: Python client for the Intelion Cloud API
 Author-email: Intelion Cloud <support@intelion.cloud>
 License-Expression: MIT

{intelion_cloud-0.2.3 → intelion_cloud-0.4.0}/intelion_cloud/__init__.py

@@ -27,11 +27,13 @@ from .models import (
     CPU,
     GPU,
     OSImage,
+    PasswordRotation,
     RAM,
     SSD,
     CloudServer,
     DebtInfo,
     Flavor,
+    FlavorSubstitution,
     PhysicalServer,
     Promocode,
     ServerStatus,
@@ -41,7 +43,7 @@ from .models import (
     WhiteIP,
 )
 
-__version__ = "0.2.3"
+__version__ = "0.4.0"
 
 __all__ = [
     # Clients
@@ -51,12 +53,14 @@ __all__ = [
     "CloudServer",
     "ServerStatus",
     "Flavor",
+    "FlavorSubstitution",
     "User",
     "GPU",
     "CPU",
     "RAM",
     "SSD",
     "OSImage",
+    "PasswordRotation",
     "UsageAct",
     "DebtInfo",
     "Promocode",

{intelion_cloud-0.2.3 → intelion_cloud-0.4.0}/intelion_cloud/models/__init__.py

@@ -1,11 +1,12 @@
 """Data models for the Intelion Cloud API."""
 
 from .components import CPU, GPU, OSImage, RAM, SSD
-from .flavors import Flavor
+from .flavors import Flavor, FlavorSubstitution
 from .servers import (
     CloudServer,
     DebtInfo,
     PhysicalServer,
+    PasswordRotation,
     Promocode,
     ServerStatus,
     SoftwareAddonInstance,
@@ -21,9 +22,11 @@ __all__ = [
     "SSD",
     "OSImage",
     "Flavor",
+    "FlavorSubstitution",
     "CloudServer",
     "DebtInfo",
     "PhysicalServer",
+    "PasswordRotation",
     "Promocode",
     "ServerStatus",
     "SoftwareAddonInstance",

{intelion_cloud-0.2.3 → intelion_cloud-0.4.0}/intelion_cloud/models/components.py

@@ -204,6 +204,8 @@ class OSImage:
     ssh_enabled: bool = False
     rdp_enabled: bool = False
     compatible_flavor_ids: Optional[List[int]] = None
+    cuda_version: Optional[str] = None
+    """CUDA version bundled in the image (e.g. ``"13.3"``); ``None`` if not applicable."""
 
     @classmethod
     def from_dict(cls, data: Dict[str, Any]) -> OSImage:
@@ -215,4 +217,5 @@ class OSImage:
             ssh_enabled=data.get("ssh_enabled", False),
             rdp_enabled=data.get("rdp_enabled", False),
             compatible_flavor_ids=data.get("compatible_flavor_ids"),
+            cuda_version=_get(data, "cuda_version"),
         )

intelion_cloud-0.4.0/intelion_cloud/models/flavors.py

@@ -0,0 +1,98 @@
+"""Flavor model — server hardware configuration (FlavorConfig)."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Dict, Optional
+
+from ._base import _get, _parse_nested
+from .components import CPU, GPU, RAM
+
+
+@dataclass(frozen=True)
+class FlavorSubstitution:
+    """A replacement flavor offered when the requested GPU is queue-disabled.
+
+    The API returns this instead of letting you queue for a card that is
+    fully leased out long-term — such a queue would never come up. Serialized
+    by ``servers.services.flavors._serialize_substitution`` on the server side.
+    """
+
+    flavor_id: int
+    flavor_name: str
+    gpu_id: int
+    gpu_slug: str
+    gpu_name: str
+    gpu_ram: int
+    gpu_count: int
+    cpu_id: int
+    cpu_count: int
+    ram_id: int
+    ram_count: int
+    monthly_price_rub_cents: int
+    hourly_price_rub_cents: int
+    exact_match: bool = True
+    """``False`` — no exact cpu/ram equivalent exists on the replacement card,
+    the closest one was picked. Surface this to the user rather than hiding it."""
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> FlavorSubstitution:
+        return cls(
+            flavor_id=data["flavor_id"],
+            flavor_name=data.get("flavor_name", ""),
+            gpu_id=data.get("gpu_id", 0),
+            gpu_slug=data.get("gpu_slug", ""),
+            gpu_name=data.get("gpu_name", ""),
+            gpu_ram=data.get("gpu_ram", 0),
+            gpu_count=data.get("gpu_count", 0),
+            cpu_id=data.get("cpu_id", 0),
+            cpu_count=data.get("cpu_count", 0),
+            ram_id=data.get("ram_id", 0),
+            ram_count=data.get("ram_count", 0),
+            monthly_price_rub_cents=data.get("monthly_price_rub_cents", 0),
+            hourly_price_rub_cents=data.get("hourly_price_rub_cents", 0),
+            exact_match=data.get("exact_match", True),
+        )
+
+
+@dataclass(frozen=True)
+class Flavor:
+    """A flavor describing a server hardware configuration template (backed by FlavorConfig)."""
+
+    id: int
+    name: str
+    cpu_count: int
+    ram_count: int
+    gpu_count: Optional[int]
+    flavor_monthly_price_rub_cents: int
+    flavor_hourly_price_rub_cents: int
+    max_available: int
+    openstack_id: Optional[str] = None
+    cpu: Optional[CPU] = None
+    ram: Optional[RAM] = None
+    gpu: Optional[GPU] = None
+    queue_disabled: bool = False
+    """The GPU is leased out long-term: queueing for it is refused (HTTP 409)."""
+    suggested_alternative: Optional[FlavorSubstitution] = None
+    """Set only when ``queue_disabled`` and ``max_available == 0`` — otherwise ``None``."""
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> Flavor:
+        return cls(
+            id=data["id"],
+            name=data.get("name", ""),
+            cpu_count=data.get("cpu_count", 0),
+            ram_count=data.get("ram_count", 0),
+            gpu_count=_get(data, "gpu_count"),
+            flavor_monthly_price_rub_cents=data.get("flavor_monthly_price_rub_cents", 0),
+            flavor_hourly_price_rub_cents=data.get("flavor_hourly_price_rub_cents", 0),
+            max_available=data.get("max_available", 0),
+            openstack_id=_get(data, "openstack_id"),
+            cpu=_parse_nested(data, "cpu", CPU),
+            ram=_parse_nested(data, "ram", RAM),
+            gpu=_parse_nested(data, "gpu", GPU),
+            queue_disabled=bool(data.get("queue_disabled", False)),
+            suggested_alternative=_parse_nested(
+                data, "suggested_alternative", FlavorSubstitution
+            ),
+        )

{intelion_cloud-0.2.3 → intelion_cloud-0.4.0}/intelion_cloud/models/servers.py

@@ -7,6 +7,30 @@ from typing import Any, Dict, List, Optional
 
 from ._base import _get, _parse_nested, _parse_nested_list
 from .components import CPU, GPU, OSImage, RAM, SSD
+from .flavors import FlavorSubstitution
+
+
+@dataclass(frozen=True)
+class PasswordRotation:
+    """Root password rotation notice for a server.
+
+    Present only as an accomplished fact: a pending rotation is deliberately
+    not exposed by the API. ``acknowledged`` is kept server-side so the notice
+    is not shown again from a different client.
+    """
+
+    status: str
+    """``"rotated"`` or ``"failed"``."""
+    rotated_at: Optional[str] = None
+    acknowledged: bool = False
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> PasswordRotation:
+        return cls(
+            status=data.get("status", ""),
+            rotated_at=_get(data, "rotated_at"),
+            acknowledged=data.get("acknowledged", False),
+        )
 
 
 @dataclass(frozen=True)
@@ -188,6 +212,14 @@ class CloudServer:
     total_network_disk_size: int = 0
     total_local_disk_size: int = 0
     max_available: int = 0
+    queue_disabled: bool = False
+    """This server's GPU is leased out long-term — queueing for it is refused."""
+    suggested_alternative: Optional[FlavorSubstitution] = None
+    """Replacement card offered when ``queue_disabled`` and capacity is zero."""
+    password_rotation: Optional[PasswordRotation] = None
+    """Set when the root password was rotated (or the rotation failed)."""
+    maintenance_reason: Optional[str] = None
+    """Customer-facing maintenance reason; ``None`` means the default wording."""
 
     @classmethod
     def from_dict(cls, data: Dict[str, Any]) -> CloudServer:
@@ -231,6 +263,12 @@ class CloudServer:
             total_network_disk_size=data.get("total_network_disk_size", 0),
             total_local_disk_size=data.get("total_local_disk_size", 0),
             max_available=data.get("max_available", 0),
+            queue_disabled=bool(data.get("queue_disabled", False)),
+            suggested_alternative=_parse_nested(
+                data, "suggested_alternative", FlavorSubstitution
+            ),
+            password_rotation=_parse_nested(data, "password_rotation", PasswordRotation),
+            maintenance_reason=_get(data, "maintenance_reason"),
         )
 
 

{intelion_cloud-0.2.3 → intelion_cloud-0.4.0}/intelion_cloud/resources/cloud_servers.py

@@ -137,6 +137,17 @@ class CloudServers(SyncResource):
         data = self._post(f"{_PATH}{server_id}/actions/", json={"status": -3})
         return CloudServer.from_dict(data)
 
+    def reinstall_os(self, server_id: int) -> CloudServer:
+        """Reinstall the OS on a server, wiping the boot disk.
+
+        All data on the boot disk is destroyed. The current monthly billing
+        cycle is preserved (the open UsageAct is reused). A new IP and root
+        password are generated and become available in the user panel a few
+        minutes after the call returns.
+        """
+        data = self._post(f"{_PATH}{server_id}/reinstall-os/")
+        return CloudServer.from_dict(data)
+
     # --- Info endpoints ---
 
     def get_status(self, server_id: int) -> ServerStatus:
@@ -264,6 +275,11 @@ class AsyncCloudServers(AsyncResource):
         data = await self._post(f"{_PATH}{server_id}/actions/", json={"status": -3})
         return CloudServer.from_dict(data)
 
+    async def reinstall_os(self, server_id: int) -> CloudServer:
+        """Reinstall the OS on a server, wiping the boot disk."""
+        data = await self._post(f"{_PATH}{server_id}/reinstall-os/")
+        return CloudServer.from_dict(data)
+
     async def get_status(self, server_id: int) -> ServerStatus:
         data = await self._get(f"{_PATH}{server_id}/status/")
         return ServerStatus.from_dict(data)

{intelion_cloud-0.2.3 → intelion_cloud-0.4.0}/intelion_cloud.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intelion-cloud
-Version: 0.2.3
+Version: 0.4.0
 Summary: Python client for the Intelion Cloud API
 Author-email: Intelion Cloud <support@intelion.cloud>
 License-Expression: MIT

{intelion_cloud-0.2.3 → intelion_cloud-0.4.0}/intelion_cloud.egg-info/SOURCES.txt

@@ -28,5 +28,6 @@ tests/test_client.py
 tests/test_cloud_servers.py
 tests/test_flavors.py
 tests/test_models.py
+tests/test_queue_and_rotation_fields.py
 tests/test_transport.py
 tests/test_users.py

{intelion_cloud-0.2.3 → intelion_cloud-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "intelion-cloud"
-version = "0.2.3"
+version = "0.4.0"
 description = "Python client for the Intelion Cloud API"
 readme = "README.md"
 license = "MIT"

{intelion_cloud-0.2.3 → intelion_cloud-0.4.0}/tests/test_cloud_servers.py

@@ -190,6 +190,16 @@ class TestCloudServersActions:
         assert server.status == -3
         client.close()
 
+    @respx.mock(base_url=API_URL)
+    def test_reinstall_os(self, respx_mock):
+        respx_mock.post("cloud-servers/42/reinstall-os/").respond(
+            200, json=SAMPLE_CLOUD_SERVER
+        )
+        client = IntelionCloud(token="tok", base_url=BASE_URL)
+        server = client.cloud_servers.reinstall_os(42)
+        assert server.id == SAMPLE_CLOUD_SERVER["id"]
+        client.close()
+
     @respx.mock(base_url=API_URL)
     def test_start_with_auto_renewal(self, respx_mock):
         respx_mock.post("cloud-servers/42/actions/").respond(

intelion_cloud-0.4.0/tests/test_queue_and_rotation_fields.py

@@ -0,0 +1,157 @@
+"""Fields the API v2 serializers return but the SDK used to drop silently.
+
+Server-side sources:
+  * ``queue_disabled`` / ``suggested_alternative`` — ``FlavorConfigSerializer``
+    and ``UserConfigurationSerializer`` (PR #526);
+  * ``password_rotation`` — ``UserConfigurationSerializer`` (incident 2026-07-29);
+  * ``maintenance_reason`` — ``UserConfiguration`` model field;
+  * ``cuda_version`` — ``OperationalSystemImageSerializer``.
+
+Note the shapes are asserted against the real serializers, not against the
+published OpenAPI schema: drf-spectacular types every ``SerializerMethodField``
+as ``string``, so the schema claims ``queue_disabled`` is a string and
+``suggested_alternative``/``password_rotation`` are strings too, while they are
+in fact a bool and two nested objects.
+"""
+
+from intelion_cloud.models import CloudServer, Flavor, FlavorSubstitution, OSImage
+
+SUBSTITUTION = {
+    "flavor_id": 42,
+    "flavor_name": "RTX 4090 x1",
+    "gpu_id": 7,
+    "gpu_slug": "nvidia-rtx-4090",
+    "gpu_name": "NVIDIA RTX 4090",
+    "gpu_ram": 24,
+    "gpu_count": 1,
+    "cpu_id": 3,
+    "cpu_count": 8,
+    "ram_id": 5,
+    "ram_count": 32,
+    "monthly_price_rub_cents": 4500000,
+    "hourly_price_rub_cents": 6800,
+    "exact_match": False,
+}
+
+
+class TestFlavorSubstitution:
+    def test_from_dict(self):
+        sub = FlavorSubstitution.from_dict(SUBSTITUTION)
+        assert sub.flavor_id == 42
+        assert sub.gpu_slug == "nvidia-rtx-4090"
+        assert sub.monthly_price_rub_cents == 4500000
+        assert sub.exact_match is False
+
+    def test_exact_match_defaults_to_true(self):
+        payload = {k: v for k, v in SUBSTITUTION.items() if k != "exact_match"}
+        assert FlavorSubstitution.from_dict(payload).exact_match is True
+
+
+class TestFlavorQueueFields:
+    def test_queue_disabled_with_alternative(self):
+        flavor = Flavor.from_dict({
+            "id": 1,
+            "name": "H100 x8",
+            "cpu_count": 64,
+            "ram_count": 512,
+            "gpu_count": 8,
+            "flavor_monthly_price_rub_cents": 100,
+            "flavor_hourly_price_rub_cents": 1,
+            "max_available": 0,
+            "queue_disabled": True,
+            "suggested_alternative": SUBSTITUTION,
+        })
+        assert flavor.queue_disabled is True
+        assert flavor.suggested_alternative is not None
+        assert flavor.suggested_alternative.flavor_name == "RTX 4090 x1"
+
+    def test_absent_fields_do_not_break_old_payloads(self):
+        """Старый сервер (или урезанный ответ) не должен ронять парсинг."""
+        flavor = Flavor.from_dict({
+            "id": 1,
+            "name": "A100 x1",
+            "cpu_count": 8,
+            "ram_count": 64,
+            "gpu_count": 1,
+            "flavor_monthly_price_rub_cents": 100,
+            "flavor_hourly_price_rub_cents": 1,
+            "max_available": 3,
+        })
+        assert flavor.queue_disabled is False
+        assert flavor.suggested_alternative is None
+
+    def test_null_alternative_stays_none(self):
+        flavor = Flavor.from_dict({
+            "id": 1,
+            "name": "A100 x1",
+            "cpu_count": 8,
+            "ram_count": 64,
+            "gpu_count": 1,
+            "flavor_monthly_price_rub_cents": 100,
+            "flavor_hourly_price_rub_cents": 1,
+            "max_available": 3,
+            "queue_disabled": True,
+            "suggested_alternative": None,
+        })
+        assert flavor.queue_disabled is True
+        assert flavor.suggested_alternative is None
+
+
+def _server(**extra):
+    base = {
+        "id": 8564,
+        "name": "srv",
+        "status": 1,
+        "price_plan": 1,
+        "is_auto_renewal": True,
+        "monthly_price_rub_cents": 100,
+        "hourly_price_rub_cents": 1,
+        "server_full_rent_price_rub_cents": 100,
+    }
+    base.update(extra)
+    return CloudServer.from_dict(base)
+
+
+class TestCloudServerNewFields:
+    def test_password_rotation_rotated(self):
+        srv = _server(password_rotation={
+            "status": "rotated",
+            "rotated_at": "2026-07-29T12:00:00+00:00",
+            "acknowledged": False,
+        })
+        assert srv.password_rotation is not None
+        assert srv.password_rotation.status == "rotated"
+        assert srv.password_rotation.rotated_at == "2026-07-29T12:00:00+00:00"
+        assert srv.password_rotation.acknowledged is False
+
+    def test_password_rotation_failed_without_timestamp(self):
+        srv = _server(password_rotation={"status": "failed", "rotated_at": None})
+        assert srv.password_rotation.status == "failed"
+        assert srv.password_rotation.rotated_at is None
+
+    def test_password_rotation_null_is_none(self):
+        assert _server(password_rotation=None).password_rotation is None
+
+    def test_maintenance_reason(self):
+        assert _server(maintenance_reason="Замена БП").maintenance_reason == "Замена БП"
+        assert _server(maintenance_reason=None).maintenance_reason is None
+        assert _server().maintenance_reason is None
+
+    def test_queue_fields(self):
+        srv = _server(queue_disabled=True, suggested_alternative=SUBSTITUTION)
+        assert srv.queue_disabled is True
+        assert srv.suggested_alternative.gpu_count == 1
+        assert _server().queue_disabled is False
+        assert _server().suggested_alternative is None
+
+
+class TestOSImageCudaVersion:
+    def test_cuda_version(self):
+        img = OSImage.from_dict({"id": 1, "name": "Ubuntu 24.04", "cuda_version": "13.3"})
+        assert img.cuda_version == "13.3"
+
+    def test_cuda_version_absent_or_null(self):
+        assert OSImage.from_dict({"id": 1, "name": "Windows"}).cuda_version is None
+        assert OSImage.from_dict(
+            {"id": 1, "name": "Windows", "cuda_version": None}
+        ).cuda_version is None

intelion_cloud-0.2.3/intelion_cloud/models/flavors.py

@@ -1,44 +0,0 @@
-"""Flavor model — server hardware configuration (FlavorConfig)."""
-
-from __future__ import annotations
-
-from dataclasses import dataclass
-from typing import Any, Dict, Optional
-
-from ._base import _get, _parse_nested
-from .components import CPU, GPU, RAM
-
-
-@dataclass(frozen=True)
-class Flavor:
-    """A flavor describing a server hardware configuration template (backed by FlavorConfig)."""
-
-    id: int
-    name: str
-    cpu_count: int
-    ram_count: int
-    gpu_count: Optional[int]
-    flavor_monthly_price_rub_cents: int
-    flavor_hourly_price_rub_cents: int
-    max_available: int
-    openstack_id: Optional[str] = None
-    cpu: Optional[CPU] = None
-    ram: Optional[RAM] = None
-    gpu: Optional[GPU] = None
-
-    @classmethod
-    def from_dict(cls, data: Dict[str, Any]) -> Flavor:
-        return cls(
-            id=data["id"],
-            name=data.get("name", ""),
-            cpu_count=data.get("cpu_count", 0),
-            ram_count=data.get("ram_count", 0),
-            gpu_count=_get(data, "gpu_count"),
-            flavor_monthly_price_rub_cents=data.get("flavor_monthly_price_rub_cents", 0),
-            flavor_hourly_price_rub_cents=data.get("flavor_hourly_price_rub_cents", 0),
-            max_available=data.get("max_available", 0),
-            openstack_id=_get(data, "openstack_id"),
-            cpu=_parse_nested(data, "cpu", CPU),
-            ram=_parse_nested(data, "ram", RAM),
-            gpu=_parse_nested(data, "gpu", GPU),
-        )