velasmart 0.1.0__tar.gz

velasmart-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VelaSmart
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

velasmart-0.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: velasmart
+Version: 0.1.0
+Summary: Asyncio client for the VelaSmart cloud API
+Author: VelaSmart
+License: MIT
+Project-URL: Homepage, https://github.com/liulijun2019/velasmart
+Project-URL: Repository, https://github.com/liulijun2019/velasmart
+Keywords: velasmart,curtain,homeassistant
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8
+Dynamic: license-file
+
+# velasmart
+
+Asyncio client for the VelaSmart cloud API. Used by the VelaSmart Home Assistant
+integration.
+
+## Install
+
+```bash
+pip install velasmart
+```
+
+## Usage
+
+```python
+import asyncio
+
+from velasmart import VelaSmartApiClient
+
+
+async def main():
+    client = VelaSmartApiClient("username", "password")
+    await client.authenticate()
+    devices = await client.get_devices()
+    for device in devices:
+        print(device["id"], device["name"])
+
+
+asyncio.run(main())
+```
+
+## License
+
+MIT

velasmart-0.1.0/README.md

@@ -0,0 +1,33 @@
+# velasmart
+
+Asyncio client for the VelaSmart cloud API. Used by the VelaSmart Home Assistant
+integration.
+
+## Install
+
+```bash
+pip install velasmart
+```
+
+## Usage
+
+```python
+import asyncio
+
+from velasmart import VelaSmartApiClient
+
+
+async def main():
+    client = VelaSmartApiClient("username", "password")
+    await client.authenticate()
+    devices = await client.get_devices()
+    for device in devices:
+        print(device["id"], device["name"])
+
+
+asyncio.run(main())
+```
+
+## License
+
+MIT

velasmart-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "velasmart"
+version = "0.1.0"
+description = "Asyncio client for the VelaSmart cloud API"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "VelaSmart" }]
+keywords = ["velasmart", "curtain", "homeassistant"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = ["aiohttp>=3.8"]
+
+[project.urls]
+Homepage = "https://github.com/liulijun2019/velasmart"
+Repository = "https://github.com/liulijun2019/velasmart"
+
+[tool.setuptools.packages.find]
+include = ["velasmart*"]

velasmart-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

velasmart-0.1.0/tests/test_client.py

@@ -0,0 +1,65 @@
+"""Tests for the VelaSmart cloud API client."""
+
+from velasmart import VelaSmartApiClient, VelaSmartApiError
+
+
+def test_parse_devices() -> None:
+    """Test parsing the nested device list response."""
+    result = {
+        "code": 200,
+        "data": {
+            "list": [
+                {
+                    "list": [
+                        {
+                            "deviceId": "5c1c0a6612",
+                            "deviceName": "BidRoller",
+                            "gatewayMac": "e08cfec409a2",
+                            "deviceType": 3,
+                            "position": 50,
+                            "onlineStatus": 0,
+                            "electric": 31,
+                        }
+                    ]
+                }
+            ]
+        },
+    }
+    devices = VelaSmartApiClient._parse_devices(result)
+    assert len(devices) == 1
+    device = devices[0]
+    assert device["id"] == "5c1c0a6612"
+    assert device["name"] == "BidRoller"
+    assert device["gateway_mac"] == "e08cfec409a2"
+    assert device["device_type"] == 3
+    assert device["position"] == 50
+    assert device["is_closed"] is False
+    assert device["online"] is False
+    assert device["battery"] == 31
+
+
+def test_parse_devices_empty() -> None:
+    """Test parsing an empty device list."""
+    result = {"code": 200, "data": {"list": []}}
+    assert VelaSmartApiClient._parse_devices(result) == []
+
+
+def test_parse_devices_position_closed() -> None:
+    """Test that position 0 marks the device as closed."""
+    result = {
+        "code": 200,
+        "data": {
+            "list": [
+                {
+                    "list": [
+                        {
+                            "deviceId": "abc",
+                            "position": 0,
+                        }
+                    ]
+                }
+            ]
+        },
+    }
+    devices = VelaSmartApiClient._parse_devices(result)
+    assert devices[0]["is_closed"] is True

velasmart-0.1.0/velasmart/__init__.py

@@ -0,0 +1,12 @@
+"""VelaSmart cloud API client."""
+
+from velasmart.client import VelaSmartApiClient, VelaSmartApiError
+from velasmart.const import AUTH_URL, DEVICE_LIST_URL, SEND_ORDER_URL
+
+__all__ = [
+    "AUTH_URL",
+    "DEVICE_LIST_URL",
+    "SEND_ORDER_URL",
+    "VelaSmartApiClient",
+    "VelaSmartApiError",
+]

velasmart-0.1.0/velasmart/client.py

@@ -0,0 +1,139 @@
+"""Asyncio client for the VelaSmart cloud API."""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+import aiohttp
+
+from velasmart.const import AUTH_URL, DEVICE_LIST_URL, SEND_ORDER_URL
+
+_LOGGER = logging.getLogger(__name__)
+
+TIMEOUT = aiohttp.ClientTimeout(total=10)
+
+
+class VelaSmartApiError(Exception):
+    """Raised when the VelaSmart cloud API returns an error."""
+
+
+class VelaSmartApiClient:
+    """Client for the VelaSmart cloud API."""
+
+    def __init__(
+        self,
+        username: str,
+        password: str,
+        session: aiohttp.ClientSession | None = None,
+    ) -> None:
+        """Initialize the client."""
+        self._username = username
+        self._password = password
+        self._session = session
+        self._token: str | None = None
+
+    async def _post(
+        self,
+        url: str,
+        *,
+        headers: dict[str, str] | None = None,
+        data: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """Perform a POST request, reusing an injected session when available."""
+        if self._session is not None:
+            async with self._session.post(
+                url, headers=headers, json=data, timeout=TIMEOUT
+            ) as response:
+                return await response.json()
+
+        async with aiohttp.ClientSession(timeout=TIMEOUT) as session:
+            async with session.post(url, headers=headers, json=data) as response:
+                return await response.json()
+
+    async def authenticate(self) -> None:
+        """Authenticate with the cloud API and store the returned token."""
+        try:
+            result = await self._post(
+                AUTH_URL,
+                data={"account": self._username, "password": self._password},
+            )
+        except aiohttp.ClientError as err:
+            raise VelaSmartApiError(f"Network error: {err}") from err
+
+        if result.get("code") != 200:
+            raise VelaSmartApiError(f"Authentication failed: {result}")
+
+        token = (result.get("data") or {}).get("token")
+        if not token:
+            raise VelaSmartApiError("Authentication response did not contain a token")
+        self._token = token
+
+    async def get_devices(self) -> list[dict[str, Any]]:
+        """Fetch the list of devices for the account."""
+        if not self._token:
+            await self.authenticate()
+
+        try:
+            result = await self._post(
+                DEVICE_LIST_URL, headers={"token": self._token}, data={}
+            )
+        except aiohttp.ClientError as err:
+            raise VelaSmartApiError(f"Network error: {err}") from err
+
+        if result.get("code") != 200:
+            raise VelaSmartApiError(f"Failed to fetch device list: {result}")
+
+        return self._parse_devices(result)
+
+    @staticmethod
+    def _parse_devices(result: dict[str, Any]) -> list[dict[str, Any]]:
+        """Parse the nested device list returned by the API."""
+        data = result.get("data") or {}
+        groups = data.get("list") or []
+        devices: list[dict[str, Any]] = []
+        for group in groups:
+            if not isinstance(group, dict):
+                continue
+            for device in group.get("list") or []:
+                if not isinstance(device, dict):
+                    continue
+                position = int(device.get("position", 0) or 0)
+                devices.append(
+                    {
+                        "id": device.get("deviceId", ""),
+                        "name": device.get("deviceName", "VelaSmart Curtain"),
+                        "gateway_mac": device.get("gatewayMac", ""),
+                        "device_type": device.get("deviceType", 3),
+                        "position": position,
+                        "is_closed": position == 0,
+                        "online": device.get("onlineStatus", 0) == 1,
+                        "battery": device.get("electric"),
+                    }
+                )
+        return devices
+
+    async def send_command(
+        self, device_id: str, curtain_type: int, position: int
+    ) -> None:
+        """Send a position command to the given device."""
+        if not self._token:
+            await self.authenticate()
+
+        try:
+            result = await self._post(
+                SEND_ORDER_URL,
+                headers={"token": self._token},
+                data={
+                    "deviceId": device_id,
+                    "curtainType": curtain_type,
+                    "operateCode": 3,
+                    "angle": 0,
+                    "position": position,
+                },
+            )
+        except aiohttp.ClientError as err:
+            raise VelaSmartApiError(f"Network error: {err}") from err
+
+        if result.get("code") != 200:
+            raise VelaSmartApiError(f"Command failed: {result}")

velasmart-0.1.0/velasmart/const.py

@@ -0,0 +1,11 @@
+"""Constants for the VelaSmart cloud API."""
+
+AUTH_URL = (
+    "https://aize2kydb3.execute-api.us-east-1.amazonaws.com/prod/assistantLogin"
+)
+DEVICE_LIST_URL = (
+    "https://aize2kydb3.execute-api.us-east-1.amazonaws.com/prod/findDeviceByAccount"
+)
+SEND_ORDER_URL = (
+    "https://aize2kydb3.execute-api.us-east-1.amazonaws.com/prod/assistantSendOrder"
+)

velasmart-0.1.0/velasmart.egg-info/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: velasmart
+Version: 0.1.0
+Summary: Asyncio client for the VelaSmart cloud API
+Author: VelaSmart
+License: MIT
+Project-URL: Homepage, https://github.com/liulijun2019/velasmart
+Project-URL: Repository, https://github.com/liulijun2019/velasmart
+Keywords: velasmart,curtain,homeassistant
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8
+Dynamic: license-file
+
+# velasmart
+
+Asyncio client for the VelaSmart cloud API. Used by the VelaSmart Home Assistant
+integration.
+
+## Install
+
+```bash
+pip install velasmart
+```
+
+## Usage
+
+```python
+import asyncio
+
+from velasmart import VelaSmartApiClient
+
+
+async def main():
+    client = VelaSmartApiClient("username", "password")
+    await client.authenticate()
+    devices = await client.get_devices()
+    for device in devices:
+        print(device["id"], device["name"])
+
+
+asyncio.run(main())
+```
+
+## License
+
+MIT

velasmart-0.1.0/velasmart.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+tests/test_client.py
+velasmart/__init__.py
+velasmart/client.py
+velasmart/const.py
+velasmart.egg-info/PKG-INFO
+velasmart.egg-info/SOURCES.txt
+velasmart.egg-info/dependency_links.txt
+velasmart.egg-info/requires.txt
+velasmart.egg-info/top_level.txt

velasmart-0.1.0/velasmart.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

velasmart-0.1.0/velasmart.egg-info/requires.txt

@@ -0,0 +1 @@
+aiohttp>=3.8

velasmart-0.1.0/velasmart.egg-info/top_level.txt

@@ -0,0 +1 @@
+velasmart