add property setters in event class

use event property setters in examples

update README

patch bump

README.md

@@ -302,20 +302,30 @@ The following methods are available:
 example:
 
 ```python
-# register the app self as an event observer
+# register an app to receive updates
-self.vban.subject.add(self)
+class App():
+    def __init__(self, vban):
+        vban.subject.add(self)
+        ...
 ```
 
 #### `vban.event`
 
-You may also add/remove event subscriptions as necessary with the Event class.
+Use the event class to toggle updates as necessary.
+
+The following properties are available:
+
+-   `pdirty`: boolean
+-   `mdirty`: boolean
+-   `midi`: boolean
+-   `ldirty`: boolean
 
 example:
 
 ```python
-vban.event.add("ldirty")
+vban.event.ldirty = True
 
-vban.event.remove("pdirty")
+vban.event.pdirty = False
 
 # get a list of currently subscribed
 print(vban.event.get())

examples/observer/__main__.py

@@ -8,8 +8,8 @@ class Observer:
         self.vban = vban
         # register your app as event observer
         self.vban.subject.add(self)
-        # add level updates, since they are disabled by default.
+        # enable level updates, since they are disabled by default.
-        self.vban.event.add("ldirty")
+        self.vban.event.ldirty = True
 
     # define an 'on_update' callback function to receive event updates
     def on_update(self, subject):

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "vban-cmd"
-version = "1.5.4"
+version = "1.5.5"
 description = "Python interface for the VBAN RT Packet Service (Sendtext)"
 authors = ["onyx-and-iris <code@onyxandiris.online>"]
 license = "MIT"

vban_cmd/event.py

@@ -18,13 +18,23 @@ class Event:
         self.logger.info(", ".join(info))
 
     @property
-    def pdirty(self):
+    def pdirty(self) -> bool:
         return self.subs["pdirty"]
 
+    @pdirty.setter
+    def pdirty(self, val: bool):
+        self.subs["pdirty"] = val
+        self.info(f"pdirty {'added to' if val else {'removed from'}}")
+
     @property
-    def ldirty(self):
+    def ldirty(self) -> bool:
         return self.subs["ldirty"]
 
+    @ldirty.setter
+    def ldirty(self, val: bool):
+        self.subs["ldirty"] = val
+        self.info(f"ldirty {'added to' if val else {'removed from'}}")
+
     def get(self) -> list:
         return [k for k, v in self.subs.items() if v]
 
@@ -32,9 +42,7 @@ class Event:
         return any(self.subs.values())
 
     def add(self, event):
-        self.subs[event] = True
+        setattr(self, event, True)
-        self.info(f"{event} added to")
 
     def remove(self, event):
-        self.subs[event] = False
+        setattr(self, event, False)
-        self.info(f"{event} removed from")