summaryrefslogtreecommitdiff
path: root/tests/helpers/messagemock.py
blob: 4bd93e66c40e51bf6dc7654cfa77ab6b4d969f04 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
# Copyright 2014-2021 Florian Bruhin (The Compiler) <mail@qutebrowser.org>
#
# 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 <https://www.gnu.org/licenses/>.

"""pytest helper to monkeypatch the message module."""

import logging

import pytest
from qutebrowser.qt.core import pyqtSlot, pyqtSignal, QObject

from qutebrowser.utils import usertypes, message


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(message.MessageInfo)
    got_question = pyqtSignal(usertypes.Question)

    def __init__(self, parent=None):
        super().__init__(parent)
        self.messages = []
        self.questions = []
        self._logger = logging.getLogger('messagemock')

    @pyqtSlot(message.MessageInfo)
    def _record_message(self, info):
        self.got_message.emit(info)
        log_levels = {
            usertypes.MessageLevel.error: logging.ERROR,
            usertypes.MessageLevel.info: logging.INFO,
            usertypes.MessageLevel.warning: logging.WARNING,
        }
        log_level = log_levels[info.level]

        self._logger.log(log_level, info.text)
        self.messages.append(info)

    @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()