Extension docs server: APIDataSource

chrome/common/extensions/docs/server2/build_server.py

 #!/usr/bin/env python
 # Copyright (c) 2012 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.
 
 # This script is used to copy all dependencies into the local directory.
 # The package of files can then be uploaded to App Engine.
 import os
 import shutil
 import sys
 
 THIRD_PARTY_DIR = os.path.join(sys.path[0], os.pardir, os.pardir, os.pardir,
      os.pardir, os.pardir, 'third_party')
 LOCAL_THIRD_PARTY_DIR = os.path.join(sys.path[0], 'third_party')
+TOOLS_DIR = os.path.join(sys.path[0], os.pardir, os.pardir, os.pardir,
+     os.pardir, os.pardir, 'tools')
+
+SCHEMA_COMPILER_FILES = ['model.py']
+
+def MakeInit(path):
+  path = os.path.join(path, '__init__.py')
+  with open(os.path.join(path), 'w') as f:
+    os.utime(os.path.join(path), None)
 
 def main():
   shutil.rmtree(LOCAL_THIRD_PARTY_DIR, True)
+
+  # Get handlebar.
+  local_handlebar_path = os.path.join(LOCAL_THIRD_PARTY_DIR, 'handlebar')
   shutil.copytree(os.path.join(THIRD_PARTY_DIR, 'handlebar'),
-      os.path.join(LOCAL_THIRD_PARTY_DIR, 'handlebar'))
+      local_handlebar_path)
 
-  with open(os.path.join(LOCAL_THIRD_PARTY_DIR, '__init__.py'), 'w') as f:
-    os.utime(os.path.join(LOCAL_THIRD_PARTY_DIR, '__init__.py'), None)
+  # Get json_schema_compiler files.
+  local_schema_compiler_path = os.path.join(LOCAL_THIRD_PARTY_DIR,
+      'json_schema_compiler')
+  os.makedirs(local_schema_compiler_path)
+  for filename in SCHEMA_COMPILER_FILES:
+    shutil.copy(os.path.join(TOOLS_DIR, 'json_schema_compiler', filename),
+        os.path.join(local_schema_compiler_path, filename))

[not at google - send to devlin, 2012/06/10 06:58:22]

Could you have some kind of CopyThirdParty function or something which makes
this all a bit less hands-on?

[cduvall, 2012/06/18 19:13:46]

Done.

 
-  shutil.copy(os.path.join(LOCAL_THIRD_PARTY_DIR, '__init__.py'),
-      os.path.join(LOCAL_THIRD_PARTY_DIR, 'handlebar'))
-  with open(
-      os.path.join(LOCAL_THIRD_PARTY_DIR, 'handlebar/__init__.py'), 'a') as f:
-    f.write('\nfrom handlebar import Handlebar\n')
+  # We will need the comment eater to load JSON.
+  shutil.copy(os.path.join(TOOLS_DIR, 'json_comment_eater.py'),
+      os.path.join(local_schema_compiler_path, 'json_comment_eater.py'))
+
+  MakeInit(LOCAL_THIRD_PARTY_DIR)
+  MakeInit(local_schema_compiler_path)
+  MakeInit(local_handlebar_path)
+
+  # To be able to use the Handlebar class we need this import in __init__.py.

[not at google - send to devlin, 2012/06/10 06:58:22]

Why do you need it in __init__ (I'm curious / lacking in understanding)?

[cduvall, 2012/06/18 19:13:46]

For some reason python won't let you import classes from a different directory
without there being an import in that directory's __init__.py. It gives the
error 'ImportError: cannot import name Handlebar' if this import is not here.

I tried a few different things to get the import to work, but this was the best
solution I found.

+  with open(os.path.join(local_handlebar_path, '__init__.py'), 'a') as f:
+    f.write('from handlebar import Handlebar\n')
 
 if __name__ == '__main__':
   main()