| #!/usr/bin/env python | |
| # | |
| # Copyright (C) 2009 The Android Open Source Project | |
| # | |
| # Licensed under the Apache License, Version 2.0 (the "License"); | |
| # you may not use this file except in compliance with the License. | |
| # You may obtain a copy of the License at | |
| # | |
| # http://www.apache.org/licenses/LICENSE-2.0 | |
| # | |
| # Unless required by applicable law or agreed to in writing, software | |
| # distributed under the License is distributed on an "AS IS" BASIS, | |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
| # See the License for the specific language governing permissions and | |
| # limitations under the License. | |
| """ | |
| Usage: java-event-log-tags.py [-o output_file] <input_file> <merged_tags_file> | |
| Generate a java class containing constants for each of the event log | |
| tags in the given input file. | |
| -h to display this usage message and exit. | |
| """ | |
| import cStringIO | |
| import getopt | |
| import os | |
| import re | |
| import sys | |
| import event_log_tags | |
| output_file = None | |
| try: | |
| opts, args = getopt.getopt(sys.argv[1:], "ho:") | |
| except getopt.GetoptError, err: | |
| print str(err) | |
| print __doc__ | |
| sys.exit(2) | |
| for o, a in opts: | |
| if o == "-h": | |
| print __doc__ | |
| sys.exit(2) | |
| elif o == "-o": | |
| output_file = a | |
| else: | |
| print >> sys.stderr, "unhandled option %s" % (o,) | |
| sys.exit(1) | |
| if len(args) != 2: | |
| print "need exactly two input files, not %d" % (len(args),) | |
| print __doc__ | |
| sys.exit(1) | |
| fn = args[0] | |
| tagfile = event_log_tags.TagFile(fn) | |
| # Load the merged tag file (which should have numbers assigned for all | |
| # tags. Use the numbers from the merged file to fill in any missing | |
| # numbers from the input file. | |
| merged_fn = args[1] | |
| merged_tagfile = event_log_tags.TagFile(merged_fn) | |
| merged_by_name = dict([(t.tagname, t) for t in merged_tagfile.tags]) | |
| for t in tagfile.tags: | |
| if t.tagnum is None: | |
| if t.tagname in merged_by_name: | |
| t.tagnum = merged_by_name[t.tagname].tagnum | |
| else: | |
| # We're building something that's not being included in the | |
| # product, so its tags don't appear in the merged file. Assign | |
| # them all an arbitrary number so we can emit the java and | |
| # compile the (unused) package. | |
| t.tagnum = 999999 | |
| if "java_package" not in tagfile.options: | |
| tagfile.AddError("java_package option not specified", linenum=0) | |
| hide = True | |
| if "javadoc_hide" in tagfile.options: | |
| hide = event_log_tags.BooleanFromString(tagfile.options["javadoc_hide"][0]) | |
| if tagfile.errors: | |
| for fn, ln, msg in tagfile.errors: | |
| print >> sys.stderr, "%s:%d: error: %s" % (fn, ln, msg) | |
| sys.exit(1) | |
| buffer = cStringIO.StringIO() | |
| buffer.write("/* This file is auto-generated. DO NOT MODIFY.\n" | |
| " * Source file: %s\n" | |
| " */\n\n" % (fn,)) | |
| buffer.write("package %s;\n\n" % (tagfile.options["java_package"][0],)) | |
| basename, _ = os.path.splitext(os.path.basename(fn)) | |
| if hide: | |
| buffer.write("/**\n" | |
| " * @hide\n" | |
| " */\n") | |
| buffer.write("public class %s {\n" % (basename,)) | |
| buffer.write(" private %s() { } // don't instantiate\n" % (basename,)) | |
| for t in tagfile.tags: | |
| if t.description: | |
| buffer.write("\n /** %d %s %s */\n" % (t.tagnum, t.tagname, t.description)) | |
| else: | |
| buffer.write("\n /** %d %s */\n" % (t.tagnum, t.tagname)) | |
| buffer.write(" public static final int %s = %d;\n" % | |
| (t.tagname.upper(), t.tagnum)) | |
| keywords = frozenset(["abstract", "continue", "for", "new", "switch", "assert", | |
| "default", "goto", "package", "synchronized", "boolean", | |
| "do", "if", "private", "this", "break", "double", | |
| "implements", "protected", "throw", "byte", "else", | |
| "import", "public", "throws", "case", "enum", | |
| "instanceof", "return", "transient", "catch", "extends", | |
| "int", "short", "try", "char", "final", "interface", | |
| "static", "void", "class", "finally", "long", "strictfp", | |
| "volatile", "const", "float", "native", "super", "while"]) | |
| def javaName(name): | |
| out = name[0].lower() + re.sub(r"[^A-Za-z0-9]", "", name.title())[1:] | |
| if out in keywords: | |
| out += "_" | |
| return out | |
| javaTypes = ["ERROR", "int", "long", "String", "Object[]"] | |
| for t in tagfile.tags: | |
| methodName = javaName("write_" + t.tagname) | |
| if t.description: | |
| args = [arg.strip("() ").split("|") for arg in t.description.split(",")] | |
| else: | |
| args = [] | |
| argTypesNames = ", ".join([javaTypes[int(arg[1])] + " " + javaName(arg[0]) for arg in args]) | |
| argNames = "".join([", " + javaName(arg[0]) for arg in args]) | |
| buffer.write("\n public static void %s(%s) {" % (methodName, argTypesNames)) | |
| buffer.write("\n android.util.EventLog.writeEvent(%s%s);" % (t.tagname.upper(), argNames)) | |
| buffer.write("\n }\n") | |
| buffer.write("}\n"); | |
| event_log_tags.WriteOutput(output_file, buffer) |