Source code for wmflib.irc

"""IRC module."""

import logging
import socket

from typing import Tuple


[docs] class SocketHandler(logging.Handler): """Log handler to communicate with logmsgbot. Sends log events to a tcpircbot server for relay to an IRC channel. The combination of hostname:port identifies a specific IRC channel, and for the moment only the #wikimedia-operations one is configured. Please also keep in mind that SRE allows only specific hostnames to send traffic to tcpircbot, so follow up with them in case you have doubts or special requests. For more info, please check the tcpircbot config in puppet. Examples: :: >>> import logging >>> from wmflib.interactive import get_username >>> from wmflib.irc import SocketHandler >>> irc_logger = logging.getLogger('irc_logger') >>> irc_logger.setLevel(logging.INFO) >>> irc_logger.addHandler(SocketHandler('irchost.domain', 1234, get_username())) >>> irc_logger.info('Message') The tcpircbot that received the message will then send it to the configured IRC channel:: logmsgbot: user@host1001.domain Message """ command = '' def __init__(self, host: str, port: int, username: str) -> None: """Initialize the IRC socket handler. Arguments: host (str): tcpircbot hostname. port (int): tcpircbot listening port. username (str): the user to refer in the IRC messages. """ super().__init__() self.addr: Tuple[str, int] = (host, port) self.username = username self.level = logging.INFO self.hostname = socket.gethostname() def _send_message(self, message: str, record: logging.LogRecord) -> None: """Send a custom message string on a socket.""" sock = None try: sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM) sock.settimeout(1.0) sock.connect(self.addr) sock.sendall(message.encode('utf-8')) except OSError: self.handleError(record) finally: if sock is not None: sock.close() def emit(self, record: logging.LogRecord) -> None: """According to Python logging.Handler interface. See https://docs.python.org/3/library/logging.html#handler-objects """ self._send_message(f'{self.command} {self.username}@{self.hostname} {self.format(record)}'.strip(), record)
[docs] class SALSocketHandler(SocketHandler): """Log handler to !log on a SAL. See the parent class for usage examples. """ # Stashbot expects !log messages relayed by logmsgbot to have the # format: "!log <nick> <msg>". The <nick> is parsed out and used as # the label of who actually made the SAL entry. command = '!log'