diff --git a/sopel/irc/__init__.py b/sopel/irc/__init__.py index 7658c4ac7..f73a061eb 100644 --- a/sopel/irc/__init__.py +++ b/sopel/irc/__init__.py @@ -78,9 +78,12 @@ def __init__(self, settings: Config): self.backend: AbstractIRCBackend = UninitializedBackend(self) """IRC Connection Backend.""" self._connection_registered = threading.Event() - """Flag stating whether the IRC Connection is registered yet.""" + """Flag stating whether the IRC connection is registered yet.""" self.settings = settings - """Bot settings.""" + """The bot's settings. + + .. versionadded:: 7.0 + """ # internal machinery self.sending = threading.RLock() @@ -136,7 +139,10 @@ def config(self) -> Config: @property def capabilities(self) -> Capabilities: - """Capabilities negotiated with the server.""" + """Capabilities negotiated with the server. + + .. versionadded:: 8.0 + """ return self._capabilities @property @@ -201,7 +207,10 @@ def server_capabilities(self) -> dict[str, Optional[str]]: @property def isupport(self) -> ISupport: - """Features advertised by the server.""" + """Features advertised by the server. + + .. versionadded:: 7.0 + """ return self._isupport @property @@ -288,6 +297,8 @@ def safe_text_length(self, recipient: str) -> int: can be sent using ``PRIVMSG`` or ``NOTICE`` by subtracting the size required by the server to convey the bot's message. + .. versionadded:: 8.0 + .. seealso:: This method is useful when sending a message using :meth:`say`, @@ -512,6 +523,8 @@ def rebuild_nick(self) -> None: This method exists to update the casemapping rules for the :class:`~sopel.tools.identifiers.Identifier` that represents the bot's nick, e.g. after ISUPPORT info is received. + + .. versionadded:: 8.0 """ self._nick = self.make_identifier(str(self._nick)) @@ -519,6 +532,8 @@ def change_current_nick(self, new_nick: str) -> None: """Change the current nick without configuration modification. :param new_nick: new nick to be used by the bot + + .. versionadded:: 7.1 """ if self.backend is None: raise RuntimeError(ERR_BACKEND_NOT_INITIALIZED)