Add unmap method to dispatcher

Author: DrLuke

pythonosc/dispatcher.py

@@ -54,6 +54,19 @@ def map(self, address, handler, *args, needs_reply_address=False):
     # regarding multiple mappings
     self._map[address].append(Handler(handler, list(args), needs_reply_address))
 
+  def unmap(self, address, handler, *args, needs_reply_address=False):
+    """Remove an already mapped handler from an address
+
+    Args:
+      - address: An explicit endpoint.
+      - handler: A function that will be run when the address matches with
+                 the OscMessage passed as parameter.
+      - args: Any additional arguments that will be always passed to the
+              handlers after the osc messages arguments if any.
+      - needs_reply_address: True if the handler function needs the
+              originating client address passed (as the first argument)."""
+    self._map[address].remove(Handler(handler, list(args), needs_reply_address))
+
   def handlers_for_address(self, address_pattern):
     """yields Handler namedtuples matching the given OSC pattern."""
     # First convert the address_pattern into a matchable regexp.

pythonosc/test/test_dispatcher.py

@@ -121,5 +121,14 @@ def test_multiple_handlers_with_wildcard_map(self):
     self.sortAndAssertSequenceEqual(
         [Handler(1, []), Handler(2, [])], self.dispatcher.handlers_for_address("/foo/bar"))
 
+  def test_unmap(self):
+    def dummyhandler():
+        pass
+
+    self.dispatcher.map("/map/me", dummyhandler)
+    self.sortAndAssertSequenceEqual([Handler(dummyhandler, [])], self.dispatcher.handlers_for_address("/map/me"))
+    self.dispatcher.unmap("/map/me", dummyhandler)
+    self.sortAndAssertSequenceEqual([], self.dispatcher.handlers_for_address("/map/me"))
+
 if __name__ == "__main__":
   unittest.main()