[NaCl SDK] Convert python scripts from optparse to argparse.

native_client_sdk/src/doc/doxygen/generate_docs.py

 #!/usr/bin/python
-
 # Copyright (c) 2014 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
+"""Script to regenerate API docs using doxygen.
+"""
+
 import collections
 import json
-import optparse
+import argparse

[binji, 2014/11/13 23:57:02]

sort

[Sam Clegg, 2014/11/30 17:55:12]

Done.

 import os
 import shutil
 import subprocess
 import sys
 import tempfile
 import urllib2
 
 
 if sys.version_info < (2, 7, 0):
   sys.stderr.write("python 2.7 or later is required run this script\n")
@@ skipping 201 matching lines @@
 
 
 def RunRstIndex(kind, channel, pepper_version, out_dirname, out_rst_filename):
   assert kind in ('root', 'c', 'cpp')
   script = os.path.join(SCRIPT_DIR, 'rst_index.py')
   cmd = [sys.executable, script,
          '--' + kind,
          '--channel', channel,
          '--version', pepper_version,
          out_dirname,
-         '-o', out_rst_filename]
+         out_rst_filename]
   Trace('Running rst_index:\n  %s' % ' '.join(cmd))
   subprocess.check_call(cmd)
 
 
 def GetRstName(kind, channel):
   if channel == 'stable':
     filename = '%s-api.rst' % kind
   else:
     filename = '%s-api-%s.rst' % (kind, channel)
   return os.path.join(DOC_DIR, filename)
@@ skipping 40 matching lines @@
     RunDoxygen(out_dirname_cpp, doxyfile_cpp)
     RunDoxyCleanup(out_dirname_cpp)
     RunRstIndex('cpp', channel, pepper_version, out_dirname_cpp, rst_index_cpp)
   finally:
     # Cleanup
     RemoveDir(svn_dirname)
     RemoveDir(doxyfile_dirname)
 
 
 def main(argv):
-  parser = optparse.OptionParser(usage='Usage: %prog [options] <out_directory>')
-  parser.add_option('-v', '--verbose',
+  parser = argparse.ArgumentParser(description=__doc__)
+  parser.add_argument('-v', '--verbose',
                     help='Verbose output', action='store_true')

[binji, 2014/11/13 23:57:02]

nit: align

[Sam Clegg, 2014/11/30 17:55:12]

Done.

-  options, dirs = parser.parse_args(argv)
+  parser.add_argument('dir')

[binji, 2014/11/13 23:57:02]

better name: out_directory?

[Sam Clegg, 2014/11/30 17:55:12]

Done.

+  options = parser.parse_args(argv)
 
   if options.verbose:
     Trace.verbose = True
 
-  if len(dirs) != 1:
-    parser.error('Expected an output directory')
-
   channel_info = GetChannelInfo()
   for channel, info in channel_info.iteritems():
-    GenerateDocs(dirs[0], channel, info.version, info.branch)
+    GenerateDocs(options.dir, channel, info.version, info.branch)
 
   return 0
 
 
 if __name__ == '__main__':
   try:
     rtn = main(sys.argv[1:])
   except KeyboardInterrupt:
     sys.stderr.write('%s: interrupted\n' % os.path.basename(__file__))
     rtn = 1
   sys.exit(rtn)