| #!/usr/bin/env python |
| # Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| # Use of this source code is governed by a BSD-style license that can be |
| # found in the LICENSE file. |
| |
| """Without any args, this simply loads the IDs out of a bunch of the Chrome GRD |
| files, and then checks the subset of the code that loads the strings to try |
| and figure out what isn't in use any more. |
| You can give paths to GRD files and source directories to control what is |
| check instead. |
| """ |
| |
| import os |
| import re |
| import sys |
| import xml.sax |
| |
| # Extra messages along the way |
| # 1 - Print ids that are found in sources but not in the found id set |
| # 2 - Files that aren't processes (don't match the source name regex) |
| DEBUG = 0 |
| |
| |
| class GrdIDExtractor(xml.sax.handler.ContentHandler): |
| """Extracts the IDs from messages in GRIT files""" |
| def __init__(self): |
| self.id_set_ = set() |
| |
| def startElement(self, name, attrs): |
| if name == 'message': |
| self.id_set_.add(attrs['name']) |
| |
| def allIDs(self): |
| """Return all the IDs found""" |
| return self.id_set_.copy() |
| |
| |
| def CheckForUnusedGrdIDsInSources(grd_files, src_dirs): |
| """Will collect the message ids out of the given GRD files and then scan |
| the source directories to try and figure out what ids are not currently |
| being used by any source. |
| |
| grd_files: |
| A list of GRD files to collect the ids from. |
| src_dirs: |
| A list of directories to walk looking for source files. |
| """ |
| # Collect all the ids into a large map |
| all_ids = set() |
| file_id_map = {} |
| for y in grd_files: |
| handler = GrdIDExtractor() |
| xml.sax.parse(y, handler) |
| files_ids = handler.allIDs() |
| file_id_map[y] = files_ids |
| all_ids |= files_ids |
| |
| |
| # The regex that will be used to check sources |
| id_regex = re.compile('IDS_[A-Z0-9_]+') |
| |
| # Make sure the regex matches every id found. |
| got_err = False |
| for x in all_ids: |
| match = id_regex.search(x) |
| if match is None: |
| print 'ERROR: "%s" did not match our regex' % (x) |
| got_err = True |
| if not match.group(0) is x: |
| print 'ERROR: "%s" did not fully match our regex' % (x) |
| got_err = True |
| if got_err: |
| return 1 |
| |
| # The regex for deciding what is a source file |
| src_regex = re.compile('\.(([chm])|(mm)|(cc)|(cp)|(cpp)|(xib)|(py))$') |
| |
| ids_left = all_ids.copy() |
| |
| # Scanning time. |
| for src_dir in src_dirs: |
| for root, dirs, files in os.walk(src_dir): |
| # Remove svn directories from recursion |
| if '.svn' in dirs: |
| dirs.remove('.svn') |
| for file in files: |
| if src_regex.search(file.lower()): |
| full_path = os.path.join(root, file) |
| src_file_contents = open(full_path).read() |
| for match in sorted(set(id_regex.findall(src_file_contents))): |
| if match in ids_left: |
| ids_left.remove(match) |
| if DEBUG: |
| if not match in all_ids: |
| print '%s had "%s", which was not in the found IDs' % \ |
| (full_path, match) |
| elif DEBUG > 1: |
| full_path = os.path.join(root, file) |
| print 'Skipping %s.' % (full_path) |
| |
| # Anything left? |
| if len(ids_left) > 0: |
| print 'The following ids are in GRD files, but *appear* to be unused:' |
| for file_path, file_ids in file_id_map.iteritems(): |
| missing = ids_left.intersection(file_ids) |
| if len(missing) > 0: |
| print ' %s:' % (file_path) |
| print '\n'.join(' %s' % (x) for x in sorted(missing)) |
| |
| return 0 |
| |
| |
| def main(): |
| # script lives in src/tools |
| tools_dir = os.path.dirname(os.path.abspath(sys.argv[0])) |
| src_dir = os.path.dirname(tools_dir) |
| |
| # Collect the args into the right buckets |
| src_dirs = [] |
| grd_files = [] |
| for arg in sys.argv[1:]: |
| if arg.lower().endswith('.grd'): |
| grd_files.append(arg) |
| else: |
| src_dirs.append(arg) |
| |
| # If no GRD files were given, default them: |
| if len(grd_files) == 0: |
| ash_base_dir = os.path.join(src_dir, 'ash') |
| chrome_dir = os.path.join(src_dir, 'chrome') |
| chrome_app_dir = os.path.join(chrome_dir, 'app') |
| chrome_app_res_dir = os.path.join(chrome_app_dir, 'resources') |
| device_base_dir = os.path.join(src_dir, 'device') |
| ui_dir = os.path.join(src_dir, 'ui') |
| ui_strings_dir = os.path.join(ui_dir, 'strings') |
| ui_chromeos_dir = os.path.join(ui_dir, 'chromeos') |
| grd_files = [ |
| os.path.join(ash_base_dir, 'ash_strings.grd'), |
| os.path.join(ash_base_dir, 'resources', 'ash_resources.grd'), |
| os.path.join(chrome_app_dir, 'chromium_strings.grd'), |
| os.path.join(chrome_app_dir, 'generated_resources.grd'), |
| os.path.join(chrome_app_dir, 'google_chrome_strings.grd'), |
| os.path.join(chrome_app_res_dir, 'locale_settings.grd'), |
| os.path.join(chrome_app_res_dir, 'locale_settings_chromiumos.grd'), |
| os.path.join(chrome_app_res_dir, 'locale_settings_google_chromeos.grd'), |
| os.path.join(chrome_app_res_dir, 'locale_settings_linux.grd'), |
| os.path.join(chrome_app_res_dir, 'locale_settings_mac.grd'), |
| os.path.join(chrome_app_res_dir, 'locale_settings_win.grd'), |
| os.path.join(chrome_app_dir, 'theme', 'theme_resources.grd'), |
| os.path.join(chrome_dir, 'browser', 'browser_resources.grd'), |
| os.path.join(chrome_dir, 'common', 'common_resources.grd'), |
| os.path.join(chrome_dir, 'renderer', 'resources', |
| 'renderer_resources.grd'), |
| os.path.join(device_base_dir, 'bluetooth', 'bluetooth_strings.grd'), |
| os.path.join(src_dir, 'extensions', 'extensions_strings.grd'), |
| os.path.join(src_dir, 'ui', 'resources', 'ui_resources.grd'), |
| os.path.join(src_dir, 'ui', 'webui', 'resources', 'webui_resources.grd'), |
| os.path.join(ui_strings_dir, 'app_locale_settings.grd'), |
| os.path.join(ui_strings_dir, 'ui_strings.grd'), |
| os.path.join(ui_chromeos_dir, 'ui_chromeos_strings.grd'), |
| ] |
| |
| # If no source directories were given, default them: |
| if len(src_dirs) == 0: |
| src_dirs = [ |
| os.path.join(src_dir, 'app'), |
| os.path.join(src_dir, 'ash'), |
| os.path.join(src_dir, 'chrome'), |
| os.path.join(src_dir, 'components'), |
| os.path.join(src_dir, 'content'), |
| os.path.join(src_dir, 'device'), |
| os.path.join(src_dir, 'extensions'), |
| os.path.join(src_dir, 'ui'), |
| # nsNSSCertHelper.cpp has a bunch of ids |
| os.path.join(src_dir, 'third_party', 'mozilla_security_manager'), |
| os.path.join(chrome_dir, 'installer'), |
| ] |
| |
| return CheckForUnusedGrdIDsInSources(grd_files, src_dirs) |
| |
| |
| if __name__ == '__main__': |
| sys.exit(main()) |