Generate TypeScript typings from Stone specification for NPM distribu…

…tion

Future publications of the dropbox NPM module will now include TypeScript typings
generated using the new TypeScript stone generator. Typings contain TSDoc annotations
for better IDE integration.

generator/generate_routes.py

@@ -9,7 +9,7 @@
 import sys
 
 cmdline_desc = """\
-Runs Stone to generate JS routes for the Dropbox client. 
+Runs Stone to generate JS routes for the Dropbox client.
 """
 
 _cmdline_parser = argparse.ArgumentParser(description=cmdline_desc)
@@ -56,27 +56,32 @@ def main():
         os.path.join(os.path.dirname(sys.argv[0]), '../src'))
     if verbose:
         print('Dropbox package path: %s' % dropbox_pkg_path)
-
+    typescript_template_path = os.path.abspath(
+        os.path.join(os.path.dirname(sys.argv[0]), 'typescript'))
     if verbose:
-        print('Generating JS client routes for user routes')
+        print('TypeScript template path: %s' % typescript_template_path)
 
     upload_arg = {
         "match": ["style", "upload"],
         "arg_name": "contents",
         "arg_type": "Object",
         "arg_docstring": "The file contents to be uploaded."
     }
+
+    if verbose:
+        print('Generating JS types')
     subprocess.check_output(
         (['python', '-m', 'stone.cli', 'js_types', dropbox_pkg_path] +
          specs + ['-b', 'team'] + ['-a', 'host', '-a', 'style', '-a', 'auth'] +
          ['--', 'types.js', '-e', json.dumps(upload_arg)]),
         cwd=stone_path)
 
+    if verbose:
+        print('Generating JS client routes for user routes')
     subprocess.check_output(
         (['python', '-m', 'stone.cli', 'js_client', dropbox_pkg_path] +
          specs + ['-b', 'team'] + ['-a', 'host', '-a', 'style', '-a', 'auth'] +
          ['--', 'routes.js', '-c', 'Dropbox']),
-#          '-e', json.dumps(upload_arg)]),
         cwd=stone_path)
 
     if verbose:
@@ -87,5 +92,29 @@ def main():
          ['-a', 'host', '-a', 'style', '-a', 'auth'] + ['--', 'routes-team.js', '-c', 'DropboxTeam']),
         cwd=stone_path)
 
+    if verbose:
+        print('Generating TSD types')
+    subprocess.check_output(
+        (['python', '-m', 'stone.cli', 'tsd_types', typescript_template_path] +
+         specs + ['-b', 'team'] + ['-a', 'host', '-a', 'style'] +
+         ['--', 'dropbox_types.d.tstemplate', 'dropbox_types.d.ts', '-e', json.dumps(upload_arg)]),
+        cwd=stone_path)
+
+    if verbose:
+        print('Generating TSD client routes for user routes')
+    subprocess.check_output(
+        (['python', '-m', 'stone.cli', 'tsd_client', typescript_template_path] +
+         specs + ['-b', 'team'] + ['-a', 'host', '-a', 'style'] +
+         ['--', 'dropbox.d.tstemplate', 'dropbox.d.ts']),
+        cwd=stone_path)
+
+    if verbose:
+        print('Generating TSD client routes for team routes')
+    subprocess.check_output(
+        (['python', '-m', 'stone.cli', 'tsd_client', typescript_template_path] +
+         specs + ['-w', 'team', '-f', 'style!="upload" and style!="download"'] +
+         ['-a', 'host', '-a', 'style'] + ['--', 'dropbox_team.d.tstemplate', 'dropbox_team.d.ts']),
+        cwd=stone_path)
+
 if __name__ == '__main__':
     main()

generator/typescript/Dropbox-sdk.min.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="./dropbox.d.ts" />
+export = DropboxTypes.Dropbox;
+export as namespace Dropbox;

generator/typescript/DropboxTeam-sdk.min.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="./dropbox_team.d.ts" />
+export = DropboxTypes.DropboxTeam;
+export as namespace DropboxTeam;

generator/typescript/dropbox-sdk.d.ts

@@ -0,0 +1,2 @@
+/// <reference path="./dropbox.d.ts" />
+export = DropboxTypes.Dropbox;