libmdr-bt 0.1.0__py3-none-win_amd64.whl

libmdr_bt/__init__.py

@@ -0,0 +1,8 @@
+"""Python bindings for mdr-bt-shared (libmdr-bt)."""
+
+from .connection import PlatformConnection, create_connection
+
+__all__ = [
+    "PlatformConnection",
+    "create_connection",
+]

libmdr_bt/_dll.py

@@ -0,0 +1,121 @@
+"""ctypes loader for mdr-bt-shared (libmdr-bt)."""
+
+from __future__ import annotations
+
+import os
+import sys
+from ctypes import CDLL
+from pathlib import Path
+
+import libmdr._dll as libmdr_dll
+
+_LIB: CDLL | None = None
+
+_ENV_OVERRIDE = "MDR_BT_DLL"
+
+_CANDIDATE_NAMES = (
+    "mdr-bt-shared.dll",
+    "libmdr-bt-shared.so",
+    "libmdr-bt-shared.dylib",
+    "mdr-bt-shared.so",
+    "mdr-bt-shared.dylib",
+)
+
+_CORE_NAMES = (
+    "mdr-shared.dll",
+    "mdr.dll",
+    "libmdr-shared.so",
+    "libmdr-shared.dylib",
+    "mdr-shared.so",
+    "mdr-shared.dylib",
+)
+
+
+def _package_native_dir() -> Path:
+    return Path(__file__).resolve().parent / "_native"
+
+
+def _candidate_paths() -> list[Path]:
+    paths: list[Path] = []
+    override = os.environ.get(_ENV_OVERRIDE)
+    if override:
+        paths.append(Path(override))
+
+    native = _package_native_dir()
+    for name in _CANDIDATE_NAMES:
+        paths.append(native / name)
+
+    repo_build = Path(__file__).resolve().parents[4] / "build" / "python"
+    if repo_build.is_dir():
+        for name in _CANDIDATE_NAMES:
+            paths.extend(repo_build.rglob(name))
+
+    return paths
+
+
+def _ensure_core_loaded(platform_dir: Path) -> None:
+    if libmdr_dll._LIB is not None:  # noqa: SLF001
+        return
+
+    for name in _CORE_NAMES:
+        sibling = platform_dir / name
+        if sibling.is_file():
+            libmdr_dll._LIB = libmdr_dll._load_path(sibling)  # noqa: SLF001
+            return
+
+    libmdr_dll.load()
+
+
+def _load_path(path: Path) -> CDLL:
+    path = path.resolve()
+    if not path.is_file():
+        raise FileNotFoundError(path)
+
+    _ensure_core_loaded(path.parent)
+
+    if sys.platform == "win32":
+        os.add_dll_directory(str(path.parent))
+        core_dir = libmdr_dll._package_native_dir()  # noqa: SLF001
+        if core_dir.is_dir():
+            os.add_dll_directory(str(core_dir))
+        return CDLL(str(path))
+
+    mode = os.RTLD_GLOBAL if hasattr(os, "RTLD_GLOBAL") else 0
+    return CDLL(str(path), mode=mode)
+
+
+def load() -> CDLL:
+    global _LIB
+    if _LIB is not None:
+        return _LIB
+
+    errors: list[str] = []
+    seen: set[Path] = set()
+    for candidate in _candidate_paths():
+        try:
+            resolved = candidate.resolve()
+        except OSError as exc:
+            errors.append(f"{candidate}: {exc}")
+            continue
+        if resolved in seen:
+            continue
+        seen.add(resolved)
+        try:
+            _LIB = _load_path(resolved)
+            return _LIB
+        except OSError as exc:
+            errors.append(f"{resolved}: {exc}")
+
+    hint = (
+        f"Set {_ENV_OVERRIDE} to the full path of mdr-bt-shared.dll, "
+        f"or `pip install -e libmdr-bt` to build it."
+    )
+    raise FileNotFoundError(
+        "Unable to load mdr-bt-shared.\n"
+        + "\n".join(errors)
+        + ("\n" + hint if errors else hint)
+    )
+
+
+def lib() -> CDLL:
+    return load()

libmdr_bt/connection.py

@@ -0,0 +1,138 @@
+"""Platform connection factories wrapping mdr-bt-shared (libmdr-bt)."""
+
+from __future__ import annotations
+
+import sys
+from ctypes import c_void_p
+from typing import Literal
+
+from libmdr.connection import Connection
+
+from . import _dll
+
+Backend = Literal["auto", "classic", "ble"]
+
+
+def _bind_factory(create_name: str, get_name: str, destroy_name: str):
+    lib = _dll.lib()
+    create = getattr(lib, create_name)
+    getter = getattr(lib, get_name)
+    destroy = getattr(lib, destroy_name)
+
+    create.restype = c_void_p
+    create.argtypes = []
+    getter.restype = c_void_p
+    getter.argtypes = [c_void_p]
+    destroy.restype = None
+    destroy.argtypes = [c_void_p]
+    return create, getter, destroy
+
+
+class PlatformConnection:
+    """Owns a platform-specific connection object and exposes the MDRConnection vtable."""
+
+    def __init__(self, backend: Backend = "auto") -> None:
+        self._backend = "classic" if backend == "auto" else backend
+        self._owner: c_void_p | None = None
+        self._connection: Connection | None = None
+        self._destroy = None
+        self._create()
+
+    def _factories(self):
+        platform = sys.platform
+        if platform == "win32":
+            if self._backend == "ble":
+                return _bind_factory(
+                    "mdrConnectionWindowsBLECreate",
+                    "mdrConnectionWindowsBLEGet",
+                    "mdrConnectionWindowsBLEDestroy",
+                )
+            return _bind_factory(
+                "mdrConnectionWindowsCreate",
+                "mdrConnectionWindowsGet",
+                "mdrConnectionWindowsDestroy",
+            )
+        if platform == "darwin":
+            if self._backend == "ble":
+                raise RuntimeError("BLE backend is not available on macOS in mdr-bt-shared")
+            return _bind_factory(
+                "mdrConnectionMacOSCreate",
+                "mdrConnectionMacOSGet",
+                "mdrConnectionMacOSDestroy",
+            )
+        if platform.startswith("linux"):
+            if self._backend == "ble":
+                raise RuntimeError("BLE backend is not available on Linux in mdr-bt-shared")
+            return _bind_factory(
+                "mdrConnectionLinuxCreate",
+                "mdrConnectionLinuxGet",
+                "mdrConnectionLinuxDestroy",
+            )
+        raise RuntimeError(f"Unsupported platform for libmdr-bt bindings: {platform}")
+
+    def _create(self) -> None:
+        create, getter, destroy = self._factories()
+        owner = create()
+        if not owner:
+            raise RuntimeError(f"Failed to create platform connection ({self._backend})")
+        connection = getter(owner)
+        if not connection:
+            destroy(owner)
+            raise RuntimeError("Platform connection Get() returned null")
+
+        self._destroy = destroy
+        self._owner = c_void_p(owner)
+        self._connection = Connection(connection)
+
+    @property
+    def backend(self) -> str:
+        return self._backend
+
+    @property
+    def connection(self) -> Connection:
+        if self._connection is None:
+            raise RuntimeError("Platform connection is closed")
+        return self._connection
+
+    def close(self) -> None:
+        if self._owner is not None and self._destroy is not None:
+            self._destroy(self._owner)
+            self._owner = None
+            self._connection = None
+
+    def __enter__(self) -> PlatformConnection:
+        return self
+
+    def __exit__(self, *exc: object) -> None:
+        self.close()
+
+    def __del__(self) -> None:
+        try:
+            self.close()
+        except Exception:
+            pass
+
+    def devices(self):
+        return self.connection.devices()
+
+    def connect(self, mac_address: str, service_uuid: str) -> int:
+        return self.connection.connect(mac_address, service_uuid)
+
+    def disconnect(self) -> None:
+        self.connection.disconnect()
+
+    def poll(self, timeout_ms: int = 0) -> int:
+        return self.connection.poll(timeout_ms)
+
+    def last_error(self) -> str:
+        return self.connection.last_error()
+
+
+def create_connection(*, ble: bool = False, backend: Backend | None = None) -> PlatformConnection:
+    """Create the host platform connection.
+
+    Prefer `ble=True` / `backend="ble"` on Windows when talking over GATT.
+    """
+    if backend is None:
+        backend = "ble" if ble else "classic"
+    return PlatformConnection(backend=backend)

libmdr_bt-0.1.0.dist-info/METADATA

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: libmdr-bt
+Version: 0.1.0
+Summary: Python binding for libmdr-bt (Sony headphones platform connection backend)
+License-Expression: MIT
+Project-URL: Source, https://github.com/mos9527/libmdr-py
+Requires-Python: >=3.10
+Description-Content-Type: text/plain
+License-File: LICENSE
+Requires-Dist: libmdr
+Dynamic: license-file
+
+ctypes bindings for libmdr-bt (mdr-bt-shared).

libmdr_bt-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+libmdr_bt/__init__.py,sha256=1IjbXTeOBZX4EZ3ELksbFrNIV8P40SPVENseQ07JDEk,190
+libmdr_bt/_dll.py,sha256=XQrJO3za7u3s7OX5L9J5Y9heP9HMuy1hy6a0BjRZGBs,3018
+libmdr_bt/connection.py,sha256=41oC_sFTe4VAUA6gBFHNAAwXT3ZDRVg7n1DXy5yztVE,4557
+libmdr_bt/_native/mdr-bt-shared.dll,sha256=aniLNq-DMwWHc80tGv2vdDRhcFVoPJR0EGyMhD_OtoM,142848
+libmdr_bt-0.1.0.dist-info/licenses/LICENSE,sha256=kV52ZgBjnUFxShyLDgnkngrD6PPJAmTI4I1wGVvEhcE,1120
+libmdr_bt-0.1.0.dist-info/METADATA,sha256=rboDU-ZnhXlUOUmsZVAKOOax6UnaAYwqgNTqsvVbhaw,407
+libmdr_bt-0.1.0.dist-info/WHEEL,sha256=79BCzrXBJOa2YV6ugKrK59dqWifMGjAkgVd_6AQrqbU,98
+libmdr_bt-0.1.0.dist-info/top_level.txt,sha256=u9q-JGv0hsMLpGpu6n5aZ8bhB8h4GjzOdoCemkoB360,10
+libmdr_bt-0.1.0.dist-info/RECORD,,

libmdr_bt-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64
+

libmdr_bt-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mos9527, Amr Satrio and other contributors
+
+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.

libmdr_bt-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+libmdr_bt