# vim: ft=python fileencoding=utf-8 sts=4 sw=4 et: # Copyright 2014-2021 Florian Bruhin (The Compiler) # # This file is part of qutebrowser. # # qutebrowser is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # qutebrowser is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with qutebrowser. If not, see . """pytest helper to monkeypatch the message module.""" import logging import dataclasses import pytest from PyQt5.QtCore import pyqtSlot, pyqtSignal, QObject from qutebrowser.utils import usertypes, message @dataclasses.dataclass class Message: """Information about a shown message.""" level: usertypes.MessageLevel text: str class MessageMock(QObject): """Helper object for message_mock. Attributes: messages: A list of Message objects. questions: A list of Question objects. _logger: The logger to use for messages/questions. """ got_message = pyqtSignal(usertypes.MessageLevel, str) got_question = pyqtSignal(usertypes.Question) def __init__(self, parent=None): super().__init__(parent) self.messages = [] self.questions = [] self._logger = logging.getLogger('messagemock') @pyqtSlot(usertypes.MessageLevel, str) def _record_message(self, level, text): self.got_message.emit(level, text) log_levels = { usertypes.MessageLevel.error: logging.ERROR, usertypes.MessageLevel.info: logging.INFO, usertypes.MessageLevel.warning: logging.WARNING, } log_level = log_levels[level] self._logger.log(log_level, text) self.messages.append(Message(level, text)) @pyqtSlot(usertypes.Question) def _record_question(self, question): self.got_question.emit(question) self._logger.debug(question) self.questions.append(question) def getmsg(self, level=None): """Get the only message in self.messages. Raises AssertionError if there are multiple or no messages. Args: level: The message level to check against, or None. """ assert len(self.messages) == 1 msg = self.messages[0] if level is not None: assert msg.level == level return msg def get_question(self): """Get the only question in self.questions. Raises AssertionError if there are multiple or no questions. """ assert len(self.questions) == 1 return self.questions[0] def connect(self): """Start recording messages / questions.""" message.global_bridge.show_message.connect(self._record_message) message.global_bridge.ask_question.connect(self._record_question) message.global_bridge._connected = True def disconnect(self): """Stop recording messages/questions.""" message.global_bridge.show_message.disconnect(self._record_message) message.global_bridge.ask_question.disconnect(self._record_question) @pytest.fixture def message_mock(): """Fixture to get a MessageMock.""" mmock = MessageMock() mmock.connect() yield mmock mmock.disconnect()