Update generate_port_list.py to generate Markdown

build_tools/generate_port_list.py

 #!/usr/bin/env python
 # Copyright (c) 2013 The Native Client Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
-"""Tool for generating list of ports in code.google.com wiki format.
+"""Tool for re-generating port list in markdown format
 """
 
 from __future__ import print_function
 
 import argparse
 import os
 import sys
 
 SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
 NACLPORTS_ROOT = os.path.dirname(SCRIPT_DIR)
+OUTPUT_FILE = os.path.join(NACLPORTS_ROOT, 'docs', 'port_list.md')
 
 sys.path.append(os.path.join(NACLPORTS_ROOT, 'lib'))
 
 import naclports
 import naclports.source_package
 
 SRC_URL = 'https://chromium.googlesource.com/external/naclports/+/master'
 
 header = '''\
-#summary List of ports available in naclports.
-= List of available !NaCl ports =
+# List of available NaCl ports
 
 Port are listed in alphabetical order, with links to the upstream
-source archive and the patch used when building for !NaCl.
+source archive and the patch used when building for NaCl.
 This listing is auto-generated by the
-[%s/build_tools/generate_port_list.py generate_port_list.py]
+[generate\_port\_list.py]
+(%s/build_tools/generate_port_list.py generate_port_list.py)
 script.
 
-|| *Name* || *Version* || *Upstream Archive* || *!NaCl Patch* || *Libc* \
-|| *Arch* || *Builds on* ||''' % SRC_URL
+| **Name** | **Version** | **Upstream Archive** | **NaCl Patch** | **Libc** \
+| **Arch** | **Builds on** |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+''' % SRC_URL
 
 
-def OutputTableRow(package):
-  if not package.URL:
-    return
+def MakeTableRow(package):
   patch = os.path.join(package.root, 'nacl.patch')
   if os.path.exists(patch):
-    relative_path = os.path.relpath(patch, NACLPORTS_ROOT)
     size = os.path.getsize(patch)
     if size < 1024:
-      patch = '[%s/%s %d B]' % (SRC_URL, relative_path, size)
+      patch = '[%d B][%s]' % (size, package.NAME + '_patch')
     else:
-      patch = '[%s/%s %d KiB]' % (SRC_URL, relative_path, size / 1024)
+      patch = '[%d KiB][%s]' % (size / 1024, package.NAME + '_patch')
   else:
     patch = ''
-  url = '[%s %s]' % (package.URL, package.GetArchiveFilename())
-  package_url = '[%s/%s %s]' % (SRC_URL,
-                                os.path.relpath(package.root, NACLPORTS_ROOT),
-                                package.NAME)
+  url = '[%s][%s]' % (package.GetArchiveFilename(), package.NAME + '_upstream')
+  package_url = '[%s]' % package.NAME
 
   libc = package.LIBC
   if libc:
     libc = libc + '-only'
   else:
     disabled_libc = getattr(package, 'DISABLED_LIBC')
     if disabled_libc:
       libc = 'not ' + ' or '.join(disabled_libc)
     else:
       libc = ''
 
   disabled_arch = getattr(package, 'DISABLED_ARCH')
   if disabled_arch:
     arch = 'not ' + ' or '.join(disabled_arch)
   else:
     arch = ''
 
   host = package.BUILD_OS
   if host:
     host = host + '-only'
   else:
     host = ''
   cols = (package_url, package.VERSION, url, patch, libc, arch, host)
-  print('|| %-70s || %-10s || %-50s || %s || %s || %s || %s ||' % cols)
+  return '| %-25s | %-15s | %-45s | %-20s | %s | %s | %s |\n' % cols
+
+
+def MakePage():
+  page = header
+
+  total = 0
+  for package in sorted(naclports.source_package.SourcePackageIterator()):
+    if package.URL:
+      page += MakeTableRow(package)
+    total += 1
+
+  page += '\n_Total = %d_\n\n' % total
+
+  page += '# Local Ports (not based on upstream sources) =\n\n'
+  total = 0
+  for package in naclports.source_package.SourcePackageIterator():
+    if package.URL:
+      continue
+    page += '- [%s][%s]\n' % (package.NAME, package.NAME)
+    total += 1
+  page += '\n_Total = %d_\n\n' % total
+
+  # Generate up to tree links for each package at the base of the page
+  for package in naclports.source_package.SourcePackageIterator():
+    relative_path = os.path.relpath(package.root, NACLPORTS_ROOT)
+    page += '[%s]: %s/%s\n' % (package.NAME, SRC_URL, relative_path)
+
+    patch = os.path.join(package.root, 'nacl.patch')
+    if os.path.exists(patch):
+      relative_path = os.path.relpath(patch, NACLPORTS_ROOT)
+      page += '[%s_patch]: %s/%s\n' % (package.NAME, SRC_URL, relative_path)
+
+    if package.URL:
+      page += '[%s_upstream]: %s\n' % (package.NAME, package.URL)
+
+
+  return page
 
 
 def main(args):
   parser = argparse.ArgumentParser(description=__doc__)
   parser.add_argument('-v', '--verbose', action='store_true',
                       help='Output extra information.')
   parser.parse_args(args)
-  rtn = 0
-
-  print(header)
-
-  total = 0
-  for package in sorted(naclports.source_package.SourcePackageIterator()):
-    OutputTableRow(package)
-    total += 1
-
-  print('\n_Total = %d_\n' % total)
-
-  print('= Local Ports (not based on upstream sources) =\n')
-  total = 0
-  for package in naclports.source_package.SourcePackageIterator():
-    if package.URL:
-      continue
-    package_url = '[%s/%s %s]' % (SRC_URL,
-                                  os.path.relpath(package.root, NACLPORTS_ROOT),
-                                  package.NAME)
-    print('|| %-70s ||' % package_url)
-    total += 1
-  print('\n_Total = %d_\n' % total)
-
-  return rtn
+  with open(OUTPUT_FILE, 'w') as f:
+    f.write(MakePage())
+  return 0
 
 
 if __name__ == '__main__':
   sys.exit(main(sys.argv[1:]))