create dartdoc snapshot, add to dart-sdk. Also add resources needed to run dartdoc from the sdk.

tools/create_sdk.py

 #!/usr/bin/env python
 #
 # Copyright (c) 2012, 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.
 #
 # A script which will be invoked from gyp to create an SDK.
 #
 # Usage: create_sdk.py sdk_directory
 #
 # The SDK will be used either from the command-line or from the editor.
 # Top structure is
 #
 # ..dart-sdk/
 # ....bin/
 # ......dart or dart.exe (executable)
 # ......dart.lib (import library for VM native extensions on Windows)
+# ......dartdoc
 # ......dartfmt
 # ......dart2js
 # ......dartanalyzer
 # ......pub
 # ......snapshots/
 # ........analysis_server.dart.snapshot
 # ........dart2js.dart.snapshot
 # ........dartanalyzer.dart.snapshot
+# ........dartdoc.dart.snapshot
 # ........dartfmt.dart.snapshot
 # ........pub.dart.snapshot
 # ........utils_wrapper.dart.snapshot
+#.........resources/
+#...........dartdoc/
+#..............packages
+#.............resources/
+#.............templates/
 # ....include/
 # ......dart_api.h
 # ......dart_mirrors_api.h
 # ......dart_native_api.h
 # ......dart_tools_api.h
 # ....lib/
 # ......_internal/
 # ......async/
 # ......collection/
 # ......convert/
@@ skipping 68 matching lines @@
   if dest_file.endswith('_sdk'):
     dest_file = dest_file.replace('_sdk', '')
 
   src = src_file + file_extension
   dest = join(dest_dir, dest_file + file_extension)
   Copy(src, dest)
 
 
 def CopyDartScripts(home, sdk_root):
   for executable in ['dart2js_sdk', 'dartanalyzer_sdk', 'dartfmt_sdk', 'docgen',
-                     'dartdocgen', 'pub_sdk']:
+                     'dartdocgen', 'pub_sdk', 'dartdoc']:
     CopyShellScript(os.path.join(home, 'sdk', 'bin', executable),
                     os.path.join(sdk_root, 'bin'))
 
 
 def CopySnapshots(snapshots, sdk_root):
   for snapshot in ['analysis_server', 'dart2js', 'dartanalyzer', 'dartfmt',
-                   'utils_wrapper', 'pub']:
+                   'utils_wrapper', 'pub', 'dartdoc']:
     snapshot += '.dart.snapshot'
     copyfile(join(snapshots, snapshot),
              join(sdk_root, 'bin', 'snapshots', snapshot))
 
+def CopyDartdocResources(home,sdk_root):
+  RESOURCE_DIR = join(sdk_root, 'bin', 'snapshots', 'resources')
+  os.makedirs(RESOURCE_DIR)

[Bill Hesse, 2015/08/18 22:15:21]

This first makedirs is redundant, because makedirs recursively makes all
necessary intermediate dirs.

+  DARTDOC = join(RESOURCE_DIR, 'dartdoc')
+  os.makedirs(DARTDOC)
+
+  copytree(join(home, 'third_party', 'pkg', 'dartdoc', 'lib', 'templates'),

[Bill Hesse, 2015/08/18 22:15:21]

In fact, copytree is documented to create all necessary missing intermediate
directories.

[keertip, 2015/08/18 22:34:36]

Did not know that. Removed the makedirs.

+           join(DARTDOC, 'templates'))
+  copytree(join(home, 'third_party', 'pkg', 'dartdoc', 'lib', 'resources'),
+           join(DARTDOC, 'resources'))
+  # write the .packages file
+  PACKAGES_FILE = join(DARTDOC, '.packages')
+  packages_file = open(PACKAGES_FILE, 'w')
+  packages_file.write('dartdoc:.')
+  packages_file.close() 
+
 
 def Main():
   # Pull in all of the gypi files which will be munged into the sdk.
   HOME = dirname(dirname(realpath(__file__)))
 
   (options, args) = GetOptions()
 
   SDK = options.sdk_output_dir
   SDK_tmp = '%s.tmp' % SDK
 
@@ skipping 105 matching lines @@
 
   # Copy in 7zip for Windows.
   if HOST_OS == 'win32':
     copytree(join(HOME, 'third_party', '7zip'),
              join(RESOURCE, '7zip'),
              ignore=ignore_patterns('.svn'))
 
   # Copy dart2js/pub.
   CopyDartScripts(HOME, SDK_tmp)
   CopySnapshots(SNAPSHOT, SDK_tmp)
+  CopyDartdocResources(HOME, SDK_tmp)
 
   # Write the 'version' file
   version = utils.GetVersion()
   versionFile = open(os.path.join(SDK_tmp, 'version'), 'w')
   versionFile.write(version + '\n')
   versionFile.close()
 
   # Write the 'revision' file
   revision = utils.GetGitRevision()
 
   if revision is not None:
     with open(os.path.join(SDK_tmp, 'revision'), 'w') as f:
       f.write('%s\n' % revision)
       f.close()
 
   Copy(join(HOME, 'README.dart-sdk'), join(SDK_tmp, 'README'))
   Copy(join(HOME, 'sdk', 'api_readme.md'), join(SDK_tmp, 'lib', 'api_readme.md'))
 
   move(SDK_tmp, SDK)
 
 if __name__ == '__main__':
   sys.exit(Main())