Added script to run local files on App Engine

pkg/docgen/bin/dartdoc.py

+#!/usr/bin/env python
+#
+# Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
+# for details. All rights reserved. Use of this source code is governed by a
+# BSD-style license that can be found in the LICENSE file. 
+
+""" Run this script to generate documentation for a directory and serve
+  the results to localhost for viewing in the browser.
+"""
+
+import argparse
+import os
+from os.path import join, dirname, abspath, exists
+import platform
+import subprocess
+import sys
+sys.path.append(abspath(join(dirname(__file__), '../../../tools')))
+import utils
+from upload_sdk import ExecuteCommand
+
+DART = abspath(join(dirname(__file__), '../../../%s/%s/dart-sdk/bin/dart'
+    % (utils.BUILD_ROOT[utils.GuessOS()], utils.GetBuildConf('release',
+    utils.GuessArchitecture()))))
+PUB = abspath(join(dirname(__file__), '../../../sdk/bin/pub'))
+DART2JS = abspath(join(dirname(__file__), '../../../sdk/bin/dart2js'))
+PACKAGE_ROOT = abspath(join(dirname(__file__), '../../../%s/%s/packages/'
+    % (utils.BUILD_ROOT[utils.GuessOS()], utils.GetBuildConf('release',

[Emily Fortuna, 2013/08/12 17:04:05]

just a suggestion -- consider creating the package root path relative to DART,
so you don't repeat GuessArchitecture and such twice. Also, consider storing
abspath(dirname(__file__)) in a variable and then you can just call join(foo,
'../tools')

[Tate Mandel, 2013/08/12 20:24:04]

Done.

+    utils.GuessArchitecture()))))
+DESCRIPTION='Runs docgen on the specified library and displays the resulting \

[Emily Fortuna, 2013/08/12 17:04:05]

does this need to be a global? It's just used in one spot

[Tate Mandel, 2013/08/12 20:24:04]

Done.

+    documentation in the browser'
+
+def SetPackageRoot(path):
+  global PACKAGE_ROOT
+  if exists(path):
+    PACKAGE_ROOT = abspath(path)
+
+def GetOptions():
+  parser = argparse.ArgumentParser(description=DESCRIPTION)
+  parser.add_argument('--package-root', dest='pkg_root',
+    help='The package root for dart (default is in the build directory).',
+    action='store', default=PACKAGE_ROOT)
+  parser.add_argument('--options', 
+    help='The options being passed into docgen.')

[Emily Fortuna, 2013/08/12 17:04:05]

would it be possible to invoke dogen.dart --help, capture the output, and return
that here to show what the options are to pass into docgen? That would be pretty
nice. :-)

[Tate Mandel, 2013/08/12 20:24:04]

Done. - argparse doesn't allow the help text to have newlines for arguments, so
it isn't that pretty when you run it, but all of the information is there.

[Emily Fortuna, 2013/08/12 21:05:05]

Oh, hm... well if it's unreadable don't bother. I just thought it'd be  nice.

+  parser.add_argument('--gae-sdk',
+    help='The path to the Google App Engine SDK.')
+  options = parser.parse_args()
+  SetPackageRoot(options.pkg_root)
+  return options
+
+def main():
+  options = GetOptions()
+  print(options.options.split())
+  docgen = [DART, '--checked', '--package-root=' + PACKAGE_ROOT,
+    abspath(join(dirname(__file__), 
+    'docgen.dart'))]
+  docgen.extend(options.options.split())
+  ExecuteCommand(docgen)
+  ExecuteCommand(['git', 'clone', '-b', 'dev',
+   'git://github.com/dart-lang/dartdoc-viewer.git'])
+  ExecuteCommand(['mv', 'docs', 'dartdoc-viewer/client/local'])
+  os.chdir('dartdoc-viewer/client/')
+  subprocess.call([PUB, 'install'])
+  subprocess.call([DART, 'build.dart'])
+  subprocess.call([DART2JS, '-o', 'web/out/index.html_bootstrap.dart.js', 
+    './web/out/index.html_bootstrap.dart'])
+  server = subprocess.Popen(['python', 
+    join(abspath(join(dirname(__file__), options.gae_sdk)), 'dev_appserver.py'),

[Emily Fortuna, 2013/08/12 17:04:05]

Could you print a line here saying "now point your browser to foo-path to see
the result?" (I'm guessing dev_appserver.py runs the server, but does not open a
browser window for you at a particular address, right?)

[Tate Mandel, 2013/08/12 20:24:04]

The dev server prints a few lines when it starts saying the address. It has
always been localhost:8080 for me, but it might do something different if that's
in use. I added a print statement, and here is the output after dart2js runs:

Point your browser to the address of the 'default' server below.
Press <RETURN> to terminate the server.

INFO     2013-08-12 19:53:36,980 sdk_update_checker.py:244] Checking for updates
to the SDK.
INFO     2013-08-12 19:53:37,096 api_server.py:138] Starting API server at:
http://localhost:54813
INFO     2013-08-12 19:53:37,165 dispatcher.py:164] Starting server "default"
running at: http://localhost:8080
INFO     2013-08-12 19:53:37,167 admin_server.py:117] Starting admin server at:
http://localhost:8000

+    '..'])
+  raw_input("Press <RETURN> to terminate the server.\n")
+  server.terminate()
+  os.chdir('../..')
+  subprocess.call(['rm', '-rf', 'dartdoc-viewer'])
+
+if __name__ == '__main__':
+  main()