Add skydoc.py, a tool for running dartdoc

sky/tools/skydoc.py

+#!/usr/bin/env python
+# Copyright 2015 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.
+
+import argparse
+import os
+import subprocess
+import sys
+
+from skypy.url_mappings import URLMappings
+
+SKY_TOOLS_DIR = os.path.dirname(os.path.abspath(__file__))
+SKY_ROOT = os.path.dirname(SKY_TOOLS_DIR)
+SRC_ROOT = os.path.dirname(SKY_ROOT)
+
+DARTDOC = 'dartdoc'
+
+def main():
+    try:
+        subprocess.check_output([DARTDOC, '--version'])
+    except:
+        print 'Cannot find "dartdoc". Did you run `pub global activate dartdoc` ?'
+        return 1
+
+    parser = argparse.ArgumentParser(description='Sky Documentation Generator')
+    parser.add_argument('build_dir', type=str, help='Path to build output')
+    args = parser.parse_args()
+
+    build_dir = os.path.abspath(args.build_dir)
+    url_mappings = URLMappings(SRC_ROOT, build_dir)
+
+    packages_root = os.path.join(build_dir, 'gen/dart-pkg/packages')
+    sky_package = os.path.join(build_dir, 'gen/dart-pkg/sky')
+    doc_dir = os.path.join(build_dir, 'gen/dart-pkg/sky/doc')
+
+    if not os.path.exists(packages_root):
+        print 'Cannot find Dart pacakges at "%s".' % packages_root
+        print 'Did you run `ninja -C %s sky` ?' % os.path.relpath(build_dir, os.getcwd())
+        return 1
+
+    analyzer_args = [
+        DARTDOC,
+        '--package-root', packages_root,
+        '--input', sky_package,
+        '--output', doc_dir,
+    ] + url_mappings.as_args
+    subprocess.check_call(analyzer_args)
+
+if __name__ == '__main__':
+    sys.exit(main())