1#!/usr/bin/env python
2
3import os
4import plistlib
5
6def main():
7    from optparse import OptionParser, OptionGroup
8    parser = OptionParser("""\
9Usage: %prog [options] <path>
10
11Utility for dumping Clang-style logged diagnostics.\
12""")
13    parser.add_option("-a", "--all", action="store_true", dest="all", 
14                      default=False, help="dump all messages.")
15    parser.add_option("-e", "--error", action="store_true", dest="error", 
16                      default=False, help="dump 'error' messages.")
17    parser.add_option("-f", "--fatal", action="store_true", dest="fatal", 
18                      default=False, help="dump 'fatal error' messages.")
19    parser.add_option("-i", "--ignored", action="store_true", dest="ignored", 
20                      default=False, help="dump 'ignored' messages.")
21    parser.add_option("-n", "--note", action="store_true", dest="note", 
22                      default=False, help="dump 'note' messages.")
23    parser.add_option("-w", "--warning", action="store_true", dest="warning", 
24                      default=False, help="dump 'warning' messages.")
25    (opts, args) = parser.parse_args()
26
27    if len(args) != 1:
28        parser.error("invalid number of arguments")
29
30    levels = {'error': False, 'fatal error': False, 'ignored': False,
31              'note': False, 'warning': False}
32    if opts.error:
33        levels['error'] = True
34    if opts.fatal:
35        levels['fatal error'] = True
36    if opts.ignored:
37        levels['ignored'] = True
38    if opts.note:
39        levels['note'] = True
40    if opts.warning:
41        levels['warning'] = True
42
43    path, = args
44
45    # Read the diagnostics log.
46    f = open(path)
47    try:
48        data = f.read()
49    finally:
50        f.close()
51
52    # Complete the plist (the log itself is just the chunks).
53    data = """\
54<?xml version="1.0" encoding="UTF-8"?>
55<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" \
56                       "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
57<plist version="1.0">
58<array>
59%s
60</array>
61</plist>""" % data
62
63    # Get the list of files and diagnostics to report.
64    to_report = []
65    diags = plistlib.readPlistFromString(data)
66    for file_diags in diags:
67        file = file_diags.get('main-file')
68
69        # Diagnostics from modules don't have a main-file listed.
70        if not file:
71            file = '<module-includes>'
72
73        # Ignore diagnostics for 'conftest.c', which is the file autoconf uses
74        # for its tests (which frequently will have warnings).
75        if os.path.basename(file) == 'conftest.c':
76            continue
77
78        # Get the diagnostics for the selected levels.
79        selected_diags = [d
80                          for d in file_diags.get('diagnostics', ())
81                          if levels[d.get('level')] or opts.all]
82        if selected_diags:
83            to_report.append((file, selected_diags))
84
85    # If there are no diagnostics to report, show nothing.
86    if not to_report:
87        return
88
89    # Otherwise, print out the diagnostics.
90    print
91    print "**** BUILD DIAGNOSTICS ****"
92    for file,selected_diags in to_report:
93        print "*** %s ***" % file
94        for d in selected_diags:
95            print " %s:%s:%s: %s: %s" % (
96                d.get('filename'), d.get('line'), d.get('column'),
97                d.get('level'), d.get('message'))
98
99if __name__ == "__main__":
100    main()
101