axis 73__tar.gz → 75__tar.gz

{axis-73 → axis-75}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: axis
-Version: 73
+Version: 75
 Summary: A Python library for communicating with devices from Axis Communications
 Author-email: Robert Svensson <Kane610@users.noreply.github.com>
 License: MIT
@@ -17,30 +17,30 @@ Classifier: Topic :: Home Automation
 Requires-Python: >=3.14.0
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiohttp>=3.12
+Requires-Dist: aiohttp>=3.14.0
 Requires-Dist: faust-cchardet>=2.1.18
 Requires-Dist: orjson>3.9
 Requires-Dist: packaging>23
 Requires-Dist: tomli>=2.0
 Requires-Dist: tomli-w>=1.0
 Requires-Dist: xmltodict>=0.13.0
-Requires-Dist: zeroconf==0.150.0
+Requires-Dist: zeroconf>=0.150.0
 Provides-Extra: requirements
-Requires-Dist: aiohttp==3.14.1; extra == "requirements"
-Requires-Dist: orjson==3.11.9; extra == "requirements"
-Requires-Dist: packaging==26.2; extra == "requirements"
+Requires-Dist: aiohttp==3.14.5; extra == "requirements"
+Requires-Dist: orjson==3.13.0; extra == "requirements"
+Requires-Dist: packaging==26.3; extra == "requirements"
 Requires-Dist: xmltodict==1.0.4; extra == "requirements"
-Requires-Dist: zeroconf==0.150.0; extra == "requirements"
+Requires-Dist: zeroconf>=0.150.0; extra == "requirements"
 Provides-Extra: requirements-test
-Requires-Dist: mypy==2.1.0; extra == "requirements-test"
-Requires-Dist: pytest==9.1.1; extra == "requirements-test"
+Requires-Dist: mypy==2.4.1; extra == "requirements-test"
+Requires-Dist: pytest==9.2.0; extra == "requirements-test"
 Requires-Dist: pytest-aiohttp==1.1.1; extra == "requirements-test"
-Requires-Dist: pytest-asyncio==1.4.0; extra == "requirements-test"
+Requires-Dist: pytest-asyncio==1.4.1.post1; extra == "requirements-test"
 Requires-Dist: pytest-cov==7.1.0; extra == "requirements-test"
-Requires-Dist: ruff==0.15.20; extra == "requirements-test"
+Requires-Dist: ruff==0.17.4; extra == "requirements-test"
 Requires-Dist: types-xmltodict==v1.0.1.20260518; extra == "requirements-test"
 Provides-Extra: requirements-dev
-Requires-Dist: pre-commit==4.6.0; extra == "requirements-dev"
+Requires-Dist: pre-commit==4.7.0; extra == "requirements-dev"
 Dynamic: license-file
 
 # axis
@@ -62,11 +62,11 @@ Or run the bootstrap script, which installs `uv` if needed and provisions Python
 ./setup.sh
 ```
 
-Dependencies are locked via `uv.lock`. Regenerate lock data when dependency inputs change:
-
-```bash
-uv lock
-```
+Dependencies are locked via `uv.lock`. The pre-commit hook installed by `./setup.sh`
+automatically refreshes it when `pyproject.toml` or `uv.lock` is included in a commit.
+If the hook modifies it, include the updated lockfile when retrying the commit.
+CI rejects stale or missing lockfiles, even when local hooks are bypassed, and
+runs checks with `--locked` to prevent implicit lockfile updates.
 
 Run checks with `uv`:
 
@@ -77,6 +77,14 @@ uv run mypy axis
 uv run pytest
 ```
 
+Pull requests expose independent **Lint**, **Formatting**, **Typing**, and
+**Tests (Python 3.14)** checks in GitHub. A failed check does not prevent the
+others from running. Ruff lint findings also appear as file-and-line annotations.
+The test job uploads JUnit XML and XML/HTML coverage reports as the
+`test-reports-python-3.14` artifact, including when tests fail.
+The workflow run summary shows the test outcome, counts, duration, line coverage,
+and configured coverage threshold. Missing reports are flagged explicitly.
+
 Initial `ty` support is configured as an opt-in check and does not replace `mypy`:
 
 ```bash
@@ -123,12 +131,12 @@ Examples:
 ```python
 @dataclass
 class ListApisRequest(ApiRequest[GetAllApisResponse]):
-	response_type = GetAllApisResponse
+    response_type = GetAllApisResponse
 
 
 @dataclass
 class SetPortsRequest(ApiRequest[ApiResponse[bytes]]):
-	response_type = BytesResponse
+    response_type = BytesResponse
 ```
 
 Handler methods may unwrap `.data` when they intentionally preserve a bytes-returning boundary.

{axis-73 → axis-75}/README.md

@@ -17,11 +17,11 @@ Or run the bootstrap script, which installs `uv` if needed and provisions Python
 ./setup.sh
 ```
 
-Dependencies are locked via `uv.lock`. Regenerate lock data when dependency inputs change:
-
-```bash
-uv lock
-```
+Dependencies are locked via `uv.lock`. The pre-commit hook installed by `./setup.sh`
+automatically refreshes it when `pyproject.toml` or `uv.lock` is included in a commit.
+If the hook modifies it, include the updated lockfile when retrying the commit.
+CI rejects stale or missing lockfiles, even when local hooks are bypassed, and
+runs checks with `--locked` to prevent implicit lockfile updates.
 
 Run checks with `uv`:
 
@@ -32,6 +32,14 @@ uv run mypy axis
 uv run pytest
 ```
 
+Pull requests expose independent **Lint**, **Formatting**, **Typing**, and
+**Tests (Python 3.14)** checks in GitHub. A failed check does not prevent the
+others from running. Ruff lint findings also appear as file-and-line annotations.
+The test job uploads JUnit XML and XML/HTML coverage reports as the
+`test-reports-python-3.14` artifact, including when tests fail.
+The workflow run summary shows the test outcome, counts, duration, line coverage,
+and configured coverage threshold. Missing reports are flagged explicitly.
+
 Initial `ty` support is configured as an opt-in check and does not replace `mypy`:
 
 ```bash
@@ -78,12 +86,12 @@ Examples:
 ```python
 @dataclass
 class ListApisRequest(ApiRequest[GetAllApisResponse]):
-	response_type = GetAllApisResponse
+    response_type = GetAllApisResponse
 
 
 @dataclass
 class SetPortsRequest(ApiRequest[ApiResponse[bytes]]):
-	response_type = BytesResponse
+    response_type = BytesResponse
 ```
 
 Handler methods may unwrap `.data` when they intentionally preserve a bytes-returning boundary.

{axis-73 → axis-75}/axis/cli/core/router.py

@@ -42,7 +42,7 @@ class CliRouter:
 
     async def run(
         self, ctx: CliContext, io: CliIO, start_node_id: str = "main"
-    ) -> None:
+    ) -> bool:
         current = start_node_id
         while True:
             node = self.nodes[current]
@@ -57,7 +57,7 @@ class CliRouter:
 
             if selection == "e":
                 io.write("Exiting.")
-                raise SystemExit(0)
+                return True
             if selection == "b":
                 if node.parent_id is None:
                     continue
@@ -92,9 +92,16 @@ class CliRouter:
                     io.write(f"Unknown command: {matched.command_id}")
                     continue
 
-                result = await command.run(ctx, io)
+                try:
+                    result = await command.run(ctx, io)
+                except SystemExit as exc:
+                    if exc.code == 0:
+                        return True
+                    raise
                 payload = result.payload
                 if result.status == "ok" and isinstance(payload, dict):
+                    if payload.get("exit") is True:
+                        return True
                     requested_node = payload.get("next_node_id")
                     if isinstance(requested_node, str):
                         if requested_node in self.nodes:

{axis-73 → axis-75}/axis/cli/main.py

@@ -144,10 +144,14 @@ def main(*, debug: bool | None = None) -> None:
     terminal_io = TerminalIO()
     while True:
         try:
-            asyncio.run(runtime.router.run(runtime, terminal_io, start_node_id="main"))
+            should_exit = asyncio.run(
+                runtime.router.run(runtime, terminal_io, start_node_id="main")
+            )
         except KeyboardInterrupt:
             print("\nInterrupted. Use 'e' to exit.")  # noqa: T201
             continue
+        if should_exit:
+            return
 
 
 __all__ = [

{axis-73 → axis-75}/axis/cli/packs/events.py

@@ -19,7 +19,9 @@ from axis.cli.packs.devices import (
 )
 from axis.device import AxisDevice
 from axis.errors import RequestError
-from axis.models.configuration import Configuration
+from axis.models.configuration import Configuration, WebProtocol
+from axis.rtsp import RTSPClient, Signal
+from axis.websocket import WebSocketClient
 
 if TYPE_CHECKING:
     from axis.cli.core.context import CliContext
@@ -54,6 +56,31 @@ def _debug_dump(label: str, payload: object) -> None:
         print(f"[debug] {label}:\n{pformat(payload)}")  # noqa: T201
 
 
+def _event_stream_details(device: AxisDevice) -> tuple[str, str]:
+    if device.stream.use_websocket:
+        if device.config.web_proto == WebProtocol.HTTPS:
+            verification = "enabled" if device.config.verify_ssl else "disabled"
+            return (
+                "WebSocket over WSS",
+                f"TLS encrypted; certificate verification {verification}; session-token authentication.",
+            )
+        return "WebSocket over WS", "Unencrypted; session-token authentication."
+
+    return "RTSP", "Unencrypted; authentication is negotiated when connected."
+
+
+def _event_authentication_details(device: AxisDevice) -> str:
+    stream = device.stream.stream
+    if isinstance(stream, WebSocketClient):
+        return stream.authentication or "Negotiating"
+    if isinstance(stream, RTSPClient):
+        if stream.session.digest:
+            return "Digest"
+        if stream.session.basic:
+            return "Basic"
+    return "Negotiating"
+
+
 def _render_events_node(ctx: CliContext, io: CliIO) -> None:
     if ctx.selected_serial is None or ctx.selected_device is None:
         io.write("\nNo selected device.")
@@ -176,6 +203,7 @@ async def _live_listen_async(
                 host=credentials["host"],
                 username=credentials["username"],
                 password=credentials["password"],
+                websocket_enabled=True,
             )
             device = AxisDevice(config)
 
@@ -186,13 +214,28 @@ async def _live_listen_async(
                 callback=_on_event,
                 id_filter=topic_filter,
             )
+
+            def _on_connection_status(signal: Signal) -> None:
+                if signal == Signal.PLAYING:
+                    print(  # noqa: T201
+                        f"Authentication: {_event_authentication_details(device)}"
+                    )
+
+            device.stream.connection_status_callback.append(_on_connection_status)
             stop_event = asyncio.Event()
             try:
+                await device.vapix.api_discovery.update()
                 device.enable_events()
+                protocol, security = _event_stream_details(device)
+                print(f"Event transport: {protocol}")  # noqa: T201
+                print(f"Security: {security}")  # noqa: T201
+                device.stream.start()
                 await stop_event.wait()
             except asyncio.CancelledError:
                 pass
             finally:
+                device.stream.connection_status_callback.remove(_on_connection_status)
+                device.stream.stop()
                 unsubscribe()
 
     try:

axis-75/axis/interfaces/firmware_management.py

@@ -0,0 +1,21 @@
+"""Firmware management API.
+
+Listed in API discovery from AXIS OS 7.40, it replaces restart.cgi for
+rebooting. Requires an administrator account.
+"""
+
+from ..models.api import ApiItem
+from ..models.api_discovery import ApiId
+from ..models.firmware_management import API_VERSION, RebootRequest
+from .api_handler import ApiHandler
+
+
+class FirmwareManagementHandler(ApiHandler[ApiItem]):
+    """Firmware management of a device."""
+
+    api_id = ApiId.FIRMWARE_MANAGER
+    default_api_version = API_VERSION
+
+    async def reboot(self) -> None:
+        """Reboot the device."""
+        await self.vapix.api_request(RebootRequest())

axis-75/axis/interfaces/restart_cgi.py

@@ -0,0 +1,17 @@
+"""Axis Vapix restart API.
+
+Restart the device. Requires an administrator account. Superseded by the
+firmware management API, use this on devices that don't list it.
+"""
+
+from ..models.api import ApiItem
+from ..models.restart_cgi import RestartRequest
+from .api_handler import ApiHandler
+
+
+class RestartHandler(ApiHandler[ApiItem]):
+    """Restart the device through restart.cgi."""
+
+    async def restart(self) -> None:
+        """Restart the device."""
+        await self.vapix.api_request(RestartRequest())

{axis-73 → axis-75}/axis/interfaces/vapix.py

@@ -10,7 +10,6 @@ import aiohttp
 from ..errors import RequestError, raise_error
 from ..models.configuration import AuthScheme
 from ..models.pwdgrp_cgi import SecondaryGroup
-from .aiohttp_digest import AiohttpDigestAuth
 from .api_discovery import ApiDiscoveryHandler
 from .api_handler import ApiHandler, HandlerGroup
 from .applications import ApplicationsHandler
@@ -21,6 +20,7 @@ from .applications.object_analytics import ObjectAnalyticsHandler
 from .applications.vmd4 import Vmd4Handler
 from .basic_device_info import BasicDeviceInfoHandler
 from .event_instances import EventInstanceHandler
+from .firmware_management import FirmwareManagementHandler
 from .light_control import LightHandler
 from .mqtt import MqttClientHandler
 from .parameters.param_cgi import Params
@@ -29,10 +29,12 @@ from .port_cgi import Ports
 from .port_management import IoPortManagement
 from .ptz import PtzControl
 from .pwdgrp_cgi import Users
+from .restart_cgi import RestartHandler
 from .stream_profiles import StreamProfilesHandler
 from .temperature_control import TemperatureControlHandler
 from .user_groups import UserGroups
 from .view_areas import ViewAreaHandler
+from .virtual_input import VirtualInputHandler
 
 if TYPE_CHECKING:
     from collections.abc import Awaitable
@@ -68,16 +70,15 @@ class InterfaceState:
 class Vapix:
     """Vapix parameter request."""
 
-    auth: aiohttp.BasicAuth | None
+    auth: str | None
 
     def __init__(self, device: AxisDevice) -> None:
         """Store local reference to device config."""
         self.device = device
         self._aiohttp_digest_middleware: Any | None = None
-        self._aiohttp_digest_auth = AiohttpDigestAuth(device)
 
         if device.config.auth_scheme == AuthScheme.BASIC:
-            self.auth = self._basic_auth()
+            self.auth = self._basic_auth_header()
         else:
             self.auth = None
             self._aiohttp_digest_middleware = self._aiohttp_digest_middleware_obj()
@@ -95,6 +96,7 @@ class Vapix:
         self.params: Params = Params(self)
 
         self.basic_device_info = BasicDeviceInfoHandler(self)
+        self.firmware_management = FirmwareManagementHandler(self)
         self.io_port_management = IoPortManagement(self)
         self.light_control = LightHandler(self)
         self.mqtt = MqttClientHandler(self)
@@ -105,6 +107,8 @@ class Vapix:
 
         self.port_cgi = Ports(self)
         self.ptz = PtzControl(self)
+        self.restart_cgi = RestartHandler(self)
+        self.virtual_input = VirtualInputHandler(self)
 
         self.applications: ApplicationsHandler = ApplicationsHandler(self)
         self.fence_guard = FenceGuardHandler(self)
@@ -124,6 +128,15 @@ class Vapix:
             return self.params.property_handler["0"].firmware_version
         return ""
 
+    @property
+    def product_full_name(self) -> str:
+        """Product full name of device."""
+        if self.basic_device_info.initialized:
+            return self.basic_device_info["0"].product_full_name
+        if self.params.brand_handler.initialized:
+            return self.params.brand_handler["0"].product_full_name
+        return ""
+
     @property
     def product_number(self) -> str:
         """Product number of device."""
@@ -178,6 +191,8 @@ class Vapix:
         """Initialize Vapix functions."""
         await self.initialize_api_discovery()
         await self.initialize_param_cgi(preload_data=False)
+        if "Companion" in self.product_full_name:
+            self.device.config.is_companion = True
         await self.initialize_applications()
 
     async def initialize_api_discovery(self) -> None:
@@ -340,7 +355,7 @@ class Vapix:
     ) -> ApiResponseT:
         """Make a request and decode response based on the request contract."""
         params = api_request.params or {}
-        if self.device.config.is_companion:
+        if self.device.config.is_companion and api_request.supports_companion_param:
             params["Axis-Orig-Sw"] = "true"
         bytes_data = await self.request(
             method=api_request.method,
@@ -419,7 +434,7 @@ class Vapix:
 
         if status_code >= 400:
             if self._should_retry_with_basic(response_headers, allow_auto_basic_retry):
-                self.auth = self._basic_auth()
+                self.auth = self._basic_auth_header()
                 self._aiohttp_digest_middleware = None
                 return await self._request(
                     method=method,
@@ -458,16 +473,16 @@ class Vapix:
         )
         session = self.device.config.session
 
-        if not self.auth and self.device.config.auth_scheme != AuthScheme.BASIC:
-            return await self._aiohttp_digest_auth.perform_request(
-                session, method, url, request_data, headers, params
-            )
+        request_headers = dict(headers or {})
+        if self.auth is not None and not any(
+            header.lower() == "authorization" for header in request_headers
+        ):
+            request_headers["Authorization"] = self.auth
 
         request_kwargs: dict[str, Any] = {
             "data": request_data,
-            "headers": headers,
+            "headers": request_headers,
             "params": params,
-            "auth": self.auth,
             "timeout": TIME_OUT,
         }
         if self._aiohttp_digest_middleware is not None:
@@ -492,9 +507,9 @@ class Vapix:
             password=self.device.config.password,
         )
 
-    def _basic_auth(self) -> aiohttp.BasicAuth:
-        """Create aiohttp basic auth object."""
-        return aiohttp.BasicAuth(
+    def _basic_auth_header(self) -> str:
+        """Create an HTTP Basic Authorization header value."""
+        return aiohttp.encode_basic_auth(
             self.device.config.username, self.device.config.password
         )
 

axis-75/axis/interfaces/virtual_input.py

@@ -0,0 +1,38 @@
+"""Virtual input API.
+
+Activate and deactivate virtual input ports, which can be used as start event
+or condition in the device's action rules. Virtual inputs are not listed in API
+discovery, support is announced by Properties.VirtualInput.VirtualInput. The
+available ports and their state are only reported through the VirtualInput
+event, which is left to the caller to combine with this API.
+
+https://developer.axis.com/vapix/network-video/input-and-outputs/#virtual-input-api
+"""
+
+from ..models.api import ApiItem
+from ..models.virtual_input import (
+    ActivateVirtualInputRequest,
+    DeactivateVirtualInputRequest,
+)
+from .api_handler import ApiHandler
+
+
+class VirtualInputHandler(ApiHandler[ApiItem]):
+    """Virtual input ports of a device."""
+
+    @property
+    def listed_in_parameters(self) -> bool:
+        """Is virtual input supported."""
+        if prop := self.vapix.params.property_handler.get("0"):
+            return prop.virtual_input
+        return False
+
+    async def activate(self, port: int) -> bool:
+        """Activate virtual input port, return True if the state changed."""
+        response = await self.vapix.api_request(ActivateVirtualInputRequest(port))
+        return response.data
+
+    async def deactivate(self, port: int) -> bool:
+        """Deactivate virtual input port, return True if the state changed."""
+        response = await self.vapix.api_request(DeactivateVirtualInputRequest(port))
+        return response.data

{axis-73 → axis-75}/axis/models/api.py

@@ -68,6 +68,8 @@ class ApiRequest[ResponseT = ApiResponse[bytes]]:
     path: str = field(init=False)
     content_type: str = field(init=False)
     response_type: ClassVar[type[ApiResponseDecoder[ResponseT]]]
+    # Some APIs reject the Axis-Orig-Sw parameter used by Companion devices
+    supports_companion_param: ClassVar[bool] = True
 
     @property
     def content(self) -> bytes | None:

{axis-73 → axis-75}/axis/models/api_discovery.py

@@ -229,6 +229,7 @@ class ListApisRequest(ApiRequest[GetAllApisResponse]):
     path = "/axis-cgi/apidiscovery.cgi"
     content_type = "application/json"
     response_type = GetAllApisResponse
+    supports_companion_param = False
     error_codes = error_codes
 
     api_version: str = API_VERSION
@@ -276,6 +277,7 @@ class GetSupportedVersionsRequest(ApiRequest[GetSupportedVersionsResponse]):
     path = "/axis-cgi/apidiscovery.cgi"
     content_type = "application/json"
     response_type = GetSupportedVersionsResponse
+    supports_companion_param = False
     error_codes = error_codes
 
     context: str = CONTEXT

{axis-73 → axis-75}/axis/models/basic_device_info.py

@@ -151,6 +151,7 @@ class GetAllPropertiesRequest(ApiRequest[GetAllPropertiesResponse]):
     path = "/axis-cgi/basicdeviceinfo.cgi"
     content_type = "application/json"
     response_type = GetAllPropertiesResponse
+    supports_companion_param = False
     error_codes = error_codes
 
     api_version: str = API_VERSION
@@ -198,6 +199,7 @@ class GetSupportedVersionsRequest(ApiRequest[GetSupportedVersionsResponse]):
     path = "/axis-cgi/basicdeviceinfo.cgi"
     content_type = "application/json"
     response_type = GetSupportedVersionsResponse
+    supports_companion_param = False
     error_codes = error_codes
 
     context: str = CONTEXT

axis-75/axis/models/firmware_management.py

@@ -0,0 +1,64 @@
+"""Firmware management API.
+
+Manage the firmware of the device. Only rebooting is supported here.
+
+https://developer.axis.com/vapix/network-video/firmware-management-api/
+"""
+
+from dataclasses import dataclass
+from typing import Any, Self
+
+import orjson
+
+from ..errors import ResponseError
+from .api import CONTEXT, ApiRequest, ApiResponse
+
+API_VERSION = "1.0"
+
+
+@dataclass
+class RebootResponse(ApiResponse[None]):
+    """Response from rebooting the device."""
+
+    data: None
+
+    @classmethod
+    def decode(cls, bytes_data: bytes) -> Self:
+        """Decode response, raise ResponseError if the device reports an error."""
+        msg = "Invalid firmware management response"
+        try:
+            data: Any = orjson.loads(bytes_data)
+        except orjson.JSONDecodeError as err:
+            raise ResponseError(msg) from err
+        if not isinstance(data, dict):
+            raise ResponseError(msg)
+        if isinstance(error := data.get("error"), dict):
+            msg = (
+                f"Firmware management error {error.get('code')}: {error.get('message')}"
+            )
+            raise ResponseError(msg)
+        return cls(data=None)
+
+
+@dataclass
+class RebootRequest(ApiRequest[RebootResponse]):
+    """Request object for rebooting the device."""
+
+    method = "post"
+    path = "/axis-cgi/firmwaremanagement.cgi"
+    content_type = "application/json"
+    response_type = RebootResponse
+
+    api_version: str = API_VERSION
+    context: str = CONTEXT
+
+    @property
+    def content(self) -> bytes:
+        """Initialize request data."""
+        return orjson.dumps(
+            {
+                "apiVersion": self.api_version,
+                "context": self.context,
+                "method": "reboot",
+            }
+        )

{axis-73 → axis-75}/axis/models/parameters/properties.py

@@ -103,6 +103,12 @@ class PropertySystemParamT(TypedDict):
     Soc: str
 
 
+class PropertyVirtualInputParamT(TypedDict):
+    """Represent a virtual input object."""
+
+    VirtualInput: bool
+
+
 class PropertyParamT(TypedDict):
     """Represent a property object."""
 
@@ -113,6 +119,7 @@ class PropertyParamT(TypedDict):
     LightControl: NotRequired[PropertyLightControlParamT]
     PTZ: NotRequired[PropertyPtzParamT]
     System: PropertySystemParamT
+    VirtualInput: NotRequired[PropertyVirtualInputParamT]
 
 
 @dataclass(frozen=True)
@@ -174,6 +181,9 @@ class PropertyParam(ParamItem):
     system_serial_number: str
     """Device serial number."""
 
+    virtual_input: bool
+    """Support virtual input ports."""
+
     @classmethod
     def decode(cls, data: PropertyParamT) -> Self:
         """Decode dictionary to class object."""
@@ -200,4 +210,5 @@ class PropertyParam(ParamItem):
             ptz=data.get("PTZ", {}).get("PTZ", False),
             digital_ptz=data.get("PTZ", {}).get("DigitalPTZ", False),
             system_serial_number=data["System"]["SerialNumber"],
+            virtual_input=data.get("VirtualInput", {}).get("VirtualInput", False),
         )

axis-75/axis/models/restart_cgi.py

@@ -0,0 +1,15 @@
+"""Restart API."""
+
+from dataclasses import dataclass
+
+from .api import ApiRequest, ApiResponse, BytesResponse
+
+
+@dataclass
+class RestartRequest(ApiRequest[ApiResponse[bytes]]):
+    """Request object for restarting the device."""
+
+    method = "get"
+    path = "/axis-cgi/restart.cgi"
+    content_type = "text/plain"
+    response_type = BytesResponse