bleak-smlight 1.0.0__tar.gz

bleak_smlight-1.0.0/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2026 Bluetooth Devices Authors
+
+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.

bleak_smlight-1.0.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: bleak-smlight
+Version: 1.0.0
+Summary: Bleak backend for SMLIGHT SLZB Bluetooth proxies
+License: MIT
+License-File: LICENSE
+Author: Bluetooth Devices Authors
+Author-email: bluetooth@koston.org
+Requires-Python: >=3.12,<4
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Requires-Dist: bluetooth-data-tools (>=1.18.0)
+Requires-Dist: habluetooth (>=6.4.0)
+Requires-Dist: pysmlight (>=0.4.0)
+Project-URL: Bug Tracker, https://github.com/bluetooth-devices/bleak-smlight/issues
+Project-URL: Changelog, https://github.com/bluetooth-devices/bleak-smlight/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://bleak-smlight.readthedocs.io
+Project-URL: Repository, https://github.com/bluetooth-devices/bleak-smlight
+Description-Content-Type: text/markdown
+
+# bleak-smlight
+
+<p align="center">
+  <a href="https://github.com/bluetooth-devices/bleak-smlight/actions/workflows/ci.yml?query=branch%3Amain">
+    <img src="https://img.shields.io/github/actions/workflow/status/bluetooth-devices/bleak-smlight/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" >
+  </a>
+  <a href="https://bleak-smlight.readthedocs.io">
+    <img src="https://img.shields.io/readthedocs/bleak-smlight.svg?logo=read-the-docs&logoColor=fff&style=flat-square" alt="Documentation Status">
+  </a>
+  <a href="https://codecov.io/gh/bluetooth-devices/bleak-smlight">
+    <img src="https://img.shields.io/codecov/c/github/bluetooth-devices/bleak-smlight.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage">
+  </a>
+  <a href="https://codspeed.io/Bluetooth-Devices/bleak-smlight"><img src="https://img.shields.io/endpoint?url=https://codspeed.io/badge.json" alt="CodSpeed Badge"/></a>
+</p>
+<p align="center">
+  <a href="https://python-poetry.org/">
+    <img src="https://img.shields.io/badge/packaging-poetry-299bd7?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAASCAYAAABrXO8xAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAJJSURBVHgBfZLPa1NBEMe/s7tNXoxW1KJQKaUHkXhQvHgW6UHQQ09CBS/6V3hKc/AP8CqCrUcpmop3Cx48eDB4yEECjVQrlZb80CRN8t6OM/teagVxYZi38+Yz853dJbzoMV3MM8cJUcLMSUKIE8AzQ2PieZzFxEJOHMOgMQQ+dUgSAckNXhapU/NMhDSWLs1B24A8sO1xrN4NECkcAC9ASkiIJc6k5TRiUDPhnyMMdhKc+Zx19l6SgyeW76BEONY9exVQMzKExGKwwPsCzza7KGSSWRWEQhyEaDXp6ZHEr416ygbiKYOd7TEWvvcQIeusHYMJGhTwF9y7sGnSwaWyFAiyoxzqW0PM/RjghPxF2pWReAowTEXnDh0xgcLs8l2YQmOrj3N7ByiqEoH0cARs4u78WgAVkoEDIDoOi3AkcLOHU60RIg5wC4ZuTC7FaHKQm8Hq1fQuSOBvX/sodmNJSB5geaF5CPIkUeecdMxieoRO5jz9bheL6/tXjrwCyX/UYBUcjCaWHljx1xiX6z9xEjkYAzbGVnB8pvLmyXm9ep+W8CmsSHQQY77Zx1zboxAV0w7ybMhQmfqdmmw3nEp1I0Z+FGO6M8LZdoyZnuzzBdjISicKRnpxzI9fPb+0oYXsNdyi+d3h9bm9MWYHFtPeIZfLwzmFDKy1ai3p+PDls1Llz4yyFpferxjnyjJDSEy9CaCx5m2cJPerq6Xm34eTrZt3PqxYO1XOwDYZrFlH1fWnpU38Y9HRze3lj0vOujZcXKuuXm3jP+s3KbZVra7y2EAAAAAASUVORK5CYII=" alt="Poetry">
+  </a>
+  <a href="https://github.com/astral-sh/ruff">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=flat-square" alt="Ruff">
+  </a>
+  <a href="https://github.com/pre-commit/pre-commit">
+    <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" alt="pre-commit">
+  </a>
+</p>
+<p align="center">
+  <a href="https://pypi.org/project/bleak-smlight/">
+    <img src="https://img.shields.io/pypi/v/bleak-smlight.svg?logo=python&logoColor=fff&style=flat-square" alt="PyPI Version">
+  </a>
+  <img src="https://img.shields.io/pypi/pyversions/bleak-smlight.svg?style=flat-square&logo=python&amp;logoColor=fff" alt="Supported Python versions">
+  <img src="https://img.shields.io/pypi/l/bleak-smlight.svg?style=flat-square" alt="License">
+</p>
+
+---
+
+**Documentation**: <a href="https://bleak-smlight.readthedocs.io" target="_blank">https://bleak-smlight.readthedocs.io </a>
+
+**Source Code**: <a href="https://github.com/bluetooth-devices/bleak-smlight" target="_blank">https://github.com/bluetooth-devices/bleak-smlight </a>
+
+---
+
+A [Bleak](https://github.com/hbldh/bleak) backend that receives Bluetooth Low
+Energy advertisements from a SMLIGHT SLZB BLE proxy. The proxy is scan only, so
+this library registers a non connectable scanner with
+[habluetooth](https://github.com/Bluetooth-Devices/habluetooth); it does not
+support GATT connections. The UDP proxy protocol lives in
+[pysmlight](https://github.com/smlight-tech/pysmlight), this library is the host
+side glue that feeds advertisements into Bleak. See the [architecture
+docs](https://bleak-smlight.readthedocs.io/en/latest/architecture.html) for how
+the pieces fit together.
+
+## Usage
+
+```python
+import asyncio
+
+import habluetooth
+
+from bleak_smlight import SMLIGHTConnectionManager, SMLIGHTDeviceConfig
+
+DEVICES: list[SMLIGHTDeviceConfig] = [
+    {"source": "AA:BB:CC:DD:EE:FF", "name": "slzb-proxy", "host": "10.0.0.5"},
+]
+
+
+async def main() -> None:
+    await habluetooth.BluetoothManager().async_setup()
+    managers = [SMLIGHTConnectionManager(d) for d in DEVICES]
+    await asyncio.gather(*(m.start() for m in managers))
+    try:
+        await asyncio.Event().wait()  # advertisements now flow into Bleak
+    finally:
+        await asyncio.gather(*(m.stop() for m in managers))
+
+
+asyncio.run(main())
+```
+
+## Installation
+
+Install this via pip (or your favourite package manager):
+
+`pip install bleak-smlight`
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- prettier-ignore-start -->
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- markdownlint-disable -->
+<!-- markdownlint-enable -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+<!-- prettier-ignore-end -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+
+## Credits
+
+This package was created with
+[Copier](https://copier.readthedocs.io/) and the
+[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template)
+project template.
+

bleak_smlight-1.0.0/README.md

@@ -0,0 +1,103 @@
+# bleak-smlight
+
+<p align="center">
+  <a href="https://github.com/bluetooth-devices/bleak-smlight/actions/workflows/ci.yml?query=branch%3Amain">
+    <img src="https://img.shields.io/github/actions/workflow/status/bluetooth-devices/bleak-smlight/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" >
+  </a>
+  <a href="https://bleak-smlight.readthedocs.io">
+    <img src="https://img.shields.io/readthedocs/bleak-smlight.svg?logo=read-the-docs&logoColor=fff&style=flat-square" alt="Documentation Status">
+  </a>
+  <a href="https://codecov.io/gh/bluetooth-devices/bleak-smlight">
+    <img src="https://img.shields.io/codecov/c/github/bluetooth-devices/bleak-smlight.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage">
+  </a>
+  <a href="https://codspeed.io/Bluetooth-Devices/bleak-smlight"><img src="https://img.shields.io/endpoint?url=https://codspeed.io/badge.json" alt="CodSpeed Badge"/></a>
+</p>
+<p align="center">
+  <a href="https://python-poetry.org/">
+    <img src="https://img.shields.io/badge/packaging-poetry-299bd7?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAASCAYAAABrXO8xAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAJJSURBVHgBfZLPa1NBEMe/s7tNXoxW1KJQKaUHkXhQvHgW6UHQQ09CBS/6V3hKc/AP8CqCrUcpmop3Cx48eDB4yEECjVQrlZb80CRN8t6OM/teagVxYZi38+Yz853dJbzoMV3MM8cJUcLMSUKIE8AzQ2PieZzFxEJOHMOgMQQ+dUgSAckNXhapU/NMhDSWLs1B24A8sO1xrN4NECkcAC9ASkiIJc6k5TRiUDPhnyMMdhKc+Zx19l6SgyeW76BEONY9exVQMzKExGKwwPsCzza7KGSSWRWEQhyEaDXp6ZHEr416ygbiKYOd7TEWvvcQIeusHYMJGhTwF9y7sGnSwaWyFAiyoxzqW0PM/RjghPxF2pWReAowTEXnDh0xgcLs8l2YQmOrj3N7ByiqEoH0cARs4u78WgAVkoEDIDoOi3AkcLOHU60RIg5wC4ZuTC7FaHKQm8Hq1fQuSOBvX/sodmNJSB5geaF5CPIkUeecdMxieoRO5jz9bheL6/tXjrwCyX/UYBUcjCaWHljx1xiX6z9xEjkYAzbGVnB8pvLmyXm9ep+W8CmsSHQQY77Zx1zboxAV0w7ybMhQmfqdmmw3nEp1I0Z+FGO6M8LZdoyZnuzzBdjISicKRnpxzI9fPb+0oYXsNdyi+d3h9bm9MWYHFtPeIZfLwzmFDKy1ai3p+PDls1Llz4yyFpferxjnyjJDSEy9CaCx5m2cJPerq6Xm34eTrZt3PqxYO1XOwDYZrFlH1fWnpU38Y9HRze3lj0vOujZcXKuuXm3jP+s3KbZVra7y2EAAAAAASUVORK5CYII=" alt="Poetry">
+  </a>
+  <a href="https://github.com/astral-sh/ruff">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=flat-square" alt="Ruff">
+  </a>
+  <a href="https://github.com/pre-commit/pre-commit">
+    <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" alt="pre-commit">
+  </a>
+</p>
+<p align="center">
+  <a href="https://pypi.org/project/bleak-smlight/">
+    <img src="https://img.shields.io/pypi/v/bleak-smlight.svg?logo=python&logoColor=fff&style=flat-square" alt="PyPI Version">
+  </a>
+  <img src="https://img.shields.io/pypi/pyversions/bleak-smlight.svg?style=flat-square&logo=python&amp;logoColor=fff" alt="Supported Python versions">
+  <img src="https://img.shields.io/pypi/l/bleak-smlight.svg?style=flat-square" alt="License">
+</p>
+
+---
+
+**Documentation**: <a href="https://bleak-smlight.readthedocs.io" target="_blank">https://bleak-smlight.readthedocs.io </a>
+
+**Source Code**: <a href="https://github.com/bluetooth-devices/bleak-smlight" target="_blank">https://github.com/bluetooth-devices/bleak-smlight </a>
+
+---
+
+A [Bleak](https://github.com/hbldh/bleak) backend that receives Bluetooth Low
+Energy advertisements from a SMLIGHT SLZB BLE proxy. The proxy is scan only, so
+this library registers a non connectable scanner with
+[habluetooth](https://github.com/Bluetooth-Devices/habluetooth); it does not
+support GATT connections. The UDP proxy protocol lives in
+[pysmlight](https://github.com/smlight-tech/pysmlight), this library is the host
+side glue that feeds advertisements into Bleak. See the [architecture
+docs](https://bleak-smlight.readthedocs.io/en/latest/architecture.html) for how
+the pieces fit together.
+
+## Usage
+
+```python
+import asyncio
+
+import habluetooth
+
+from bleak_smlight import SMLIGHTConnectionManager, SMLIGHTDeviceConfig
+
+DEVICES: list[SMLIGHTDeviceConfig] = [
+    {"source": "AA:BB:CC:DD:EE:FF", "name": "slzb-proxy", "host": "10.0.0.5"},
+]
+
+
+async def main() -> None:
+    await habluetooth.BluetoothManager().async_setup()
+    managers = [SMLIGHTConnectionManager(d) for d in DEVICES]
+    await asyncio.gather(*(m.start() for m in managers))
+    try:
+        await asyncio.Event().wait()  # advertisements now flow into Bleak
+    finally:
+        await asyncio.gather(*(m.stop() for m in managers))
+
+
+asyncio.run(main())
+```
+
+## Installation
+
+Install this via pip (or your favourite package manager):
+
+`pip install bleak-smlight`
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- prettier-ignore-start -->
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- markdownlint-disable -->
+<!-- markdownlint-enable -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+<!-- prettier-ignore-end -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+
+## Credits
+
+This package was created with
+[Copier](https://copier.readthedocs.io/) and the
+[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template)
+project template.

bleak_smlight-1.0.0/build_ext.py

@@ -0,0 +1,64 @@
+"""Build optional cython modules."""
+
+import logging
+import os
+from typing import Any
+
+from distutils.command.build_ext import build_ext
+
+_LOGGER = logging.getLogger(__name__)
+
+try:
+    from setuptools import Extension
+except ImportError:
+    from distutils.core import Extension
+
+
+TO_CYTHONIZE = ["src/bleak_smlight/backend/scanner.py"]
+
+EXTENSIONS = [
+    Extension(
+        ext.removeprefix("src/").removesuffix(".py").replace("/", "."),
+        [ext],
+        language="c",
+        extra_compile_args=["-O3", "-g0"],
+    )
+    for ext in TO_CYTHONIZE
+]
+
+
+class BuildExt(build_ext):
+    """Build extension."""
+
+    def build_extensions(self) -> None:
+        """Build extensions."""
+        if getattr(self, "parallel", None) is None:
+            self.parallel = os.cpu_count() or 1
+        try:
+            super().build_extensions()
+        except Exception:  # nosec
+            _LOGGER.debug("Failed to build extensions", exc_info=True)
+
+
+def build(setup_kwargs: Any) -> None:
+    """Build optional cython modules."""
+    if os.environ.get("SKIP_CYTHON"):
+        return
+    try:
+        from Cython.Build import cythonize
+
+        setup_kwargs.update(
+            {
+                "ext_modules": cythonize(
+                    EXTENSIONS,
+                    compiler_directives={"language_level": "3"},  # Python 3
+                ),
+                "cmdclass": {"build_ext": BuildExt},
+            }
+        )
+        setup_kwargs["exclude_package_data"] = {
+            pkg: ["*.c"] for pkg in setup_kwargs["packages"]
+        }
+    except Exception:
+        if os.environ.get("REQUIRE_CYTHON"):
+            raise

bleak_smlight-1.0.0/pyproject.toml

@@ -0,0 +1,177 @@
+[project]
+name = "bleak-smlight"
+version = "1.0.0"
+description = "Bleak backend for SMLIGHT SLZB Bluetooth proxies"
+authors = [
+    { name = "Bluetooth Devices Authors", email = "bluetooth@koston.org" },
+    { name = "Tim Lunn", email = "tl@smlight.tech" },
+]
+license.text = "MIT"
+readme = "README.md"
+requires-python = ">=3.12,<4"
+
+[project.urls]
+"Documentation" = "https://bleak-smlight.readthedocs.io"
+"Repository" = "https://github.com/bluetooth-devices/bleak-smlight"
+"Bug Tracker" = "https://github.com/bluetooth-devices/bleak-smlight/issues"
+"Changelog" = "https://github.com/bluetooth-devices/bleak-smlight/blob/main/CHANGELOG.md"
+
+[tool.poetry]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries",
+]
+packages = [
+    { include = "bleak_smlight", from = "src" },
+]
+# Make sure we don't package temporary C files generated by the build process
+exclude = [ "**/*.c" ]
+
+[tool.poetry.build]
+generate-setup-file = true
+script = "build_ext.py"
+
+[tool.poetry.dependencies]
+python = ">=3.12,<4"
+bluetooth-data-tools = ">=1.18.0"
+habluetooth = ">=6.4.0"
+pysmlight = ">=0.4.0"
+
+[tool.poetry.group.dev.dependencies]
+pytest = ">=9.0.3,<10"
+pytest-cov = ">=3,<8"
+pytest-codspeed = "^5.0.2"
+pytest-asyncio = "^1.3.0"
+bleak-retry-connector = ">=3.8.0"
+bluetooth-adapters = ">=0.21.0"
+
+[tool.poetry.group.docs]
+optional = true
+
+[tool.poetry.group.docs.dependencies]
+myst-parser = ">=5.1.0"
+sphinx = ">=4.0"
+furo = ">=2023.5.20"
+sphinx-autobuild = ">=2021.3.14"
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+version_variables = [
+    "src/bleak_smlight/__init__.py:__version__",
+    "docs/conf.py:release",
+]
+build_command = "pip install poetry && poetry build"
+
+[tool.semantic_release.changelog]
+exclude_commit_patterns = [
+    "chore*",
+    "ci*",
+]
+
+[tool.semantic_release.changelog.environment]
+keep_trailing_newline = true
+
+[tool.semantic_release.branches.main]
+match = "main"
+
+[tool.semantic_release.branches.noop]
+match = "(?!main$)"
+prerelease = true
+
+[tool.pytest.ini_options]
+addopts = "-v -Wdefault --cov=bleak_smlight --cov-report=term-missing:skip-covered"
+pythonpath = ["src"]
+
+[tool.coverage.run]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "@overload",
+    "if TYPE_CHECKING",
+    "raise NotImplementedError",
+    'if __name__ == "__main__":',
+]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+
+[tool.ruff.lint]
+ignore = [
+    "D203", # 1 blank line required before class docstring
+    "D212", # Multi-line docstring summary should start at the first line
+    "D100", # Missing docstring in public module
+    "D104", # Missing docstring in public package
+    "D107", # Missing docstring in `__init__`
+    "D401", # First line of docstring should be in imperative mood
+]
+select = [
+    "B",       # flake8-bugbear
+    "D",       # flake8-docstrings
+    "C4",      # flake8-comprehensions
+    "S",       # flake8-bandit
+    "F",       # pyflake
+    "E",       # pycodestyle
+    "W",       # pycodestyle
+    "UP",      # pyupgrade
+    "I",       # isort
+    "RUF",     # ruff specific
+    "PLC0415", # pylint: import should be at top-level of file
+    "TC",      # flake8-type-checking
+    "PERF",    # Perflint: performance anti-patterns
+    "PIE",     # flake8-pie: misc lint
+    "LOG",     # flake8-logging
+    "G",       # flake8-logging-format
+    "RET",     # flake8-return
+    "FURB",    # refurb: modernize stdlib usage
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*" = [
+    "D100",
+    "D101",
+    "D102",
+    "D103",
+    "D104",
+    "S101",
+    "TC",
+]
+"setup.py" = ["D100"]
+"conftest.py" = ["D100"]
+"docs/conf.py" = ["D100"]
+"build_ext.py" = ["PLC0415"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["bleak_smlight", "tests"]
+
+[tool.mypy]
+check_untyped_defs = true
+disallow_any_generics = true
+disallow_incomplete_defs = true
+disallow_untyped_defs = true
+mypy_path = "src/"
+no_implicit_optional = true
+show_error_codes = true
+warn_unreachable = true
+warn_unused_ignores = true
+exclude = [
+    'docs/.*',
+    'setup.py',
+]
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+allow_untyped_defs = true
+
+[[tool.mypy.overrides]]
+module = "docs.*"
+ignore_errors = true
+
+[build-system]
+requires = ['setuptools>=75.8.2', 'Cython>=3', "poetry-core>=2.0.0"]
+build-backend = "poetry.core.masonry.api"

bleak_smlight-1.0.0/setup.py

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+from setuptools import setup
+
+package_dir = \
+{'': 'src'}
+
+packages = \
+['bleak_smlight', 'bleak_smlight.backend']
+
+package_data = \
+{'': ['*']}
+
+install_requires = \
+['bluetooth-data-tools>=1.18.0', 'habluetooth>=6.4.0', 'pysmlight>=0.4.0']
+
+setup_kwargs = {
+    'name': 'bleak-smlight',
+    'version': '1.0.0',
+    'description': 'Bleak backend for SMLIGHT SLZB Bluetooth proxies',
+    'long_description': '# bleak-smlight\n\n<p align="center">\n  <a href="https://github.com/bluetooth-devices/bleak-smlight/actions/workflows/ci.yml?query=branch%3Amain">\n    <img src="https://img.shields.io/github/actions/workflow/status/bluetooth-devices/bleak-smlight/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" >\n  </a>\n  <a href="https://bleak-smlight.readthedocs.io">\n    <img src="https://img.shields.io/readthedocs/bleak-smlight.svg?logo=read-the-docs&logoColor=fff&style=flat-square" alt="Documentation Status">\n  </a>\n  <a href="https://codecov.io/gh/bluetooth-devices/bleak-smlight">\n    <img src="https://img.shields.io/codecov/c/github/bluetooth-devices/bleak-smlight.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage">\n  </a>\n  <a href="https://codspeed.io/Bluetooth-Devices/bleak-smlight"><img src="https://img.shields.io/endpoint?url=https://codspeed.io/badge.json" alt="CodSpeed Badge"/></a>\n</p>\n<p align="center">\n  <a href="https://python-poetry.org/">\n    <img src="https://img.shields.io/badge/packaging-poetry-299bd7?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAASCAYAAABrXO8xAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAJJSURBVHgBfZLPa1NBEMe/s7tNXoxW1KJQKaUHkXhQvHgW6UHQQ09CBS/6V3hKc/AP8CqCrUcpmop3Cx48eDB4yEECjVQrlZb80CRN8t6OM/teagVxYZi38+Yz853dJbzoMV3MM8cJUcLMSUKIE8AzQ2PieZzFxEJOHMOgMQQ+dUgSAckNXhapU/NMhDSWLs1B24A8sO1xrN4NECkcAC9ASkiIJc6k5TRiUDPhnyMMdhKc+Zx19l6SgyeW76BEONY9exVQMzKExGKwwPsCzza7KGSSWRWEQhyEaDXp6ZHEr416ygbiKYOd7TEWvvcQIeusHYMJGhTwF9y7sGnSwaWyFAiyoxzqW0PM/RjghPxF2pWReAowTEXnDh0xgcLs8l2YQmOrj3N7ByiqEoH0cARs4u78WgAVkoEDIDoOi3AkcLOHU60RIg5wC4ZuTC7FaHKQm8Hq1fQuSOBvX/sodmNJSB5geaF5CPIkUeecdMxieoRO5jz9bheL6/tXjrwCyX/UYBUcjCaWHljx1xiX6z9xEjkYAzbGVnB8pvLmyXm9ep+W8CmsSHQQY77Zx1zboxAV0w7ybMhQmfqdmmw3nEp1I0Z+FGO6M8LZdoyZnuzzBdjISicKRnpxzI9fPb+0oYXsNdyi+d3h9bm9MWYHFtPeIZfLwzmFDKy1ai3p+PDls1Llz4yyFpferxjnyjJDSEy9CaCx5m2cJPerq6Xm34eTrZt3PqxYO1XOwDYZrFlH1fWnpU38Y9HRze3lj0vOujZcXKuuXm3jP+s3KbZVra7y2EAAAAAASUVORK5CYII=" alt="Poetry">\n  </a>\n  <a href="https://github.com/astral-sh/ruff">\n    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=flat-square" alt="Ruff">\n  </a>\n  <a href="https://github.com/pre-commit/pre-commit">\n    <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" alt="pre-commit">\n  </a>\n</p>\n<p align="center">\n  <a href="https://pypi.org/project/bleak-smlight/">\n    <img src="https://img.shields.io/pypi/v/bleak-smlight.svg?logo=python&logoColor=fff&style=flat-square" alt="PyPI Version">\n  </a>\n  <img src="https://img.shields.io/pypi/pyversions/bleak-smlight.svg?style=flat-square&logo=python&amp;logoColor=fff" alt="Supported Python versions">\n  <img src="https://img.shields.io/pypi/l/bleak-smlight.svg?style=flat-square" alt="License">\n</p>\n\n---\n\n**Documentation**: <a href="https://bleak-smlight.readthedocs.io" target="_blank">https://bleak-smlight.readthedocs.io </a>\n\n**Source Code**: <a href="https://github.com/bluetooth-devices/bleak-smlight" target="_blank">https://github.com/bluetooth-devices/bleak-smlight </a>\n\n---\n\nA [Bleak](https://github.com/hbldh/bleak) backend that receives Bluetooth Low\nEnergy advertisements from a SMLIGHT SLZB BLE proxy. The proxy is scan only, so\nthis library registers a non connectable scanner with\n[habluetooth](https://github.com/Bluetooth-Devices/habluetooth); it does not\nsupport GATT connections. The UDP proxy protocol lives in\n[pysmlight](https://github.com/smlight-tech/pysmlight), this library is the host\nside glue that feeds advertisements into Bleak. See the [architecture\ndocs](https://bleak-smlight.readthedocs.io/en/latest/architecture.html) for how\nthe pieces fit together.\n\n## Usage\n\n```python\nimport asyncio\n\nimport habluetooth\n\nfrom bleak_smlight import SMLIGHTConnectionManager, SMLIGHTDeviceConfig\n\nDEVICES: list[SMLIGHTDeviceConfig] = [\n    {"source": "AA:BB:CC:DD:EE:FF", "name": "slzb-proxy", "host": "10.0.0.5"},\n]\n\n\nasync def main() -> None:\n    await habluetooth.BluetoothManager().async_setup()\n    managers = [SMLIGHTConnectionManager(d) for d in DEVICES]\n    await asyncio.gather(*(m.start() for m in managers))\n    try:\n        await asyncio.Event().wait()  # advertisements now flow into Bleak\n    finally:\n        await asyncio.gather(*(m.stop() for m in managers))\n\n\nasyncio.run(main())\n```\n\n## Installation\n\nInstall this via pip (or your favourite package manager):\n\n`pip install bleak-smlight`\n\n## Contributors ✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n<!-- prettier-ignore-start -->\n<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n<!-- markdownlint-disable -->\n<!-- markdownlint-enable -->\n<!-- ALL-CONTRIBUTORS-LIST:END -->\n<!-- prettier-ignore-end -->\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n\n## Credits\n\nThis package was created with\n[Copier](https://copier.readthedocs.io/) and the\n[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template)\nproject template.\n',
+    'author': 'Bluetooth Devices Authors',
+    'author_email': 'bluetooth@koston.org',
+    'maintainer': 'None',
+    'maintainer_email': 'None',
+    'url': 'https://github.com/bluetooth-devices/bleak-smlight',
+    'package_dir': package_dir,
+    'packages': packages,
+    'package_data': package_data,
+    'install_requires': install_requires,
+    'python_requires': '>=3.12,<4',
+}
+from build_ext import *
+build(setup_kwargs)
+
+setup(**setup_kwargs)

bleak_smlight-1.0.0/src/bleak_smlight/__init__.py

@@ -0,0 +1,15 @@
+"""Host-side Bleak backend for SMLIGHT SLZB BLE proxies."""
+
+from .connect import SLZB_BLE_SERVER_PORT, SMLIGHTClientData, connect_scanner
+from .connection_manager import SMLIGHTConnectionManager, SMLIGHTDeviceConfig
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "SLZB_BLE_SERVER_PORT",
+    "SMLIGHTClientData",
+    "SMLIGHTConnectionManager",
+    "SMLIGHTDeviceConfig",
+    "__version__",
+    "connect_scanner",
+]

bleak_smlight-1.0.0/src/bleak_smlight/backend/scanner.pxd

@@ -0,0 +1,3 @@
+
+
+cdef object MONOTONIC_TIME

bleak_smlight-1.0.0/src/bleak_smlight/backend/scanner.py

@@ -0,0 +1,40 @@
+"""Bluetooth scanner for SMLIGHT SLZB BLE proxy devices."""
+
+from __future__ import annotations
+
+from bluetooth_data_tools import monotonic_time_coarse as MONOTONIC_TIME
+from habluetooth.base_scanner import BaseHaRemoteScanner
+
+
+class SMLIGHTScanner(BaseHaRemoteScanner):
+    """
+    Remote scanner fed by a SMLIGHT SLZB BLE proxy.
+
+    The SLZB firmware only relays raw BLE advertisements over UDP; it has
+    no GATT/active-connection support, so the scanner is always registered
+    as non-connectable and has no client to talk back to.
+    """
+
+    def _handle_raw_advertisement(
+        self,
+        device_mac: str,
+        rssi: int,
+        address_type: int,
+        raw_data: bytes,
+    ) -> None:
+        """
+        Forward one proxied advertisement to habluetooth.
+
+        This is the callback handed to ``pysmlight.BleProxyClient``. The
+        proxy client already decodes the MAC into the canonical
+        ``AA:BB:CC:DD:EE:FF`` string and converts the RSSI to a signed
+        ``int``, so the values can be passed straight through without any
+        further conversion.
+        """
+        self._async_on_raw_advertisement(
+            device_mac,
+            rssi,
+            raw_data,
+            {"address_type": address_type},
+            MONOTONIC_TIME(),
+        )

bleak_smlight-1.0.0/src/bleak_smlight/connect.py

@@ -0,0 +1,57 @@
+"""Bluetooth proxy support for SMLIGHT SLZB devices."""
+
+from __future__ import annotations
+
+import logging
+from dataclasses import dataclass
+
+from pysmlight import BleProxyClient
+
+from .backend.scanner import SMLIGHTScanner
+
+_LOGGER = logging.getLogger(__name__)
+
+# Default UDP port of the SLZB BLE proxy server (SLZB-OS).
+SLZB_BLE_SERVER_PORT = 5050
+
+
+@dataclass(slots=True)
+class SMLIGHTClientData:
+    """The scanner and its BLE proxy client for one SLZB device."""
+
+    scanner: SMLIGHTScanner
+    client: BleProxyClient
+
+
+def connect_scanner(
+    source: str,
+    name: str,
+    host: str,
+    port: int = SLZB_BLE_SERVER_PORT,
+) -> SMLIGHTClientData:
+    """
+    Build a scanner and BLE proxy client for an SLZB device.
+
+    ``source`` is the stable unique identifier for the proxy (typically
+    its MAC address); ``name`` is the human-friendly adapter name;
+    ``host`` is the IP/hostname the UDP proxy server listens on.
+
+    The caller is responsible for:
+
+    1. Calling ``data.scanner.async_setup()``.
+    2. Registering ``data.scanner`` with the habluetooth manager (and
+       unregistering it on teardown).
+    3. Calling ``await data.client.start()`` to begin receiving
+       advertisements, and ``data.client.stop()`` on teardown.
+
+    :class:`SMLIGHTConnectionManager` wires all of this up for the common
+    standalone case.
+    """
+    _LOGGER.debug("%s [%s]: Connecting scanner to %s:%s", name, source, host, port)
+    scanner = SMLIGHTScanner(source, name, None, False)
+    client = BleProxyClient(
+        esp32_ip=host,
+        callback=scanner._handle_raw_advertisement,
+        esp32_port=port,
+    )
+    return SMLIGHTClientData(scanner=scanner, client=client)

bleak_smlight-1.0.0/src/bleak_smlight/connection_manager.py

@@ -0,0 +1,84 @@
+"""Standalone connection manager for a SMLIGHT SLZB BLE proxy."""
+
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, NotRequired, TypedDict
+
+from habluetooth import get_manager
+
+from .connect import SLZB_BLE_SERVER_PORT, connect_scanner
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+    from pysmlight import BleProxyClient
+
+_LOGGER = logging.getLogger(__name__)
+
+
+class SMLIGHTDeviceConfig(TypedDict):
+    """Configuration for one SMLIGHT SLZB BLE proxy device."""
+
+    source: str
+    name: str
+    host: str
+    port: NotRequired[int]
+
+
+class SMLIGHTConnectionManager:
+    """
+    Manage a scanner for a SMLIGHT SLZB BLE proxy.
+
+    Construction is side-effect-free and does not require a running event
+    loop; all asyncio work happens in :meth:`start`. The underlying
+    ``BleProxyClient`` owns its own connect/retry loop, so the manager only
+    has to register the scanner with the habluetooth manager and start the
+    proxy client.
+    """
+
+    def __init__(self, config: SMLIGHTDeviceConfig) -> None:
+        """Initialize the connection manager from ``config``."""
+        self._source = config["source"]
+        self._name = config["name"]
+        self._host = config["host"]
+        self._port = config.get("port", SLZB_BLE_SERVER_PORT)
+        self._client: BleProxyClient | None = None
+        self._unregister_scanner: Callable[[], None] | None = None
+        self._unsetup_scanner: Callable[[], None] | None = None
+
+    async def start(self) -> None:
+        """
+        Build the scanner, register it, and start the BLE proxy client.
+
+        Call once per manager instance; a second call raises
+        ``RuntimeError`` rather than leaking the prior proxy client and its
+        background reconnect task.
+
+        Raises:
+            RuntimeError: if :meth:`start` has already been called.
+
+        """
+        if self._client is not None:
+            raise RuntimeError(
+                "SMLIGHTConnectionManager.start() has already been called; "
+                "create a new manager instance to reconnect."
+            )
+        data = connect_scanner(self._source, self._name, self._host, self._port)
+        scanner = data.scanner
+        self._unsetup_scanner = scanner.async_setup()
+        self._unregister_scanner = get_manager().async_register_scanner(scanner)
+        self._client = data.client
+        await self._client.start()
+
+    async def stop(self) -> None:
+        """Stop the BLE proxy client and unregister the scanner."""
+        if self._client is not None:
+            self._client.stop()
+            self._client = None
+        if self._unregister_scanner is not None:
+            self._unregister_scanner()
+            self._unregister_scanner = None
+        if self._unsetup_scanner is not None:
+            self._unsetup_scanner()
+            self._unsetup_scanner = None