pysyncleo 0.1.0__tar.gz

pysyncleo-0.1.0/.editorconfig

@@ -0,0 +1,114 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+max_line_length = 120
+tab_width = 4
+ij_continuation_indent_size = 8
+ij_formatter_off_tag = @formatter:off
+ij_formatter_on_tag = @formatter:on
+ij_formatter_tags_enabled = false
+ij_smart_tabs = false
+ij_wrap_on_typing = false
+
+[.editorconfig]
+ij_editorconfig_align_group_field_declarations = false
+ij_editorconfig_space_after_colon = false
+ij_editorconfig_space_after_comma = true
+ij_editorconfig_space_before_colon = false
+ij_editorconfig_space_before_comma = false
+ij_editorconfig_spaces_around_assignment_operators = true
+
+[*.json]
+indent_size = 2
+tab_width = 2
+ij_json_keep_blank_lines_in_code = 0
+ij_json_keep_indents_on_empty_lines = false
+ij_json_keep_line_breaks = true
+ij_json_space_after_colon = true
+ij_json_space_after_comma = true
+ij_json_space_before_colon = true
+ij_json_space_before_comma = false
+ij_json_spaces_within_braces = false
+ij_json_spaces_within_brackets = false
+ij_json_wrap_long_lines = false
+
+[{*.py,*.pyw}]
+ij_python_align_collections_and_comprehensions = true
+ij_python_align_multiline_imports = true
+ij_python_align_multiline_parameters = true
+ij_python_align_multiline_parameters_in_calls = true
+ij_python_blank_line_at_file_end = true
+ij_python_blank_lines_after_imports = 1
+ij_python_blank_lines_after_local_imports = 0
+ij_python_blank_lines_around_class = 1
+ij_python_blank_lines_around_method = 1
+ij_python_blank_lines_around_top_level_classes_functions = 2
+ij_python_blank_lines_before_first_method = 0
+ij_python_call_parameters_new_line_after_left_paren = false
+ij_python_call_parameters_right_paren_on_new_line = false
+ij_python_call_parameters_wrap = normal
+ij_python_dict_alignment = 0
+ij_python_dict_new_line_after_left_brace = false
+ij_python_dict_new_line_before_right_brace = false
+ij_python_dict_wrapping = 1
+ij_python_from_import_new_line_after_left_parenthesis = false
+ij_python_from_import_new_line_before_right_parenthesis = false
+ij_python_from_import_parentheses_force_if_multiline = false
+ij_python_from_import_trailing_comma_if_multiline = false
+ij_python_from_import_wrapping = 1
+ij_python_hang_closing_brackets = false
+ij_python_keep_blank_lines_in_code = 1
+ij_python_keep_blank_lines_in_declarations = 1
+ij_python_keep_indents_on_empty_lines = false
+ij_python_keep_line_breaks = true
+ij_python_method_parameters_new_line_after_left_paren = false
+ij_python_method_parameters_right_paren_on_new_line = false
+ij_python_method_parameters_wrap = normal
+ij_python_new_line_after_colon = false
+ij_python_new_line_after_colon_multi_clause = true
+ij_python_optimize_imports_always_split_from_imports = false
+ij_python_optimize_imports_case_insensitive_order = false
+ij_python_optimize_imports_join_from_imports_with_same_source = false
+ij_python_optimize_imports_sort_by_type_first = true
+ij_python_optimize_imports_sort_imports = true
+ij_python_optimize_imports_sort_names_in_from_imports = false
+ij_python_space_after_comma = true
+ij_python_space_after_number_sign = true
+ij_python_space_after_py_colon = true
+ij_python_space_before_backslash = true
+ij_python_space_before_comma = false
+ij_python_space_before_for_semicolon = false
+ij_python_space_before_lbracket = false
+ij_python_space_before_method_call_parentheses = false
+ij_python_space_before_method_parentheses = false
+ij_python_space_before_number_sign = true
+ij_python_space_before_py_colon = false
+ij_python_space_within_empty_method_call_parentheses = false
+ij_python_space_within_empty_method_parentheses = false
+ij_python_spaces_around_additive_operators = true
+ij_python_spaces_around_assignment_operators = true
+ij_python_spaces_around_bitwise_operators = true
+ij_python_spaces_around_eq_in_keyword_argument = false
+ij_python_spaces_around_eq_in_named_parameter = false
+ij_python_spaces_around_equality_operators = true
+ij_python_spaces_around_multiplicative_operators = true
+ij_python_spaces_around_power_operator = true
+ij_python_spaces_around_relational_operators = true
+ij_python_spaces_around_shift_operators = true
+ij_python_spaces_within_braces = false
+ij_python_spaces_within_brackets = false
+ij_python_spaces_within_method_call_parentheses = false
+ij_python_spaces_within_method_parentheses = false
+ij_python_use_continuation_indent_for_arguments = false
+ij_python_use_continuation_indent_for_collection_and_comprehensions = false
+ij_python_use_continuation_indent_for_parameters = true
+ij_python_wrap_long_lines = false
+
+[Pipfile]
+ij_toml_keep_indents_on_empty_lines = false
+

pysyncleo-0.1.0/.github/workflows/lint.yml

@@ -0,0 +1,32 @@
+name: "Lint"
+
+on:
+  push:
+    branches:
+      - "main"
+  pull_request:
+    branches:
+      - "main"
+
+jobs:
+  ruff:
+    name: "Ruff"
+    runs-on: "ubuntu-latest"
+    steps:
+        - name: "Checkout the repository"
+          uses: "actions/checkout@v6"
+
+        - name: "Install uv"
+          uses: astral-sh/setup-uv@v8.2.0
+          with:
+            enable-cache: true
+            cache-dependency-glob: "uv.lock"
+
+        - name: "Install requirements"
+          run: uv sync --all-extras --dev
+
+        - name: "Lint"
+          run: uv run ruff check .
+
+        - name: "Format"
+          run: uv run ruff format . --check

pysyncleo-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,27 @@
+on:
+    release: 
+        types: [published]
+
+permissions: 
+    contents: read
+
+jobs:
+    publish:
+        runs-on: ubuntu-latest
+        permissions: 
+            id-token: write
+
+        steps:
+            - uses: actions/checkout@v6
+
+            - name: Install uv
+              uses: astral-sh/setup-uv@v8.2.0
+              with:
+                  enable-cache: true
+                  cache-dependency-glob: "uv.lock"
+
+            - name: Build package
+              run: uv build
+
+            - name: Publish
+              run: uv publish

pysyncleo-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

pysyncleo-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,9 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.7
+    hooks:
+      - id: ruff-check
+        args:
+          - --fix
+      - id: ruff-format
+        files: ^(src/pysyncleo/.+)?[^/]+\.py$

pysyncleo-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

pysyncleo-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dmitriy
+
+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.

pysyncleo-0.1.0/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: pysyncleo
+Version: 0.1.0
+Summary: Basic library for working with Syncleo UDP devices
+Project-URL: Repository, https://github.com/DeKaN/pysyncleo.git
+Author: DeKaN
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.13
+Requires-Dist: cryptography>=44.0.0
+Description-Content-Type: text/markdown
+
+# pySyncleo
+
+Library to control devices using Syncleo IoT (Rusclimate/Polaris) UDP protocol.
+
+Simple example can be found in `example.py`

pysyncleo-0.1.0/README.md

@@ -0,0 +1,5 @@
+# pySyncleo
+
+Library to control devices using Syncleo IoT (Rusclimate/Polaris) UDP protocol.
+
+Simple example can be found in `example.py`

pysyncleo-0.1.0/example.py

@@ -0,0 +1,138 @@
+import asyncio
+import logging
+from typing import Dict
+
+from zeroconf import ServiceStateChange
+from zeroconf.asyncio import AsyncServiceBrowser, AsyncServiceInfo, AsyncZeroconf
+
+from pysyncleo.commands import CmdInitDiagnostic
+from pysyncleo.const import SYNCLEO_MDNS_TYPE
+from pysyncleo.enums import ConnectionState
+from pysyncleo.models import SyncleoUdpDevice
+from pysyncleo.transport import SyncleoConnection, TransportManager
+
+logging.basicConfig(
+    level=logging.DEBUG,
+    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+    datefmt="%H:%M:%S",
+)
+_LOGGER = logging.getLogger("syncleo_example")
+
+
+class AsyncDiscoveryListener:
+    """Non-blocking listener for mDNS state changes."""
+
+    def __init__(self, queue: asyncio.Queue):
+        self.queue = queue
+
+    def async_on_service_state_change(
+        self, zeroconf, service_type: str, name: str, state_change: ServiceStateChange
+    ) -> None:
+        """Called synchronously by zeroconf, but spawns an async task to resolve info."""
+        if state_change is ServiceStateChange.Added:
+            asyncio.create_task(self.resolve_service(zeroconf, service_type, name))
+
+    async def resolve_service(self, zeroconf, service_type: str, name: str):
+        info = AsyncServiceInfo(service_type, name)
+
+        await info.async_request(zeroconf, 3000)
+
+        if info and info.parsed_addresses():
+            ip_address = info.parsed_addresses()[0]
+
+            self.queue.put_nowait(
+                {
+                    "ip": ip_address,
+                    "port": info.port,
+                    "txt": info.decoded_properties,
+                    "name": name,
+                }
+            )
+
+
+def state_update_callback(cmd):
+    if hasattr(cmd, "value"):
+        _LOGGER.info(f"🟢 DEVICE STATE UPDATE: {cmd.command_type.name} = {cmd.value}")
+    else:
+        _LOGGER.info(f"🟢 DEVICE STATE UPDATE: {cmd.command_type.name}")
+
+
+async def interact_with_device(conn):
+    for _ in range(10):
+        if conn.state == ConnectionState.CONNECTED:
+            break
+        await asyncio.sleep(0.5)
+
+    if conn.state != ConnectionState.CONNECTED:
+        _LOGGER.error(f"❌ Handshake timed out for {conn.device.inet_address[0]}")
+        return
+
+    _LOGGER.info(f"✅ Secure Session Established with {conn.device.inet_address[0]}!")
+    await asyncio.sleep(1.5)
+
+    _LOGGER.info("📡 Requesting deep network diagnostics...")
+    await conn.send_command(CmdInitDiagnostic(mode=0))
+
+
+async def main():
+    loop = asyncio.get_running_loop()
+
+    manager = TransportManager()
+    transport, _ = await loop.create_datagram_endpoint(
+        lambda: manager, local_addr=("0.0.0.0", 0)
+    )
+
+    discovery_queue = asyncio.Queue()
+    listener = AsyncDiscoveryListener(discovery_queue)
+    aiozc = AsyncZeroconf()
+
+    browser = AsyncServiceBrowser(
+        aiozc.zeroconf,
+        [SYNCLEO_MDNS_TYPE],
+        handlers=[listener.async_on_service_state_change],
+    )
+
+    _LOGGER.info("🔍 Searching for Syncleo devices on the local network...")
+    active_connections: Dict[str, "SyncleoConnection"] = {}
+
+    try:
+        while True:
+            discovered = await discovery_queue.get()
+            ip = discovered["ip"]
+
+            if ip in active_connections:
+                continue
+
+            _LOGGER.info(
+                f"💡 Found Device: {discovered['name']} at {ip}:{discovered['port']}"
+            )
+
+            device = SyncleoUdpDevice.from_zeroconf(
+                ip, discovered["port"], discovered["txt"]
+            )
+
+            conn = manager.register_device(device)
+            if not conn:
+                continue
+
+            conn.on_state_updated = state_update_callback
+            active_connections[ip] = conn
+
+            await conn.connect()
+            asyncio.create_task(interact_with_device(conn))
+
+    except asyncio.CancelledError:
+        pass
+    finally:
+        _LOGGER.info("Closing sockets and network listeners...")
+
+        await browser.async_cancel()
+        await aiozc.async_close()
+        transport.close()
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        print("\nExiting script...")

pysyncleo-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "pysyncleo"
+version = "0.1.0"
+description = "Basic library for working with Syncleo UDP devices"
+readme = "README.md"
+authors = [
+    { name = "DeKaN" }
+]
+keywords = []
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "cryptography>=44.0.0"
+]
+
+[project.urls]
+Repository = "https://github.com/DeKaN/pysyncleo.git"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.5.1",
+    "ruff>=0.15.5",
+    "zeroconf>=0.149.16"
+]