# vim: ft=python fileencoding=utf-8 sts=4 sw=4 et: # Copyright 2014-2015 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 . # pylint: disable=protected-access """Tests for BaseKeyParser.""" import sys import logging from unittest import mock from PyQt5.QtCore import Qt import pytest from qutebrowser.keyinput import basekeyparser CONFIG = {'input': {'timeout': 100}} @pytest.fixture def mock_timer(monkeypatch, stubs): """Mock the Timer class used by the usertypes module with a stub.""" monkeypatch.setattr('qutebrowser.keyinput.basekeyparser.usertypes.Timer', stubs.FakeTimer) class TestSplitCount: """Test the _split_count method. Class Attributes: TESTS: list of parameters for the tests, as tuples of (input_key, supports_count, expected) """ TESTS = [ # (input_key, supports_count, expected) ('10', True, (10, '')), ('10foo', True, (10, 'foo')), ('-1foo', True, (None, '-1foo')), ('10e4foo', True, (10, 'e4foo')), ('foo', True, (None, 'foo')), ('10foo', False, (None, '10foo')), ] @pytest.mark.parametrize('input_key, supports_count, expected', TESTS) def test_splitcount(self, input_key, supports_count, expected): """Test split_count with only a count.""" kp = basekeyparser.BaseKeyParser(0, supports_count=supports_count) kp._keystring = input_key assert kp._split_count() == expected @pytest.mark.usefixtures('fake_keyconfig', 'mock_timer') class TestReadConfig: """Test reading the config.""" def test_read_config_invalid(self): """Test reading config without setting it before.""" kp = basekeyparser.BaseKeyParser(0) with pytest.raises(ValueError): kp.read_config() def test_read_config_valid(self): """Test reading config.""" kp = basekeyparser.BaseKeyParser(0, supports_count=True, supports_chains=True) kp.read_config('test') assert 'ccc' in kp.bindings assert 'ctrl+a' in kp.special_bindings kp.read_config('test2') assert 'ccc' not in kp.bindings assert 'ctrl+a' not in kp.special_bindings assert 'foo' in kp.bindings assert 'ctrl+x' in kp.special_bindings @pytest.mark.usefixtures('mock_timer') class TestSpecialKeys: """Check execute() with special keys. Attributes: kp: The BaseKeyParser to be tested. """ @pytest.fixture(autouse=True) def setup(self, caplog, fake_keyconfig): self.kp = basekeyparser.BaseKeyParser(0) self.kp.execute = mock.Mock() with caplog.atLevel(logging.WARNING, 'keyboard'): # Ignoring keychain 'ccc' in mode 'test' because keychains are not # supported there. self.kp.read_config('test') def test_valid_key(self, fake_keyevent_factory): """Test a valid special keyevent.""" if sys.platform == 'darwin': modifier = Qt.MetaModifier else: modifier = Qt.ControlModifier self.kp.handle(fake_keyevent_factory(Qt.Key_A, modifier)) self.kp.handle(fake_keyevent_factory(Qt.Key_X, modifier)) self.kp.execute.assert_called_once_with('ctrla', self.kp.Type.special) def test_invalid_key(self, fake_keyevent_factory): """Test an invalid special keyevent.""" self.kp.handle(fake_keyevent_factory(Qt.Key_A, (Qt.ControlModifier | Qt.AltModifier))) assert not self.kp.execute.called def test_keychain(self, fake_keyevent_factory): """Test a keychain.""" self.kp.handle(fake_keyevent_factory(Qt.Key_B)) self.kp.handle(fake_keyevent_factory(Qt.Key_A)) assert not self.kp.execute.called @pytest.mark.usefixtures('mock_timer') class TestKeyChain: """Test execute() with keychain support. Attributes: kp: The BaseKeyParser to be tested. """ @pytest.fixture(autouse=True) def setup(self, fake_keyconfig): """Set up mocks and read the test config.""" self.kp = basekeyparser.BaseKeyParser(0, supports_chains=True, supports_count=False) self.kp.execute = mock.Mock() self.kp.read_config('test') def test_valid_special_key(self, fake_keyevent_factory): """Test valid special key.""" if sys.platform == 'darwin': modifier = Qt.MetaModifier else: modifier = Qt.ControlModifier self.kp.handle(fake_keyevent_factory(Qt.Key_A, modifier)) self.kp.handle(fake_keyevent_factory(Qt.Key_X, modifier)) self.kp.execute.assert_called_once_with('ctrla', self.kp.Type.special) assert self.kp._keystring == '' def test_invalid_special_key(self, fake_keyevent_factory): """Test invalid special key.""" self.kp.handle(fake_keyevent_factory(Qt.Key_A, (Qt.ControlModifier | Qt.AltModifier))) assert not self.kp.execute.called assert self.kp._keystring == '' def test_keychain(self, fake_keyevent_factory): """Test valid keychain.""" # Press 'x' which is ignored because of no match self.kp.handle(fake_keyevent_factory(Qt.Key_X, text='x')) # Then start the real chain self.kp.handle(fake_keyevent_factory(Qt.Key_B, text='b')) self.kp.handle(fake_keyevent_factory(Qt.Key_A, text='a')) self.kp.execute.assert_called_once_with('ba', self.kp.Type.chain, None) assert self.kp._keystring == '' def test_0(self, fake_keyevent_factory): """Test with 0 keypress.""" self.kp.handle(fake_keyevent_factory(Qt.Key_0, text='0')) self.kp.execute.assert_called_once_with('0', self.kp.Type.chain, None) assert self.kp._keystring == '' def test_ambiguous_keychain(self, qapp, fake_keyevent_factory, config_stub, monkeypatch): """Test ambiguous keychain.""" config_stub.data = CONFIG monkeypatch.setattr('qutebrowser.keyinput.basekeyparser.config', config_stub) timer = self.kp._ambiguous_timer assert not timer.isActive() # We start with 'a' where the keychain gives us an ambiguous result. # Then we check if the timer has been set up correctly self.kp.handle(fake_keyevent_factory(Qt.Key_A, text='a')) assert not self.kp.execute.called assert timer.isSingleShot() assert timer.interval() == 100 assert timer.isActive() # Now we type an 'x' and check 'ax' has been executed and the timer # stopped. self.kp.handle(fake_keyevent_factory(Qt.Key_X, text='x')) self.kp.execute.assert_called_once_with('ax', self.kp.Type.chain, None) assert not timer.isActive() assert self.kp._keystring == '' def test_invalid_keychain(self, fake_keyevent_factory): """Test invalid keychain.""" self.kp.handle(fake_keyevent_factory(Qt.Key_B, text='b')) self.kp.handle(fake_keyevent_factory(Qt.Key_C, text='c')) assert self.kp._keystring == '' @pytest.mark.usefixtures('mock_timer') class TestCount: """Test execute() with counts.""" @pytest.fixture(autouse=True) def setup(self, fake_keyconfig): self.kp = basekeyparser.BaseKeyParser(0, supports_chains=True, supports_count=True) self.kp.execute = mock.Mock() self.kp.read_config('test') def test_no_count(self, fake_keyevent_factory): """Test with no count added.""" self.kp.handle(fake_keyevent_factory(Qt.Key_B, text='b')) self.kp.handle(fake_keyevent_factory(Qt.Key_A, text='a')) self.kp.execute.assert_called_once_with('ba', self.kp.Type.chain, None) assert self.kp._keystring == '' def test_count_0(self, fake_keyevent_factory): """Test with count=0.""" self.kp.handle(fake_keyevent_factory(Qt.Key_0, text='0')) self.kp.handle(fake_keyevent_factory(Qt.Key_B, text='b')) self.kp.handle(fake_keyevent_factory(Qt.Key_A, text='a')) calls = [mock.call('0', self.kp.Type.chain, None), mock.call('ba', self.kp.Type.chain, None)] self.kp.execute.assert_has_calls(calls) assert self.kp._keystring == '' def test_count_42(self, fake_keyevent_factory): """Test with count=42.""" self.kp.handle(fake_keyevent_factory(Qt.Key_4, text='4')) self.kp.handle(fake_keyevent_factory(Qt.Key_2, text='2')) self.kp.handle(fake_keyevent_factory(Qt.Key_B, text='b')) self.kp.handle(fake_keyevent_factory(Qt.Key_A, text='a')) self.kp.execute.assert_called_once_with('ba', self.kp.Type.chain, 42) assert self.kp._keystring == '' def test_count_42_invalid(self, fake_keyevent_factory): """Test with count=42 and invalid command.""" # Invalid call with ccx gets ignored self.kp.handle(fake_keyevent_factory(Qt.Key_4, text='4')) self.kp.handle(fake_keyevent_factory(Qt.Key_2, text='2')) self.kp.handle(fake_keyevent_factory(Qt.Key_B, text='c')) self.kp.handle(fake_keyevent_factory(Qt.Key_A, text='c')) self.kp.handle(fake_keyevent_factory(Qt.Key_A, text='x')) assert not self.kp.execute.called assert self.kp._keystring == '' # Valid call with ccc gets the correct count self.kp.handle(fake_keyevent_factory(Qt.Key_4, text='2')) self.kp.handle(fake_keyevent_factory(Qt.Key_2, text='3')) self.kp.handle(fake_keyevent_factory(Qt.Key_B, text='c')) self.kp.handle(fake_keyevent_factory(Qt.Key_A, text='c')) self.kp.handle(fake_keyevent_factory(Qt.Key_A, text='c')) self.kp.execute.assert_called_once_with('ccc', self.kp.Type.chain, 23) assert self.kp._keystring == ''