Regex group support

README.md

@@ -146,6 +146,15 @@ def giveme(message, something):
     message.reply('Here is {}'.format(something))
 ```
 
+You can use group name as kwargs:
+```python
+from slackbot.bot import respond_to
+
+@respond_to('Hello (?P<name>.+)')
+def say_hello(message, name):
+    message.reply('Hello! {}'.format(name)
+```
+
 If you would like to have a command like 'stats' and 'stats start_date end_date', you can create reg ex like so:
 
 ```python

slackbot/dispatcher.py

@@ -48,11 +48,11 @@ def dispatch_msg(self, msg):
 
     def _dispatch_msg_handler(self, category, msg):
         responded = False
-        for func, args in self._plugins.get_plugins(category, msg['text']):
+        for func, args, kwargs in self._plugins.get_plugins(category, msg['text']):
             if func:
                 responded = True
                 try:
-                    func(Message(self._client, msg), *args)
+                    func(Message(self._client, msg), *args, **kwargs)
                 except:
                     logger.exception(
                         'failed to handle message %s with plugin "%s"',

slackbot/manager.py

@@ -67,8 +67,14 @@ def get_plugins(self, category, text):
         for matcher in self.commands[category]:
             m = matcher.search(text)
             if m:
+                kwargs = m.groupdict()
+                args = tuple(
+                    m.group(i)
+                    for i in range(1, m.lastindex + 1)
+                    if i not in matcher.groupindex.values()
+                )
                 has_matching_plugin = True
-                yield self.commands[category][matcher], to_utf8(m.groups())
+                yield self.commands[category][matcher], to_utf8(args), to_utf8(kwargs)
 
         if not has_matching_plugin:
-            yield None, None
+            yield None, None, None

tests/unit/kwarg_plugin_module.py

@@ -0,0 +1,6 @@
+from slackbot.bot import respond_to
+
+
+@respond_to('Hello, (?P<name>.+)')
+def say_hello(message, name):
+    message.reply('Hello! {}'.format(name))

tests/unit/test_manager.py

@@ -15,3 +15,17 @@ def test_import_plugin_single_module():
     assert 'fake_plugin_module' not in sys.modules
     PluginsManager()._load_plugins('fake_plugin_module')
     assert 'fake_plugin_module' in sys.modules
+
+
+def test_kwargs():
+    pm = PluginsManager()
+    pm._load_plugins('kwarg_plugin_module')
+
+    msg = {
+        'category': 'respond_to',
+        'text': 'Hello, Jeong Arm',
+    }
+
+    func, args, kwargs = next(pm.get_plugins(msg['category'], msg['text']))
+    assert not args
+    assert kwargs == {'name': 'Jeong Arm'}