| OLD | NEW |
| (Empty) |
| 1 #!/usr/bin/env python | |
| 2 # | |
| 3 # Copyright 2013 The Chromium Authors. All rights reserved. | |
| 4 # Use of this source code is governed by a BSD-style license that can be | |
| 5 # found in the LICENSE file. | |
| 6 | |
| 7 """Creates a TOC file from a Java jar. | |
| 8 | |
| 9 The TOC file contains the non-package API of the jar. This includes all | |
| 10 public/protected/package classes/functions/members and the values of static | |
| 11 final variables (members with package access are kept because in some cases we | |
| 12 have multiple libraries with the same package, particularly test+non-test). Some | |
| 13 other information (major/minor javac version) is also included. | |
| 14 | |
| 15 This TOC file then can be used to determine if a dependent library should be | |
| 16 rebuilt when this jar changes. I.e. any change to the jar that would require a | |
| 17 rebuild, will have a corresponding change in the TOC file. | |
| 18 """ | |
| 19 | |
| 20 import optparse | |
| 21 import os | |
| 22 import re | |
| 23 import sys | |
| 24 import zipfile | |
| 25 | |
| 26 from util import build_utils | |
| 27 from util import md5_check | |
| 28 | |
| 29 | |
| 30 def GetClassesInZipFile(zip_file): | |
| 31 classes = [] | |
| 32 files = zip_file.namelist() | |
| 33 for f in files: | |
| 34 if f.endswith('.class'): | |
| 35 # f is of the form org/chromium/base/Class$Inner.class | |
| 36 classes.append(f.replace('/', '.')[:-6]) | |
| 37 return classes | |
| 38 | |
| 39 | |
| 40 def CallJavap(classpath, classes): | |
| 41 javap_cmd = [ | |
| 42 'javap', | |
| 43 '-package', # Show public/protected/package. | |
| 44 # -verbose is required to get constant values (which can be inlined in | |
| 45 # dependents). | |
| 46 '-verbose', | |
| 47 '-J-XX:NewSize=4m', | |
| 48 '-classpath', classpath | |
| 49 ] + classes | |
| 50 return build_utils.CheckOutput(javap_cmd) | |
| 51 | |
| 52 | |
| 53 def ExtractToc(disassembled_classes): | |
| 54 # javap output is structured by indent (2-space) levels. | |
| 55 good_patterns = [ | |
| 56 '^[^ ]', # This includes all class/function/member signatures. | |
| 57 '^ SourceFile:', | |
| 58 '^ minor version:', | |
| 59 '^ major version:', | |
| 60 '^ Constant value:', | |
| 61 ] | |
| 62 bad_patterns = [ | |
| 63 '^const #', # Matches the constant pool (i.e. literals used in the class). | |
| 64 ] | |
| 65 | |
| 66 def JavapFilter(line): | |
| 67 return (re.match('|'.join(good_patterns), line) and | |
| 68 not re.match('|'.join(bad_patterns), line)) | |
| 69 toc = filter(JavapFilter, disassembled_classes.split('\n')) | |
| 70 | |
| 71 return '\n'.join(toc) | |
| 72 | |
| 73 | |
| 74 def UpdateToc(jar_path, toc_path): | |
| 75 classes = GetClassesInZipFile(zipfile.ZipFile(jar_path)) | |
| 76 toc = [] | |
| 77 | |
| 78 limit = 1000 # Split into multiple calls to stay under command size limit | |
| 79 for i in xrange(0, len(classes), limit): | |
| 80 javap_output = CallJavap(classpath=jar_path, classes=classes[i:i+limit]) | |
| 81 toc.append(ExtractToc(javap_output)) | |
| 82 | |
| 83 with open(toc_path, 'w') as tocfile: | |
| 84 tocfile.write(''.join(toc)) | |
| 85 | |
| 86 | |
| 87 def DoJarToc(options): | |
| 88 jar_path = options.jar_path | |
| 89 toc_path = options.toc_path | |
| 90 record_path = '%s.md5.stamp' % toc_path | |
| 91 md5_check.CallAndRecordIfStale( | |
| 92 lambda: UpdateToc(jar_path, toc_path), | |
| 93 record_path=record_path, | |
| 94 input_paths=[jar_path], | |
| 95 force=not os.path.exists(toc_path), | |
| 96 ) | |
| 97 build_utils.Touch(toc_path, fail_if_missing=True) | |
| 98 | |
| 99 | |
| 100 def main(): | |
| 101 parser = optparse.OptionParser() | |
| 102 build_utils.AddDepfileOption(parser) | |
| 103 | |
| 104 parser.add_option('--jar-path', help='Input .jar path.') | |
| 105 parser.add_option('--toc-path', help='Output .jar.TOC path.') | |
| 106 parser.add_option('--stamp', help='Path to touch on success.') | |
| 107 | |
| 108 options, _ = parser.parse_args() | |
| 109 | |
| 110 if options.depfile: | |
| 111 build_utils.WriteDepfile( | |
| 112 options.depfile, | |
| 113 build_utils.GetPythonDependencies()) | |
| 114 | |
| 115 DoJarToc(options) | |
| 116 | |
| 117 if options.depfile: | |
| 118 build_utils.WriteDepfile( | |
| 119 options.depfile, | |
| 120 build_utils.GetPythonDependencies()) | |
| 121 | |
| 122 if options.stamp: | |
| 123 build_utils.Touch(options.stamp) | |
| 124 | |
| 125 | |
| 126 if __name__ == '__main__': | |
| 127 sys.exit(main()) | |
| OLD | NEW |