vsslctrl 0.1.12.dev1__py3-none-any.whl → 0.1.13.dev1__py3-none-any.whl

vsslctrl/__init__.py

@@ -1,4 +1,4 @@
-VSSL_VERSION = "0.1.12.dev1"
+VSSL_VERSION = "0.1.13.dev1"
 VSSL_NAME = "VSSL"
 
 from .core import Vssl

vsslctrl/api_alpha.py

@@ -39,6 +39,12 @@ class APIAlpha(APIBase):
         self.vssl = vssl_host
         self.zone = zone
 
+    #
+    # Send event on event bus
+    #
+    def _event_publish(self, event_type, data=None):
+        self.zone._event_publish(event_type, (self.zone.host, self.TCP_PORT))
+
     #
     # Send keep alive
     #

vsslctrl/api_base.py

@@ -45,6 +45,17 @@ class APIBase(ABC):
 
     FRIST_BYTE = 1
 
+    #
+    # API Events
+    #
+    class Events:
+        PREFIX = "zone.api."
+        CONNECTING = PREFIX + "connecting"
+        CONNECTED = PREFIX + "connected"
+        DISCONNECTING = PREFIX + "disconnecting"
+        DISCONNECTED = PREFIX + "disconnected"
+        RECONNECTING = PREFIX + "reconnecting"
+
     def __init__(self, host, port):
         self.host = host
         self.port = port
@@ -89,6 +100,7 @@ class APIBase(ABC):
             return self.connected
 
         self._connecting = True
+        self._event_publish(self.Events.CONNECTING)
 
         try:
             self._log_debug(f"Attemping connection to {self.host}:{self.port}")
@@ -98,6 +110,7 @@ class APIBase(ABC):
 
             # Connected
             self.connection_event.set()
+            self._event_publish(self.Events.CONNECTED)
 
             # cancel any reconnecting loops
             self._cancel_keep_connected()
@@ -140,6 +153,7 @@ class APIBase(ABC):
     @final
     async def disconnect(self):
         self._disconnecting = True
+        self._event_publish(self.Events.DISCONNECTING)
 
         # cancel any reconnecting loops
         self._cancel_keep_connected()
@@ -176,6 +190,8 @@ class APIBase(ABC):
 
         self._disconnecting = False
 
+        self._event_publish(self.Events.DISCONNECTED)
+
         return not self.connected
 
     #
@@ -184,7 +200,9 @@ class APIBase(ABC):
     @final
     async def reconnect(self):
         if not self._reconnecting and not self._is_keep_connected_running():
+            self._event_publish(self.Events.RECONNECTING)
             await self.disconnect()
+            await asyncio.sleep(1)
             self._keep_connected()
 
     #
@@ -306,6 +324,13 @@ class APIBase(ABC):
     async def _read_byte_stream(self):
         pass
 
+    #
+    # Send event on event bus
+    #
+    @abstractmethod
+    def _event_publish(self, event_type, data=None):
+        pass
+
     #
     # Send a keep alive
     #

vsslctrl/api_bravo.py

@@ -23,6 +23,12 @@ class APIBravo(APIBase):
         self.vssl = vssl_host
         self.zone = zone
 
+    #
+    # Send event on event bus
+    #
+    def _event_publish(self, event_type, data=None):
+        self.zone._event_publish(event_type, (self.zone.host, self.TCP_PORT))
+
     #
     # Send keep alive
     #

vsslctrl/core.py

@@ -28,7 +28,6 @@ class Vssl:
         MODEL_CHANGE = PREFIX + "model_changed"
         SW_VERSION_CHANGE = PREFIX + "sw_version_changed"
         SERIAL_CHANGE = PREFIX + "serial_changed"
-        ALL = EventBus.WILDCARD
 
     def __init__(self, model: Models):
         self.event_bus = EventBus()
@@ -50,7 +49,7 @@ class Vssl:
     #
     async def initialise(self, init_timeout: int = 10):
         if len(self.zones) < 1:
-            raise VsslCtrlException("Add atleast one zone before initializing")
+            raise VsslCtrlException("Add minimum one zone before initializing")
 
         zones_to_init = self.zones.copy()
 
@@ -64,9 +63,9 @@ class Vssl:
             await first_zone.initialise()
 
             # Wait until we have some basic infomation
-            await self.event_bus.wait_future(future_serial)
-            await self.event_bus.wait_future(future_sw_version)
-            await self.event_bus.wait_future(future_name)
+            await self.event_bus.wait_future(future_serial, init_timeout)
+            await self.event_bus.wait_future(future_sw_version, init_timeout)
+            await self.event_bus.wait_future(future_name, init_timeout)
 
             # Check we haven't added too many zones
             if len(self.zones) > self.model.zone_count:
@@ -92,7 +91,7 @@ class Vssl:
             raise
 
         except asyncio.TimeoutError:
-            message = f"Timeout during VSSL initialization. Are any zones avaiable?"
+            message = f"Timeout during VSSL initialization. Are any zones available?"
             self._log_critical(message)
             await first_zone.disconnect()
             raise VsslCtrlException(message)
@@ -114,17 +113,14 @@ class Vssl:
     #
     # Discover host on the network using zero_conf package
     #
-    async def discover(self, *args):
-        try:
-            check_zeroconf_availability()
+    @staticmethod
+    async def discover(*args):
+        check_zeroconf_availability()
 
-            from .discovery import VsslDiscovery
+        from .discovery import VsslDiscovery
 
-            service = VsslDiscovery(*args)
-            return await service.discover()
-        except ZeroConfNotInstalled as e:
-            self._log_error(e)
-            raise
+        service = VsslDiscovery(*args)
+        return await service.discover()
 
     #
     # Update a property and fire an event
@@ -257,7 +253,7 @@ class Vssl:
             return None
 
     #
-    # Get a Zone that is connected
+    # Get a zone that is connected
     #
     def get_connected_zone(self):
         if self.zones:
@@ -265,6 +261,14 @@ class Vssl:
                 zone = self.zones[zone_id]
                 if zone.connected:
                     return zone
+        self._log_error("There are no connected zones.")
+
+    #
+    # Has a connected zone
+    #
+    @property
+    def connected(self):
+        return True if self.get_connected_zone() else False
 
     #
     # Get the device name

vsslctrl/event_bus.py

@@ -1,14 +1,11 @@
 import asyncio
 import traceback
+import fnmatch
 from enum import IntEnum
 from typing import Callable
 from .exceptions import VsslCtrlException
 from .decorators import logging_helpers
 
-#
-# Event Bus
-#
-
 
 @logging_helpers("EventBus:")
 class EventBus:
@@ -23,6 +20,10 @@ class EventBus:
 
         self.process = asyncio.create_task(self.process_events())
 
+    # Helper for wildcard matching, so we can use partial wildcards. e.g zone.api.connected
+    def _matches_pattern(self, event_type, pattern):
+        return fnmatch.fnmatch(event_type, pattern)
+
     #
     # Stop
     #
@@ -67,7 +68,8 @@ class EventBus:
 
         async def future_callback(data, *args):
             nonlocal future
-            future.set_result(data)
+            if not future.done():  # Ensure the future is not already resolved
+                future.set_result(data)
 
         self.subscribe(event_type, future_callback, entity, once=True)
 
@@ -115,12 +117,8 @@ class EventBus:
         event_type = event_type.lower()
         await self.event_queue.put((event_type, entity, data))
 
-    #
-    # Process Events
-    #
     async def process_events(self):
         self._log_debug(f"starting event processing")
-
         self.running = True
         while self.running:
             try:
@@ -136,23 +134,22 @@ class EventBus:
                         message += str(data)
                     self._log_debug(message)
 
-                for event in [event_type, self.WILDCARD]:
-                    if event in self.subscribers:
-                        for callback, subscribed_entity, once in self.subscribers[
-                            event
-                        ]:
-                            if entity is None or subscribed_entity in {
-                                entity,
-                                self.WILDCARD,
-                            }:
-                                await callback(data, entity, event_type)
-                                if once:
-                                    self.unsubscribe(event, callback)
+                # Check for matching subscribers, including wildcards.
+                # e.g "zone.*", "zone.api.*"
+                matched_subscribers = []
+                for pattern in self.subscribers:
+                    if self._matches_pattern(event_type, pattern):
+                        matched_subscribers.extend(self.subscribers[pattern])
+
+                for callback, subscribed_entity, once in matched_subscribers:
+                    if entity is None or subscribed_entity in {entity, self.WILDCARD}:
+                        await callback(data, entity, event_type)
+                        if once:
+                            self.unsubscribe(pattern, callback)
 
             except asyncio.CancelledError:
                 break
             except Exception as e:
-                # Capture the traceback as a string
                 traceback_str = traceback.format_exc()
                 self._log_error(
                     f"exception occurred processing event: {e}\n{traceback_str}"

vsslctrl/zone.py

@@ -29,7 +29,6 @@ class Zone:
     # Zone Events
     #
     class Events:
-        ALL = "*"
         PREFIX = "zone."
         INITIALISED = PREFIX + "initialised"
         ID_RECEIVED = PREFIX + "id_received"
@@ -79,7 +78,7 @@ class Zone:
         )
 
     # Initialise
-    async def initialise(self):
+    async def initialise(self, init_timeout: int = 10):
         # Data we require from the device
         future_id = self.vssl.event_bus.future(self.Events.ID_RECEIVED, self.id)
         future_serial = self.vssl.event_bus.future(self.Events.SERIAL_RECEIVED, self.id)
@@ -106,13 +105,15 @@ class Zone:
 
         try:
             # Wait for the ID, serial and name to be returned from the device
-            received_id = await self.vssl.event_bus.wait_future(future_id)
-            received_serial = await self.vssl.event_bus.wait_future(future_serial)
-            await self.vssl.event_bus.wait_future(future_name)
+            received_id = await self.vssl.event_bus.wait_future(future_id, init_timeout)
+            received_serial = await self.vssl.event_bus.wait_future(
+                future_serial, init_timeout
+            )
+            await self.vssl.event_bus.wait_future(future_name, init_timeout)
         except asyncio.TimeoutError:
-            message = f"Zone {self.id}: initialization timeout. Is the zone avaiable?"
+            message = f"Zone {self.id}: initialization timeout. Is the zone available?"
             self._log_critical(message)
-            await first_zone.disconnect()
+            await self.disconnect()
             raise ZoneError(message)
 
         # Confirm the zone id is matches the returned zone ID

{vsslctrl-0.1.12.dev1.dist-info → vsslctrl-0.1.13.dev1.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: vsslctrl
-Version: 0.1.12.dev1
+Version: 0.1.13.dev1
 Summary: Package for controlling VSSL's range of streaming amplifiers
 Author-email: vsslctrl <vsslcontrolled@proton.me>
 Classifier: Development Status :: 4 - Beta
@@ -76,7 +76,7 @@ async def main():
   vssl = Vssl(DeviceModels.A1)
   a1 = vssl.add_zone('192.168.1.10')
 
-  # Connect and initiate zones.
+  # Connect and initialise zone.
   await vssl.initialise()
 
   """Control Examples"""
@@ -112,7 +112,7 @@ async def main():
   zone3 = vssl.add_zone('192.168.1.12', ZoneIDs.ZONE_3)
   #... up to 6 zones for A.6(x)
 
-  # Connect and initiate zones.
+  # Connect and initialise zones.
   await vssl.initialise()
 
   """Control Examples"""
@@ -134,6 +134,77 @@ async def main():
 asyncio.run(main())
 ```
 
+### Device Discovery Helper
+
+You can discover VSSL devices on the network using [mDNS](https://wikipedia.org/wiki/Multicast_DNS) / Bonjour if you have the [`zeroconf`](https://pypi.org/project/zeroconf/) package installed.
+
+This uses airplay service string `_airplay._tcp.local.`, therefore airplay needs to available and will not work across VLANs without other provisions.
+
+**Note:** This is designed to be a helper and its not recommended to be used for the initialization of the VSSL class.
+
+```python
+import asyncio
+from vsslctrl import Vssl
+
+async def main():
+  
+  print(await Vssl.discover())
+
+  """
+    {
+        'XXXXXXXXXXXX': [
+            {
+                'host': '192.168.168.25',
+                'name': 'Living Room',
+                'model': 'A1x',
+                'mac_addr': 'AA:BB:CC:DD:EE:FF',
+                'zone_id': '7',
+                'serial': 'XXXXXXXXXXXX'
+            }
+        ]
+    }
+
+  """
+
+asyncio.run(main())
+```
+
+
+# API Functionality
+
+Most functionality is achieved via `getters` and `setters` of the two main classes `Vssl`, `Zone`. 
+
+The classes will update the physical VSSL device when setting a property and once feedback has been received, the classes internal state will be updated. For example:
+
+```python
+# Setting the zone name
+zone1.settings.name = 'Living Room'
+>>> 'Old Zone Name'
+
+# Printing zone name
+print(zone1.settings.name)
+>>> 'Living Room'
+```
+
+**Important** in the above example, `zone1.settings.name` won't be set to its new value until after the VSSL device has changed the name and the `Zone` class has received confirmation feedback. If you need to wait for the value change, you can await a `[property_name]_CHANGE` events as below:
+
+```python
+from vsslctrl.settings import ZoneSettings
+# Setting the zone name and wait for feedback
+future_name = vssl.event_bus.future(ZoneSettings.Events.NAME_CHANGE, zone1.id)
+zone1.settings.name = 'Bathroom' 
+# Helper to await a future with timeout
+new_name = await vssl.event_bus.wait_future(future_name)
+# Printing zone name
+print(new_name)
+>>> 'Bathroom'
+# or
+print(zone1.settings.name)
+>>> 'Bathroom'
+```
+
+# API Reference
+
 # `DeviceModels`
 
 A device model has to be passed to VSSL so it knows internally what features are supported by the device.
@@ -150,35 +221,20 @@ This might be removed in the future if we can differentiate different models fro
 
 # `ZoneIDs`
 
-| Property        | Description |
-| ------------|---------  | 
-| `A1`        | A.1(x) Only      | 
-| `ZONE_1`    | Zone 1 of A.3(x) and A.6(x)   | 
-| `ZONE_2`    | Zone 2 of A.3(x) and A.6(x)    | 
-| `ZONE_3`    | Zone 3 of A.3(x) and A.6(x)  | 
-| `ZONE_4`    | Zone 4 of A.6(x)     | 
-| `ZONE_5`    | Zone 5 of A.6(x)       | 
-| `ZONE_6`    | Zone 6 of A.6(x)       | 
+A `ZoneIDs` must be passed to each `zone` you which to control and it must match the zone on the VSSL device.
 
+If you are unsure of your `ZoneIDs` you could use the discovery helper to find out the correct mapping.
 
-# API
-
-Most functionality is achieved via `getters` and `setters` of the two main classes `Vssl`, `Zone`. 
-
-The classes will update the physical VSSL device when setting a property and once feedback has been received, the classes internal state will be updated. For example:
-
-```python
-# Setting the zones name
-zone1.settings.name = 'Living Room'
->>> None
-
-# Printing zone name
-zone_name = zone1.settings.name
-print(zone_name)
->>> 'Living Room'
-```
+| Property        | Description | A.1(x) | A.3(x) | A.6(x)
+| ------------|---------  |--------  | --------  | --------  |  
+| `A1`        |       |✔️ | | |
+| `ZONE_1`    | Zone 1   | | ✔️| ✔️|
+| `ZONE_2`    | Zone 2    |  | ✔️| ✔️|
+| `ZONE_3`    | Zone 3  |  | ✔️| ✔️|
+| `ZONE_4`    | Zone 4     |  | | ✔️|
+| `ZONE_5`    | Zone 5       |  | | ✔️|
+| `ZONE_6`    | Zone 6       |  | | ✔️|
 
-**Important** in the above example, `zone1.settings.name` wont be set to its new value until after the VSSL device has changed the name and the `Zone` class has received confirmation feedback. If you need to wait for the value change, you can await a `[property_name]_CHANGE` events.
 
 # `Vssl`
 

{vsslctrl-0.1.12.dev1.dist-info → vsslctrl-0.1.13.dev1.dist-info}/RECORD

@@ -1,13 +1,13 @@
-vsslctrl/__init__.py,sha256=XaTETnpaNSebBchnHG68v7At2KwMDmBUgeXHsXejQb8,174
-vsslctrl/api_alpha.py,sha256=N8Byglyn6TYJQneF1OH1nDDRUV3gp-Nt4xBck477ku8,36810
-vsslctrl/api_base.py,sha256=a80CRtUkYK2OwXQOL8bP-YOvt4YE-ALd-VONza_gjK8,9623
-vsslctrl/api_bravo.py,sha256=pchZN16KIvdSrqkI1WU9PA9IEmxkyyP-XifxpRC0jDE,12283
-vsslctrl/core.py,sha256=ZEMpIdK10sDLssEWNWfx781LWWLOWV7FxaDfxAfaMxQ,9474
+vsslctrl/__init__.py,sha256=Gl9Q-q3nJi1hTjsCSXwJVY2r_zDmSvLBZ4yoKQjINTQ,174
+vsslctrl/api_alpha.py,sha256=UQsvFPYCbczrG74fbAWYxVeKLw7R1uT0evxprMyuev8,36984
+vsslctrl/api_base.py,sha256=g5rmjahkjyY_OB-2UjNbSwSUXVcWuL1RZZcElRmciTM,10366
+vsslctrl/api_bravo.py,sha256=xpOCCREHIe7dlLu3-PIaMqV2gqPUnX-gaE0MrZlo_YI,12457
+vsslctrl/core.py,sha256=tmWr4vxeQgrFryB-ELMDFtXs1qlwPzZ3tMVSQhHTKgY,9573
 vsslctrl/data_structure.py,sha256=3Tu8CIVM6ednmKVJE1fX6Ny-rKmlJLa2iJHsnjy7fvI,10884
 vsslctrl/decorators.py,sha256=_yQJ0MTXRX6LfvaXVgT2OwbYi9u83w4ciozIsnkxDdI,3406
 vsslctrl/device.py,sha256=JQK0k3N65uSLlYzfNMhUF5Pd7nfSgZj4WCT7o2-p_gs,7860
 vsslctrl/discovery.py,sha256=3z7z6YQUtvjFvRlQOZXIu6Wd4M896rMbi8SUkTub3AM,5568
-vsslctrl/event_bus.py,sha256=K4t2XQKb4JH0AEl_Kw7HyoczvxTTal-3Hp2zk-722y8,5036
+vsslctrl/event_bus.py,sha256=1MIUh8v_ukgqwbGzYkzqnwYPCtNyDcJwWpeB4oRk_uo,5282
 vsslctrl/exceptions.py,sha256=EEfNlu--9PMIidj3V3ZB8c7p3My8siqKw7YIOjPFaqE,419
 vsslctrl/group.py,sha256=hD46J-9oHk9EQhnBBlo4HiAA6XTSZ16bq0QMMR889NU,6227
 vsslctrl/io.py,sha256=xBOZjFyP7z_oaYRCxO56EwOJ1FesSphSWkHzGzBlgoU,8796
@@ -15,9 +15,9 @@ vsslctrl/settings.py,sha256=aD-XUykRDe_EmTtSm1h8isHPDAs9DKIcLk5sz7g8PsQ,19507
 vsslctrl/track.py,sha256=tmEADTqQfW6Nk2fvmyNAajTLzuUEn3D71JHJWPYOhxY,10126
 vsslctrl/transport.py,sha256=hNo_gjVk2mCW_Z5cq-kj5xSMjWkXnGgZYpdwFel7K98,6992
 vsslctrl/utils.py,sha256=_bvsOIu3G5czdYhrtm_c0fM60t-UXcLxztnCduQoyvs,2340
-vsslctrl/zone.py,sha256=RWgRgMyrhIjhSdTBiXEqvqkMxTwhJ8-sHMd6Ccg1ZZU,13623
-vsslctrl-0.1.12.dev1.dist-info/LICENSE,sha256=67Ekj8PIxjEvkPd7L3GYJ8dyvn1EC4sPM3q3FKtpN6w,1065
-vsslctrl-0.1.12.dev1.dist-info/METADATA,sha256=im-rpyDc4Ju09YUrOtV0ug5vrEXyaHTihfKx-yV5a2Q,17947
-vsslctrl-0.1.12.dev1.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-vsslctrl-0.1.12.dev1.dist-info/top_level.txt,sha256=MRycO_RKageNX27UZ2bLJDMlfeWTQzUZlsd3hS-0u3Y,9
-vsslctrl-0.1.12.dev1.dist-info/RECORD,,
+vsslctrl/zone.py,sha256=_uzwC7qJanUQ8GamYFSdJxAEj0qdtwZi9c_m7jnw05U,13696
+vsslctrl-0.1.13.dev1.dist-info/LICENSE,sha256=67Ekj8PIxjEvkPd7L3GYJ8dyvn1EC4sPM3q3FKtpN6w,1065
+vsslctrl-0.1.13.dev1.dist-info/METADATA,sha256=dW3xfOXA721g4uGZ29gLtVlfeSCD4YV8Y75QLP1ksL4,19617
+vsslctrl-0.1.13.dev1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+vsslctrl-0.1.13.dev1.dist-info/top_level.txt,sha256=MRycO_RKageNX27UZ2bLJDMlfeWTQzUZlsd3hS-0u3Y,9
+vsslctrl-0.1.13.dev1.dist-info/RECORD,,

{vsslctrl-0.1.12.dev1.dist-info → vsslctrl-0.1.13.dev1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.6.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any