gen-components revision 1267
61N/A#!/usr/bin/python
61N/A#
61N/A# CDDL HEADER START
61N/A#
61N/A# The contents of this file are subject to the terms of the
61N/A# Common Development and Distribution License (the "License").
61N/A# You may not use this file except in compliance with the License.
61N/A#
61N/A# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
61N/A# or http://www.opensolaris.org/os/licensing.
61N/A# See the License for the specific language governing permissions
61N/A# and limitations under the License.
61N/A#
61N/A# When distributing Covered Code, include this CDDL HEADER in each
61N/A# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
61N/A# If applicable, add the following below this CDDL HEADER, with the
61N/A# fields enclosed by brackets "[]" replaced with your own identifying
61N/A# information: Portions Copyright [yyyy] [name of copyright owner]
61N/A#
61N/A# CDDL HEADER END
75N/A#
75N/A# Copyright (c) 2012, Oracle and/or it's affiliates. All rights reserved.
61N/A#
61N/A#
75N/A# gen_components
61N/A# A simple script to generate (on stdout), the component.html web page
61N/A# found at: http://userland.us.oracle.com/components.html
61N/A#
61N/A
61N/Aimport getopt
61N/Aimport os
61N/Aimport sys
75N/A
61N/Adebug = False
61N/A
61N/A# Hashtable of components with TPNOs keyed by component name.
61N/Acomp_TPNOs = {}
61N/A
61N/A# Hashtable of RE's / RM's keyed by component path.
61N/Aowners = {}
61N/A
61N/A# Initial HTML for the generated web page.
61N/Apreamble = """
61N/A<html>
61N/A<head>
61N/A <style type='text/css' media='screen'>
61N/A @import '/css/demo_table.css';
61N/A @import '/css/ColVis.css';
61N/A @import '/css/ColReorder.css';
61N/A
61N/A tr.even:hover, tr.even:hover td.sorting_1 ,
61N/A tr.odd:hover, tr.odd:hover td.sorting_1 {
61N/A background-color: gold;
61N/A }
61N/A
61N/A </style>
61N/A <script type='text/javascript' src='js/jquery.js'></script>
61N/A <script type='text/javascript' src='js/jquery.dataTables.js'></script>
61N/A <script type='text/javascript' src='js/ColReorder.js'></script>
61N/A <script type='text/javascript' src='js/ColVis.js'></script>
61N/A
61N/A <script>
61N/A $(document).ready(function() {
61N/A $('#components').dataTable({
61N/A "sDom": 'C<"clear">Rlfrtip',
61N/A bPaginate: true,
61N/A bFilter: true,
61N/A bSort: true,
61N/A iDisplayLength: -1,
61N/A aLengthMenu: [ [ 10, 50, -1], [ 10, 50, 'All'] ]
61N/A });
61N/A });
61N/A </script>
61N/A</head>
61N/A<body>
61N/A
61N/A<h1>Userland Components</h1>
61N/A<p>
61N/A<table align='center' id='components'>
61N/A<thead>
61N/A<tr>
61N/A <th>Component</th>
61N/A <th>Version</th>
61N/A <th>Gate Path</th>
61N/A <th>Package(s)</th>
61N/A <th>ARC Case(s)</th>
61N/A <th>License(s)</th>
61N/A <th>TPNO</th>
61N/A <th>BugDB</th>
61N/A <th>RE</th>
83N/A <th>RM</th>
83N/A</tr>
83N/A</thead>
83N/A<tbody>
61N/A"""
61N/A
61N/A# Final HTML for the generated web page.
61N/Apostamble = """
</tr>
</tbody>
</table>
</body>
</html>
"""
# Return a hashtable of RE's / RM's keyed by component path.
def read_owners(owners_file):
if debug:
print >> sys.stderr, "Reading %s" % owners_file
try:
fin = open(owners_file, 'r')
lines = fin.readlines()
fin.close()
except:
if debug:
print >> sys.stderr, "Unable to read owners file: %s" % owners_file
owners = {}
for line in lines:
line = line[:-1]
component, re, rm = line.split("|")
owners[component] = [ re, rm ]
return owners
# Return a hashtable of components with TPNOs keyed by component name.
def find_TPNOs(workspace):
comp_TPNOs = {}
for directory, _, files in os.walk(workspace + "/components"):
for filename in files:
if filename.endswith(".license") or filename.endswith(".copyright"):
pathname = os.path.join(directory, filename)
fin = open(pathname, 'r')
lines = fin.readlines()
fin.close()
for line in lines:
line = line.replace("\n", "")
if line.startswith("Oracle Internal Tracking Number"):
tpno_str = line.split()[-1]
try:
# Check that the TPNO is a valid number.
tpno = int(tpno_str)
if debug:
print >> sys.stderr, "TPNO: %s: %s" % \
(directory, tpno_str)
comp_TPNOs[directory] = tpno_str
except:
print >> sys.stderr, "Unable to read TPNO: %s" % \
pathname
return(comp_TPNOs)
# Return a sorted list of the directories containing one or more .p5m files.
def find_p5m_dirs(workspace):
p5m_dirs = []
for dir, _, files in os.walk(workspace + "/components"):
for file in files:
if file.endswith(".p5m"):
p5m_dirs.append(dir)
return sorted(list(set(p5m_dirs)))
# Write out the initial HTML for the components.html web page.
def write_preamble():
print preamble
# Return the RE / RM for this component.
def get_re_and_rm(p5m_dir):
re_and_rm = [ "Unknown", "Unknown" ]
component_path = ""
started = False
tokens = p5m_dir.split("/")
for token in tokens:
if started:
component_path += token + "/"
if token == "components":
started = True
component_path = component_path[:-1]
if component_path in owners:
re_and_rm = owners[component_path]
if debug:
print >> sys.stderr, "Component path: ", component_path,
print >> sys.stderr, "RE / RM: ", re_and_rm
return re_and_rm
# Generate an HTML table entry for all the information for the component
# in the given directory. This generates a file called 'component-report'
# under the components build directory.
def gen_reports(workspace, component_dir):
if debug:
print >> sys.stderr, "Processing %s" % component_dir
try:
tpno = comp_TPNOs[component_dir]
except:
tpno = ""
re, rm = get_re_and_rm(component_dir)
makefiles = "-f Makefile -f %s/make-rules/component-report" % workspace
targets = "clean component-hook"
cmd = "cd %s; TPNO='%s' RESPONSIBLE_ENGINEER='%s' RESPONSIBLE_MANAGER='%s' gmake COMPONENT_HOOK='gmake %s component-report' %s" % \
(component_dir, tpno, re, rm, makefiles, targets)
if debug:
print >> sys.stderr, "gen_reports: command: `%s`" % cmd
lines = os.popen(cmd).readlines()
# Collect all the .../build/component-report files and write them to stdout.
def write_reports(p5m_dirs, owners_file):
for p5m_dir in p5m_dirs:
report = "%s/build/component-report" % p5m_dir
if debug:
print >> sys.stderr, "Reading %s" % report
try:
fin = open(report, 'r')
lines = fin.readlines()
fin.close()
sys.stdout.writelines(lines)
except:
if debug:
print >> sys.stderr, "Unable to read: %s" % report
# Write out the final HTML for the components.html web page.
def write_postamble():
print postamble
# Write out a usage message showing valid options to this script.
def usage():
print >> sys.stderr, \
"""
Usage:
update_man_pages.py [OPTION...]
-d, --debug
Turn on debugging
-o, --owners
Location of a file containing a list of RE's /RM's per component
-w --workspace
Location of the Userland workspace
"""
sys.exit(1)
if __name__ == "__main__":
workspace = os.getenv('WS_TOP')
owners_file = "/net/userland.us.oracle.com/gates/private/RM-RE-list.txt"
try:
opts, args = getopt.getopt(sys.argv[1:], "do:w:",
[ "debug", "owners=", "workspace=" ])
except getopt.GetoptError, err:
print str(err)
usage()
for opt, arg in opts:
if opt in [ "-d", "--debug" ]:
debug = True
elif opt in [ "-o", "--owners" ]:
owners_file = arg
elif opt in [ "-w", "--workspace" ]:
workspace = arg
else:
assert False, "unknown option"
owners = read_owners(owners_file)
write_preamble()
comp_TPNOs = find_TPNOs(workspace)
p5m_dirs = find_p5m_dirs(workspace)
for p5m_dir in p5m_dirs:
gen_reports(workspace, p5m_dir)
write_reports(p5m_dirs, owners_file)
write_postamble()
sys.exit(0)