core: handle 005 RPL_ISUPPORT event

docs/source/irc.rst

@@ -43,6 +43,13 @@ Backends
     :show-inheritance:
 
 
+ISUPPORT
+========
+
+.. automodule:: sopel.irc.isupport
+    :members:
+
+
 Utility
 =======
 

sopel/coretasks.py

@@ -24,9 +24,11 @@
 from random import randint
 
 from sopel import loader, module
+from sopel.irc import isupport
 from sopel.irc.utils import CapReq
 from sopel.tools import Identifier, events, iteritems, jobs, target, web
 
+
 if sys.version_info.major >= 3:
     unicode = str
 
@@ -195,6 +197,25 @@ def startup(bot, trigger):
     _execute_perform(bot)
 
 
+@module.priority('high')
+@module.event(events.RPL_ISUPPORT)
+@module.thread(False)
+@module.unblockable
+@module.rule('are supported by this server')
+def handle_isupport(bot, trigger):
+    """Handle ``RPL_ISUPPORT`` events."""
+    parameters = {}
+    for arg in trigger.args:
+        try:
+            key, value = isupport.parse_parameter(arg)
+            parameters[key] = value
+        except ValueError:
+            # ignore malformed parameter: log a warning and continue
+            LOGGER.warning('Unable to parse ISUPPORT parameter: %r', arg)
+
+    bot._isupport = bot._isupport.apply(**parameters)
+
+
 @module.require_privmsg()
 @module.require_owner()
 @module.commands('useserviceauth')

sopel/irc/__init__.py

@@ -50,6 +50,7 @@
 from sopel.trigger import PreTrigger
 
 from .backends import AsynchatBackend, SSLAsynchatBackend
+from .isupport import ISupport
 from .utils import safe, CapReq
 
 if sys.version_info.major >= 3:
@@ -67,6 +68,7 @@ def __init__(self, settings):
         self._nick = tools.Identifier(settings.core.nick)
         self._user = settings.core.user
         self._name = settings.core.name
+        self._isupport = ISupport()
 
         self.backend = None
         """IRC Connection Backend."""
@@ -108,6 +110,14 @@ def config(self):
         # TODO: Deprecate config, replaced by settings
         return self.settings
 
+    @property
+    def isupport(self):
+        """Features advertised by the server.
+
+        :type: :class:`~.isupport.ISupport` instance
+        """
+        return self._isupport
+
     # Connection
 
     def get_irc_backend(self):