# Copyright (c) 2019 lulua contributors # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. import pkg_resources from itertools import chain from typing import Text, Dict, Iterator, List from .util import YamlLoader # XXX move this to keyboard.yaml? _buttonToXorgKeycode = { 'Bl1': 49, 'Bl2': 10, 'Bl3': 11, 'Bl4': 12, 'Bl5': 13, 'Bl6': 14, 'Bl7': 15, 'Br6': 16, 'Br5': 17, 'Br4': 18, 'Br3': 19, 'Br2': 20, 'Br1': 21, 'Br_bs': 22, 'Cl_tab': 23, 'Cl1': 24, 'Cl2': 25, 'Cl3': 26, 'Cl4': 27, 'Cl5': 28, 'Cr7': 29, 'Cr6': 30, 'Cr5': 31, 'Cr4': 32, 'Cr3': 33, 'Cr2': 34, 'Cr1': 35, 'CD_ret': 36, 'Dl_caps': 66, 'Dl1': 38, 'Dl2': 39, 'Dl3': 40, 'Dl4': 41, 'Dl5': 42, 'Dr7': 43, 'Dr6': 44, 'Dr5': 45, 'Dr4': 46, 'Dr3': 47, 'Dr2': 48, 'Dr1': 51, 'El_shift': 50, 'El1': 94, 'El2': 52, 'El3': 53, 'El4': 54, 'El5': 55, 'El6': 56, 'Er5': 57, 'Er4': 58, 'Er3': 59, 'Er2': 60, 'Er1': 61, 'Er_shift': 62, 'Fl_ctrl': 37, 'Fl_win': 133, 'Fl_alt': 64, 'Fl_space': 65, 'Fr_space': 65, 'Fr_altgr': 108, 'Fr_win': 105, 'Fr_menu': 135, 'Fr_ctrl': 105, } class Button: __slots__ = ('width', 'isMarked', 'i') _idToName : Dict[int, Text] = {} _nameToId : Dict[Text, int] = {} _nextNameId = 0 def __init__ (self, name: Text, width: float = 1, isMarked: bool = False): # map names to integers for fast comparison/hashing i = Button._nameToId.get (name) if i is None: i = Button._nextNameId Button._nextNameId += 1 Button._idToName[i] = name Button._nameToId[name] = i self.i = i self.width = width # marked with an haptic line, for better orientation self.isMarked = isMarked def __repr__ (self): return f'Button({self.name!r}, {self.width}, {self.isMarked})' def __eq__ (self, other): if not isinstance (other, Button): return NotImplemented return self.i == other.i def __hash__ (self): return hash (self.i) @property def name (self): return Button._idToName[self.i] @property def xorgKeycode (self): return _buttonToXorgKeycode[self.name] @classmethod def deserialize (self, data: Dict): kindMap = {'standard': Button, 'letter': LetterButton, 'multi': MultiRowButton} try: kind = data['kind'] del data['kind'] except KeyError: kind = 'standard' return kindMap[kind] (**data) class LetterButton (Button): """ A letter, number or symbol button, but not special keys like modifier, tab, … """ def __init__ (self, name, isMarked=False): super().__init__ (name, width=1, isMarked=isMarked) def __repr__ (self): return f'LetterButton({self.name!r}, {self.isMarked})' class MultiRowButton (Button): """ A button spanning multiple rows, like the return button on european keyboards """ __slots__ = ('span', ) def __init__ (self, name, span, isMarked=False): super ().__init__ (name, width=1, isMarked=isMarked) self.span = span def __repr__ (self): return f'MultiRowButton({self.name!r}, {self.span!r}, {self.isMarked!r})' class PhysicalKeyboard: __slots__ = ('name', 'rows', '_buttonToRow') def __init__ (self, name: Text, rows): self.name = name self.rows = rows self._buttonToRow = dict () for i, (l, r) in enumerate (rows): for btn in chain (l, r): self._buttonToRow[btn] = i def __iter__ (self): return iter (self.rows) def __repr__ (self): return f'' def __len__ (self): return sum (map (lambda x: len(x[0])+len(x[1]), self)) def __getitem__ (self, name: Text) -> Button: """ Find button by name """ # XXX: speed up for k in self.keys (): if k.name == name: return k raise AttributeError (f'{name} is not a valid button name') def keys (self) -> Iterator[Button]: """ Iterate over all keys """ for row in self.rows: yield from chain.from_iterable (row) def find (self, name: Text) -> Button: return self[name] def getRow (self, btn: Button): return self._buttonToRow[btn] @classmethod def deserialize (cls, data: Dict): rows = [] for l, r in data['rows']: row : List[List[Button]] = [[], []] for btn in l: row[0].append (Button.deserialize (btn)) for btn in r: row[1].append (Button.deserialize (btn)) rows.append (row) return cls (data['name'], rows) defaultKeyboards = YamlLoader ('data/keyboards', PhysicalKeyboard.deserialize)