qutebrowser/tests/unit/components/test_misccommands.py

96 lines
3.3 KiB
Python

# SPDX-FileCopyrightText: Florian Bruhin (The Compiler) <mail@qutebrowser.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later
"""Tests for qutebrowser.components.misccommands."""
import signal
import contextlib
import time
import pytest
from qutebrowser.api import cmdutils
from qutebrowser.utils import utils
from qutebrowser.components import misccommands
@contextlib.contextmanager
def _trapped_segv(handler):
"""Temporarily install given signal handler for SIGSEGV."""
old_handler = signal.signal(signal.SIGSEGV, handler)
yield
if old_handler is not None:
signal.signal(signal.SIGSEGV, old_handler)
def test_debug_crash_exception():
"""Verify that debug_crash crashes as intended."""
with pytest.raises(Exception, match="Forced crash"):
misccommands.debug_crash(typ='exception')
@pytest.mark.skipif(utils.is_windows,
reason="current CPython/win can't recover from SIGSEGV")
def test_debug_crash_segfault():
"""Verify that debug_crash crashes as intended."""
caught = False
def _handler(num, frame):
"""Temporary handler for segfault."""
nonlocal caught
caught = num == signal.SIGSEGV
with _trapped_segv(_handler):
# since we handle the segfault, execution will continue and run into
# the "Segfault failed (wat.)" Exception
with pytest.raises(Exception, match="Segfault failed"):
misccommands.debug_crash(typ='segfault')
time.sleep(0.001)
assert caught
def test_debug_trace(mocker):
"""Check if hunter.trace is properly called."""
# but only if hunter is available
pytest.importorskip('hunter')
hunter_mock = mocker.patch.object(misccommands, 'hunter')
misccommands.debug_trace(1)
hunter_mock.trace.assert_called_with(1)
def test_debug_trace_exception(mocker):
"""Check that exceptions thrown by hunter.trace are handled."""
def _mock_exception():
"""Side effect for testing debug_trace's reraise."""
raise Exception('message') # pylint: disable=broad-exception-raised
hunter_mock = mocker.patch.object(misccommands, 'hunter')
hunter_mock.trace.side_effect = _mock_exception
with pytest.raises(cmdutils.CommandError, match='Exception: message'):
misccommands.debug_trace()
def test_debug_trace_no_hunter(monkeypatch):
"""Test that an error is shown if debug_trace is called without hunter."""
monkeypatch.setattr(misccommands, 'hunter', None)
with pytest.raises(cmdutils.CommandError, match="You need to install "
"'hunter' to use this command!"):
misccommands.debug_trace()
@pytest.mark.parametrize("initial_muted,mute_arg,expected_muted", [
(False, None, True), # Toggle: Unmuted → muted
(True, None, False), # Toggle: Muted → unmuted
(False, 'true', True), # Force mute
(True, 'true', True), # Force mute (idempotent)
(False, 'false', False), # Force unmute (idempotent)
(True, 'false', False), # Force unmute
])
def test_tab_mute(fake_web_tab, initial_muted, mute_arg, expected_muted):
"""Test tab_mute with different states and parameters."""
tab = fake_web_tab()
tab.audio.set_muted(initial_muted)
misccommands.tab_mute(tab, mute=mute_arg)
assert tab.audio.is_muted() == expected_muted