Clang Project

clang_source_code/www/make_cxx_dr_status
1#! /usr/bin/env python
2import sys, os, re
3
4index = 'cwg_index.html'
5output = 'cxx_dr_status.html'
6dr_test_dir = '../test/CXX/drs'
7
8if len(sys.argv) == 1:
9  pass
10elif len(sys.argv) == 2:
11  index = sys.argv[1]
12else:
13  print >>sys.stderr, 'Usage: make_drs [<path to cwg_index.html>]'
14  sys.exit(1)
15
16class DR:
17  def __init__(self, section, issue, url, status, title):
18    self.section, self.issue, self.url, self.status, self.title = \
19        section, issue, url, status, title
20  def __repr__(self):
21    return '%s (%s): %s' % (self.issue, self.status, self.title)
22
23def parse(dr):
24  section, issue_link, status, title = [
25      col.split('>', 1)[1].split('</TD>')[0]
26      for col in dr.split('</TR>', 1)[0].split('<TD')[1:]
27  ]
28  _, url, issue = issue_link.split('"', 2)
29  url = url.strip()
30  issue = int(issue.split('>', 1)[1].split('<', 1)[0])
31  title = title.replace('<issue_title>', '').replace('</issue_title>', '').strip()
32  return DR(section, issue, url, status, title)
33
34status_re = re.compile(r'\bdr([0-9]+): (.*)')
35status_map = {}
36for test_cpp in os.listdir(dr_test_dir):
37  if not test_cpp.endswith('.cpp'):
38    continue
39  test_cpp = os.path.join(dr_test_dir, test_cpp)
40  found_any = False;
41  for match in re.finditer(status_re, file(test_cpp, 'r').read()):
42    status_map[int(match.group(1))] = match.group(2)
43    found_any = True
44  if not found_any:
45    print >> sys.stderr, "warning:%s: no '// dr123: foo' comments in this file" % test_cpp
46
47drs = sorted((parse(dr) for dr in file(index, 'r').read().split('<TR>')[2:]),
48             key = lambda dr: dr.issue)
49out_file = file(output, 'w')
50
51print >> out_file, '''\
52<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
53          "http://www.w3.org/TR/html4/strict.dtd">
54<!-- This file is auto-generated by make_cxx_dr_status. Do not modify. -->
55<html>
56<head>
57  <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
58  <title>Clang - C++ Defect Report Status</title>
59  <link type="text/css" rel="stylesheet" href="menu.css">
60  <link type="text/css" rel="stylesheet" href="content.css">
61  <style type="text/css">
62    .none { background-color: #FFCCCC }
63    .partial { background-color: #FFE0B0 }
64    .svn  { background-color: #FFFF99 }
65    .full { background-color: #CCFF99 }
66    .na { background-color: #DDDDDD }
67    .open * { color: #AAAAAA }
68    //.open { filter: opacity(0.2) }
69    tr:target { background-color: #FFFFBB }
70    th { background-color: #FFDDAA }
71  </style>
72</head>
73<body>
74
75<!--#include virtual="menu.html.incl"-->
76
77<div id="content">
78
79<!--*************************************************************************-->
80<h1>C++ Defect Report Support in Clang</h1>
81<!--*************************************************************************-->
82<p>Last updated: $Date$</p>
83
84<h2 id="cxxdr">C++ defect report implementation status</h2>
85
86<p>This page tracks which C++ defect reports are implemented within Clang.</p>
87
88<table width="689" border="1" cellspacing="0">
89  <tr>
90    <th>Number</th>
91    <th>Status</th>
92    <th>Issue title</th>
93    <th>Available in Clang?</th>
94  </tr>'''
95
96def availability(issue):
97  status = status_map.get(issue, 'unknown')
98  avail_suffix = ''
99  if status.endswith(' c++11'):
100    status = status[:-6]
101    avail_suffix = ' (C++11 onwards)'
102  elif status.endswith(' c++14'):
103    status = status[:-6]
104    avail_suffix = ' (C++14 onwards)'
105  elif status.endswith(' c++17'):
106    status = status[:-6]
107    avail_suffix = ' (C++17 onwards)'
108  if status == 'unknown':
109    avail = 'Unknown'
110    avail_style = ' class="none"'
111  elif status == '8':
112    avail = 'SVN'
113    avail_style = ' class="svn"'
114  elif re.match('^[0-9]+\.?[0-9]*', status):
115    avail = 'Clang %s' % status
116    avail_style = ' class="full"'
117  elif status == 'yes':
118    avail = 'Yes'
119    avail_style = ' class="full"'
120  elif status == 'partial':
121    avail = 'Partial'
122    avail_style = ' class="partial"'
123  elif status == 'no':
124    avail = 'No'
125    avail_style = ' class="none"'
126  elif status == 'na':
127    avail = 'N/A'
128    avail_style = ' class="na"'
129  elif status == 'na lib':
130    avail = 'N/A (Library DR)'
131    avail_style = ' class="na"'
132  elif status == 'na abi':
133    avail = 'N/A (ABI constraint)'
134    avail_style = ' class="na"'
135  elif status.startswith('sup '):
136    dup = status.split(' ', 1)[1]
137    avail = 'Superseded by <a href="#%s">%s</a>' % (dup, dup)
138    try:
139      _, avail_style = availability(int(dup))
140    except:
141      print >>sys.stderr, "issue %s marked as sup %s" % (issue, dup)
142      avail_style = ' class="none"'
143  elif status.startswith('dup '):
144    dup = int(status.split(' ', 1)[1])
145    avail = 'Duplicate of <a href="#%s">%s</a>' % (dup, dup)
146    _, avail_style = availability(dup)
147  else:
148    assert False, 'unknown status %s for issue %s' % (status, dr.issue)
149  return (avail + avail_suffix, avail_style)
150
151count = {}
152for dr in drs:
153  if dr.status in ('concepts',):
154    # Yeah, cool story bro.
155    continue
156  if dr.status in ('open', 'concurrency', 'drafting', 'review', 'extension'):
157    # We may have to deal with these some day, but not yet.
158    row_style = ' class="open"'
159    avail = 'Not resolved'
160    avail_style = ''
161    assert dr.issue not in status_map, "have status for not-ready dr %s" % dr.issue
162  else:
163    row_style = ''
164    avail, avail_style = availability(dr.issue)
165    if not avail.startswith('Sup') and not avail.startswith('Dup'):
166      count[avail] = count.get(avail, 0) + 1
167
168  print >> out_file, '''\
169  <tr%s id="%s">
170    <td><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/%s">%s</a></td>
171    <td>%s</td>
172    <td>%s</td>
173    <td%s align="center">%s</td>
174  </tr>''' % (row_style, dr.issue, dr.url, dr.issue, dr.status, dr.title, avail_style, avail)
175
176for status, num in sorted(count.items()):
177  print "%s: %s" % (status, num)
178
179print >> out_file, '''\
180</table>
181
182</div>
183</body>
184</html>'''
185
CodeThinker, Enjoy your reading code