forked from extern/Unexpected-Keyboard
110 lines
3.7 KiB
Python
110 lines
3.7 KiB
Python
import xml.etree.ElementTree as ET
|
|
import sys, os
|
|
|
|
warning_count = 0
|
|
|
|
KNOWN_NOT_LAYOUT = set([
|
|
"number_row", "numpad", "pin",
|
|
"bottom_row", "settings", "method",
|
|
"greekmath", "numeric", "emoji_bottom_row" ])
|
|
|
|
def warn(msg):
|
|
global warning_count
|
|
print(msg)
|
|
warning_count += 1
|
|
|
|
def key_list_str(keys):
|
|
return ", ".join(sorted(list(keys)))
|
|
|
|
def missing_some_of(keys, symbols, class_name=None):
|
|
if class_name is None:
|
|
class_name = "of [" + ", ".join(symbols) + "]"
|
|
missing = set(symbols).difference(keys)
|
|
if len(missing) > 0 and len(missing) != len(symbols):
|
|
warn("Layout includes some %s but not all, missing: %s" % (
|
|
class_name, key_list_str(missing)))
|
|
|
|
def missing_required(keys, symbols, msg):
|
|
missing = set(symbols).difference(keys)
|
|
if len(missing) > 0:
|
|
warn("%s, missing: %s" % (msg, key_list_str(missing)))
|
|
|
|
def unexpected_keys(keys, symbols, msg):
|
|
unexpected = set(symbols).intersection(keys)
|
|
if len(unexpected) > 0:
|
|
warn("%s, unexpected: %s" % (msg, key_list_str(unexpected)))
|
|
|
|
# Write to [keys] and [dup].
|
|
def parse_row_from_et(row, keys, dup):
|
|
for key in row:
|
|
for attr in key.keys():
|
|
if attr.startswith("key"):
|
|
k = key.get(attr).removeprefix("\\")
|
|
if k in keys: dup.add(k)
|
|
keys.add(k)
|
|
|
|
def parse_layout(fname):
|
|
keys = set()
|
|
dup = set()
|
|
root = ET.parse(fname).getroot()
|
|
if root.tag != "keyboard":
|
|
return None
|
|
for row in root:
|
|
parse_row_from_et(row, keys, dup)
|
|
return root, keys, dup
|
|
|
|
def parse_row(fname):
|
|
keys = set()
|
|
dup = set()
|
|
root = ET.parse(fname).getroot()
|
|
if root.tag != "row":
|
|
return None
|
|
parse_row_from_et(root, keys, dup)
|
|
return root, keys, dup
|
|
|
|
def check_layout(layout):
|
|
root, keys, dup = layout
|
|
if len(dup) > 0: warn("Duplicate keys: " + key_list_str(dup))
|
|
missing_some_of(keys, "~!@#$%^&*(){}`[]=\\-_;:/.,?<>'\"+|", "ASCII punctuation")
|
|
missing_some_of(keys, "0123456789", "digits")
|
|
missing_required(keys,
|
|
["esc", "tab", "backspace", "delete",
|
|
"f11_placeholder", "f12_placeholder"],
|
|
"Layout doesn't define some important keys")
|
|
unexpected_keys(keys,
|
|
["copy", "paste", "cut", "selectAll", "shareText",
|
|
"pasteAsPlainText", "undo", "redo" ],
|
|
"Layout contains editing keys")
|
|
unexpected_keys(keys,
|
|
[ "f1", "f2", "f3", "f4", "f5", "f6", "f7", "f8", "f9",
|
|
"f10", "f11", "f12" ],
|
|
"Layout contains function keys")
|
|
unexpected_keys(keys, [""], "Layout contains empty strings")
|
|
unexpected_keys(keys, ["loc"], "Special keyword cannot be a symbol")
|
|
unexpected_keys(keys, filter(lambda k: k.strip()!=k, keys), "Some keys contain whitespaces")
|
|
|
|
_, bottom_row_keys, _ = parse_row("res/xml/bottom_row.xml")
|
|
|
|
if root.get("bottom_row") == "false":
|
|
missing_required(keys, bottom_row_keys,
|
|
"Layout redefines the bottom row but some important keys are missing")
|
|
else:
|
|
unexpected_keys(keys, bottom_row_keys,
|
|
"Layout contains keys present in the bottom row")
|
|
|
|
if root.get("script") == None:
|
|
warn("Layout doesn't specify a script.")
|
|
|
|
for fname in sorted(sys.argv[1:]):
|
|
layout_id, _ = os.path.splitext(os.path.basename(fname))
|
|
if layout_id in KNOWN_NOT_LAYOUT:
|
|
continue
|
|
layout = parse_layout(fname)
|
|
if layout == None:
|
|
print("Not a layout file: %s" % layout_id)
|
|
else:
|
|
print("# %s" % layout_id)
|
|
warning_count = 0
|
|
check_layout(layout)
|
|
print("%d warnings" % warning_count)
|