Merge pull request #19 from nipreps/enh/community-members-table

ENH: Render a list of community members

Author: oesteban

.github/workflows/deploy.yml

@@ -34,6 +34,7 @@ jobs:
     - name: Build
       run: |
         cd mkdocs/
+        python scripts/generate_members_grid.py
         mkdocs build -d ../www/
 
     - name: Deploy

docs/community/index.md

@@ -36,5 +36,7 @@ to efficiently evaluate the validity of new features (even to exercise a minuscu
 of the domain of inputs).
 The redundancy of expert eyes looking at our code has only helped make it better.
 
-[Neurostars.org]: https://neurostars.org
+## Members
+
 
+[Neurostars.org]: https://neurostars.org

docs/stylesheets/extra.css

@@ -1,4 +1,11 @@
 
 div.recommended.highlight span.hll {
   background-color: #a7e8c8;
+}
+
+.avatar {
+  vertical-align: middle;
+  width: 50px;
+  height: 50px;
+  border-radius: 50%;
 }

scripts/generate_members_grid.py

@@ -0,0 +1,67 @@
+# emacs: -*- mode: python; py-indent-offset: 4; indent-tabs-mode: nil -*-
+# vi: set ft=python sts=4 ts=4 sw=4 et:
+#
+# Copyright 2021 The NiPreps Developers <[email protected]>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# We support and encourage derived works from this project, please read
+# about our expectations at
+#
+#     https://www.nipreps.org/community/licensing/
+#
+"""Query the GitHub API to retrieve the list of members."""
+
+import os
+import requests
+from pathlib import Path
+
+
+def main(argv=None):
+    gh_token = os.getenv("GITHUB_TOKEN", None)
+
+    if not gh_token:
+        raise RuntimeError("No token")
+    
+    response = requests.get(
+        "https://api.github.com/orgs/nipreps/members?per_page=100",
+        headers={
+            "Accept": "application/vnd.github+json",
+            "Authorization": f"Bearer {gh_token}",
+        }
+    )
+    
+    if not response.ok:
+        raise RuntimeError(f"Response failed ({response.code})")
+    
+    members = [
+        f'<img class=".avatar" src="{item["avatar_url"}" />'
+        for item in response.json()
+    ]
+
+    target_file = Path(__file__).parent.parent / "docs" / "community" / "index.md"
+
+    lines = target_file.read_text().splitlines()
+    insert_line = len(lines)
+
+    for line in reversed(lines):
+        if line.strip().startswith("## Members"):
+            break
+        insert_line -= 1
+
+    lines = lines[:insert_line] + members + lines[insert_line:]
+    target_file.write_text("\n".join(lines))
+
+
+if __name__ == "__main__":
+    main()