Merge pull request #1254 from MridulS/example_api

Update binder API example to include file/urlpath

Author: minrk

examples/binder-api.py

@@ -16,8 +16,7 @@
 
 
 def build_binder(repo,
-                 ref='master',
-                 filepath=None,
+                 ref,
                  *,
                  binder_url='https://mybinder.org'):
     """Launch a binder
@@ -38,9 +37,12 @@ def build_binder(repo,
     parser = argparse.ArgumentParser(description=__doc__)
     parser.add_argument('repo', type=str, help="The GitHub repo to build")
     parser.add_argument(
-        '--ref', default='master', help="The ref of the repo to build")
-    parser.add_argument(
+        '--ref', default='HEAD', help="The ref of the repo to build")
+    file_or_url = parser.add_mutually_exclusive_group()
+    file_or_url.add_argument(
         '--filepath', type=str, help="The file to open, if any.")
+    file_or_url.add_argument(
+        '--urlpath', type=str, help="The url to open, if any.")
     parser.add_argument(
         '--binder',
         default='https://mybinder.org',
@@ -53,15 +55,19 @@ def build_binder(repo,
     for evt in build_binder(
             opts.repo,
             ref=opts.ref,
-            filepath=opts.filepath,
             binder_url=opts.binder):
         if 'message' in evt:
             print("[{phase}] {message}".format(
                 phase=evt.get('phase', ''),
                 message=evt['message'].rstrip(),
             ))
         if evt.get('phase') == 'ready':
-            url = "{url}?token={token}".format(**evt)
+            if opts.filepath:
+                url = "{url}notebooks/{filepath}?token={token}".format(**evt, filepath=opts.filepath)
+            elif opts.urlpath:
+                url = "{url}{urlpath}?token={token}".format(**evt, urlpath=opts.urlpath)
+            else:
+                url = "{url}?token={token}".format(**evt)
             print("Opening %s" % url)
             webbrowser.open(url)
             break