# Copyright (C) 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018 Rickard Lindberg, Roger Lindberg
#
# This file is part of Timeline.
#
# Timeline 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.
#
# Timeline 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 Timeline. If not, see <http://www.gnu.org/licenses/>.
from unittest.mock import Mock
from timelinelib.config.shortcut import FUNCTION_KEYS
from timelinelib.config.shortcut import MODIFIERS
from timelinelib.config.shortcut import SHORTCUT_KEYS
from timelinelib.wxgui.dialogs.shortcutseditor.controller import ShortcutsEditorDialogController
from timelinelib.wxgui.dialogs.shortcutseditor.view import ShortcutsEditorDialog
from timelinelib.test.cases.unit import UnitTestCase
[docs]class ShortcutConfig(object):
[docs] def __init__(self):
self.functions = ['File->New...', 'File->Save As...']
self.shc_and_keys = {'File->New...': ('Ctrl', 'N'),
'File->Save As...': ('Ctrl', 'S')}
[docs] def get_functions(self):
return self.functions
[docs] def get_modifier_and_key(self, function):
return self.shc_and_keys[function]
[docs] def get_modifiers(self):
return MODIFIERS
[docs] def get_shortcuts(self):
return SHORTCUT_KEYS
[docs] def get_function(self, shortcut):
for key in self.shc_and_keys:
if self.shc_and_keys[key][0] + "+" + self.shc_and_keys[key][1] == shortcut:
return key
return None
[docs] def edit(self, function, shortcut):
self.function = function
self.shortcut = shortcut
[docs] def exists(self, shortcut, wxid=None, function=None):
for key in self.shc_and_keys:
if self.shc_and_keys[key][0] + "+" + self.shc_and_keys[key][1] == shortcut:
return True
return False
[docs] def is_valid(self, modifier, shortcut_key):
if modifier == "":
return shortcut_key in ["", ] + FUNCTION_KEYS
else:
return modifier in MODIFIERS and shortcut_key in SHORTCUT_KEYS[1:]
[docs]class describe_shortcuts_editor_dialog_controller(UnitTestCase):
[docs] def test_shortcut_is_modifier_plus_key(self):
self.given_a_view_with(None, "Ctrl", "X")
self.assertEqual("Ctrl+X", self.controller._get_shortcut())
[docs] def test_shortcut_is_key_only(self):
self.given_a_view_with(None, "", "X")
self.assertEqual("X", self.controller._get_shortcut())
[docs] def test_shortcut_is_saved(self):
self.given_a_view_with("Func", "Ctrl", "X")
self.controller.on_apply_clicked(None)
self.assertEqual("Func", self.shortcut_config.function)
self.assertEqual("Ctrl+X", self.shortcut_config.shortcut)
[docs] def test_shortcut_cant_be_used_for_more_than_one_function(self):
self.given_a_view_with("Func", "Ctrl", "N")
self.controller.on_apply_clicked(None)
self.view.DisplayWarningMessage.assert_called_with(
"⟪The shortcut Ctrl+N is already bound to function 'File->New...'!⟫"
)
[docs] def test_modifier_must_be_given_for_simple_key(self):
self.given_a_view_with("Func", "", "N")
self.controller.on_apply_clicked(None)
self.view.DisplayWarningMessage.assert_called_with("⟪Both Modifier and Shortcut key must be given!⟫")
[docs] def test_modifier_not_needed_for_function_keys(self):
self.given_a_view_with("Func", "", "F1")
self.controller.on_apply_clicked(None)
self.assertEqual("Func", self.shortcut_config.function)
self.assertEqual("F1", self.shortcut_config.shortcut)
[docs] def test_modifier_must_be_known(self):
self.given_a_view_with("Func", "xxx", "N")
self.controller.on_apply_clicked(None)
self.view.DisplayWarningMessage.assert_called_with("⟪Both Modifier and Shortcut key must be given!⟫")
[docs] def test_selection_changes_are_handled(self):
self.given_a_view_with('File->New...', None, None)
self.controller.on_selection_changed(None)
self.view.SetModifier.assert_called_once_with("Ctrl")
self.view.SetShortcutKey.assert_called_once_with("N")
[docs] def given_a_view_with(self, func, modifier, key):
self.view.GetFunction.return_value = func
self.view.GetModifier.return_value = modifier
self.view.GetShortcutKey.return_value = key
[docs] def setUp(self):
self.view = Mock(ShortcutsEditorDialog)
self.shortcut_config = ShortcutConfig()
self.controller = ShortcutsEditorDialogController(self.view)
self.controller.shortcut_config = self.shortcut_config