qubes-installer-qubes-os/anaconda/tests/accelerators/check_accelerators.py
Marek Marczykowski-Górecki f73b3741f0 Update anaconda to 20.25.16
Apply result of "git diff anaconda-18.37.11-1..anaconda-20.25.16-1" and
resolve conflicts.
2014-04-08 05:50:31 +02:00

254 lines
10 KiB
Python

#!/usr/bin/python
#
# Copyright (C) 2013 Red Hat, Inc.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published
# by the Free Software Foundation; either version 2.1 of the License, or
# (at your option) any later version.
#
# This program 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 Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
# Author: David Shea <dshea@redhat.com>
import sys
import argparse
import re
import os.path
import copy
import collections
import locale
try:
from lxml import etree
except ImportError:
print("You need to install the python-lxml package to use check_accelerators.py")
sys.exit(1)
accel_re = re.compile(r'_(?P<accel>.)')
success = True
# Only used when --translate is requested.
class PODict(collections.Mapping):
def __init__(self, filename):
try:
import polib
except ImportError:
print("You need to install the python-polib package to check translations")
sys.exit(1)
self._dict = {}
pofile = polib.pofile(filename)
self.metadata = pofile.metadata
for entry in pofile.translated_entries():
self._dict[entry.msgid] = entry.msgstr
def __getitem__(self, key):
return self._dict[key]
def __iter__(self):
return self._dict.__iter__()
def __len__(self):
return len(self._dict)
def is_exception(node, language=None):
if language:
comment_str = "check_accelerators(%s)" % language
else:
comment_str = "check_accelerators"
return bool(node.xpath("./parent::*/comment()[contains(., '%s')]" % comment_str))
def add_check_accel(glade_filename, accels, label, po_map):
"""Check whether an accelerator conflicts with existing accelerators.
and add it to the current accelerator context.
"""
global success
language = None
if po_map:
if label.text not in po_map:
return
label.text = po_map[label.text]
language = po_map.metadata['Language']
match = accel_re.search(label.text)
if match:
accel = match.group('accel').lower()
if accel in accels:
# Check for an exception comment
if is_exception(label, language):
return
if language:
lang_str = " for language %s" % language
else:
lang_str = ""
print(("Accelerator collision for key %s in %s%s\n line %d: %s\n line %d: %s" %\
(accel, os.path.normpath(glade_filename), lang_str,
accels[accel].sourceline, accels[accel].text,
label.sourceline, label.text)).encode("utf-8"))
success = False
else:
accels[accel] = label
def combine_accels(glade_filename, list_a, list_b, po_map):
if not list_a:
return list_b
if not list_b:
return list_a
newlist = []
for accels_a in list_a:
for accels_b in list_b:
new_accels = copy.copy(accels_a)
for accel in accels_b.keys():
add_check_accel(glade_filename, new_accels, accels_b[accel], po_map)
newlist.append(new_accels)
return newlist
# GtkNotebook widgets define several child widgets, not all of which are active
# at the same time. To further complicate things, an object can have more than
# one GtkNotebook child, and a GtkNotebook can have GtkNotebook children.
#
# To handle this, GtkNotebook objects are processed separately.
# process_object returns a list of possible accelerator dictionaries, and each of
# these is compared against the list of accelerators returned for the object's
# other GtkNotebook children.
def process_object(glade_filename, interface_object, po_map):
"""Process keyboard shortcuts for a given glade object.
The return value from this function is a list of accelerator
dictionaries, with each consiting of accelerator shortcut characters
as keys and the corresponding <object> Element objects as values. Each
dictionary represents a set of accelerators that could be active at any
given time.
"""
# Start with an empty context for things that are always active
accels = [{}]
# Add everything that isn't a child of a GtkNotebook
for label in interface_object.xpath(".//property[@name='label' and ../property[@name='use_underline']/text() = 'True' and not(ancestor::object[@class='GtkNotebook'])]"):
add_check_accel(glade_filename, accels[0], label, po_map)
# For each GtkNotebook tab that is not a child of another notebook,
# add the tab to the top-level context
for notebook_label in interface_object.xpath(".//object[@class='GtkNotebook' and not(ancestor::object[@class='GtkNotebook'])]/child[@type='tab']//property[@name='label' and ../property[@name='use_underline']/text() = 'True']"):
add_check_accel(glade_filename, accels[0], notebook_label, po_map)
# Now process each non-tab object in each Gtknotebook that is not a child
# of another notebook. For each Gtk notebook, each non-tab child represents
# a separate potentially-active context. Since each list returned by
# process_object for a GtkNotebook child is independent of each other
# GtkNotebook child, we can just combine all of them into a single list.
# For example, say there's a notebook with two panes. The first pane
# contains another notebook with two panes. Let's call the main pane
# A, and the panes in the child GtkNotebook A_1 and A_2. A contains an
# accelerator for 'a', A_1 contains accelerators for 'b' and 'c', and A_2
# contains accelerators for 'b' and 'c'. The list returned would look like:
# [{'a': label1, 'b': label2, 'c': label3},
# {'a': label1, 'b': label4, 'c': label5}]
# Then when we process the other pane in the outermost Notebook (let's call
# it B), we find acclerators for 'a' and 'b':
# [{'a': label6, 'b': label7}].
# None of these dictionaries are active at the same time. Because
# process_object on A combined the accelerators that are in the top-level
# of A with each of the accelerators in the Notebook children of A, we can
# treat A as if it were actually two panes at the same-level of B and just
# create a list of three dictionaries for the whole notebook.
#
# A deepcopy of each object is taken so that the object can be treated as a
# separate XML document so that the ancestor axis stuff works.
for notebook in interface_object.xpath(".//object[@class='GtkNotebook' and not(ancestor::object[@class='GtkNotebook'])]"):
# Create the list of dictionaries for the notebook
notebook_list = []
for child in notebook.xpath("./child[not(@type='tab')]"):
notebook_list.extend(process_object(glade_filename, copy.deepcopy(child), po_map))
# Now combine this with our list of accelerators
accels = combine_accels(glade_filename, accels, notebook_list, po_map)
return accels
def check_glade(glade_filename, po_map=None):
with open(glade_filename) as glade_file:
# Parse the XML
glade_tree = etree.parse(glade_file)
# Treat each top-level object as a separate context
for interface_object in glade_tree.xpath("/interface/object"):
process_object(glade_filename, interface_object, po_map)
def main(argv=None):
if argv is None:
argv = sys.argv
parser = argparse.ArgumentParser("Check for duplicated accelerators")
parser.add_argument("-t", "--translate", action='store_true',
help="Check translated strings")
parser.add_argument("-p", "--podir", action='store', type=str,
metavar='PODIR', help='Directory containing po files', default='./po')
parser.add_argument("glade_files", nargs="+", metavar="GLADE-FILE",
help='The glade file to check')
args = parser.parse_args(args=argv)
# First check the untranslated strings in each file
for glade_file in args.glade_files:
check_glade(glade_file)
# Now loop over all of the translations
if args.translate:
import langtable
with open(os.path.join(args.podir, 'LINGUAS')) as linguas:
for line in linguas.readlines():
if re.match(r'^#', line):
continue
for lang in line.strip().split(" "):
# Reset the locale to C before parsing the po file because
# polib has erroneous uses of lower().
# See https://bitbucket.org/izi/polib/issue/54/pofile-parsing-crashes-in-turkish-locale
locale.setlocale(locale.LC_ALL, 'C')
po_map = PODict(os.path.join(args.podir, lang + ".po"))
# Set the locale so that we can use lower() on accelerator keys.
# If the language is of the form xx_XX, use that as the
# locale name. Otherwise use the first locale that
# langtable returns for the language. If that doesn't work,
# just use C and hope for the best.
if '_' in lang:
locale.setlocale(locale.LC_ALL, lang)
else:
locale_list = langtable.list_locales(languageId=lang)
if locale_list:
try:
locale.setlocale(locale.LC_ALL, locale_list[0])
except locale.Error:
print("No such locale %s, using C" % locale_list[0])
locale.setlocale(locale.LC_ALL, 'C')
else:
locale.setlocale(locale.LC_ALL, 'C')
for glade_file in args.glade_files:
check_glade(glade_file, po_map)
if __name__ == "__main__":
main(sys.argv[1:])
if success:
sys.exit(0)
else:
sys.exit(1)