Add extension equivalency

Author: fcollonval

conf.py

@@ -23,9 +23,17 @@
 
 HERE = pathlib.Path(__file__).parent
 GET_REPOS = "https://api.github.com/orgs/jupyterlab-contrib/repos"
+GET_REPO = "https://api.github.com/repos/jupyterlab-contrib/"
 TOKEN = os.getenv("GITHUB_TOKEN")
 
-extensions = (HERE / "extensions.tpl").read_text()
+footer = (HERE / "extensions.tpl").read_text()
+header = """# List of extensions and tools
+
+## Extensions in this organization
+
+The extensions hosted in this organization.
+
+"""
 default_headers = {}
 if TOKEN is not None:
     default_headers["authorization"] = f"Bearer {TOKEN}"
@@ -37,6 +45,7 @@
         params={"per_page": 100},
     )
     data = repos.json()
+    extensions = ""
     for repo in data:
         if isinstance(repo, str):
             raise ValueError(data["message"])
@@ -45,6 +54,12 @@
             continue  # Skip special repositories
 
         try:
+            response = requests.get(
+                GET_REPO + repo["name"],
+                headers={**default_headers, "Accept": "application/vnd.github.v3+json"}
+            )
+            repo_attributes = response.json()
+            description = repo_attributes.get("description", "")
             readme = requests.get(
                 repo["contents_url"].replace("{+path}", "README.md"),
                 headers={
@@ -54,15 +69,15 @@
             )
             filename = repo["name"]
             (HERE / (filename + ".md")).write_text(readme.text)
-            extensions += f"\n* [{filename.replace('_', ' ')}]({filename}.md)"
+            extensions += f"\n* [{filename.replace('_', ' ')}]({filename}.md): {description}"
         except BaseException as err:
             print(err)
             print(f"Fail to get README for {filename}.")
 except BaseException as err:
     print(err)
     print("Fail to get organization repositories")
 finally:
-    (HERE / "extensions.md").write_text(extensions)
+    (HERE / "extensions.md").write_text(header + extensions + footer)
 
 
 # -- Project information -----------------------------------------------------

extensions.tpl

@@ -1,4 +1,3 @@
-# List of extensions and tools
 
 ## Extensions from elsewhere
 
@@ -55,6 +54,5 @@ This a list of nice JupyterLab extensions not part of ``jupyterlab-contrib`` org
 - [Dask](https://github.com/dask/dask-labextension) - Manage Dask clusters, as well as embed Dask's dashboard plots directly into JupyterLab panes.
 - [jupyterlab-autoplay](https://github.com/remborg/autoplay) - Run and hide code cells automatically when opening a notebook.
 
-## Extensions in this organization
-
-The extensions hosted in this organization.
+If you don't find what you are looking here or in the web, you can always start coding a new extension; for
+more information have a look at the [documentation](https://jupyterlab.readthedocs.io/en/stable/extension/extension_dev.html).