add python workflow-scripts

Author: celadari

.github/workflows/release.yml

@@ -7,24 +7,45 @@ jobs:
   publish-doc:
     runs-on: ubuntu-20.04
     steps:
+      - name: Install ansi2txt tool
+        run: |
+          sudo apt-get update
+          sudo apt-get install colorized-logs
       - uses: actions/checkout@v2
+        with:
+          token: ${{ secrets.PAT_TOKEN }}
       - name: Generate API Doc
         run: sbt doc
       - name: Make API Doc directory outside repository
-        run: mkdir ../api_docs
+        run: mkdir -p ../api_docs
       - name: Move API Docs to outside directory
-        run: mv target/scala-[0-9].[0-9][0-9] ../api_docs/
-      - name: check something
-        run: ls ../api_docs
-      - name: git checkout master
+        run: |
+          source .workflow-scripts/put_scala_docs_aside.sh ./target ../api_docs
+          cp .workflow-scripts/move_scala_docs.sh ../api_docs/
+          cp .workflow-scripts/update_json_api_versions.py ../api_docs/
+          echo "scala_versions=$scala_versions" >> $GITHUB_ENV
+          echo "api_version=$api_version" >> $GITHUB_ENV
+      - name: Git checkout on gh-pages
         run:  |
           git fetch
-          git checkout master
-      - name: something else2
-        run: pwd
-      - name: something else3
-        run: ls ../
+          git checkout gh-pages
+      - name: Move API Docs to website API Docs directory
+        run: |
+          cd ..
+          export scala_versions="${{ env.scala_versions }}"
+          export api_version="${{ env.api_version }}"
+          bash api_docs/move_scala_docs.sh ./api_docs "./${GITHUB_REPOSITORY#*/}/docs/_api" ./api_docs "./${GITHUB_REPOSITORY#*/}/docs/_data/api_versions.json"
+      - name: Git add and commit on gh-pages
+        run: |
+          git config user.name "$GITHUB_ACTOR"
+          git config user.email "$GITHUB_ACTOR+github-actions@users.noreply.github.com"
+          git add docs/_api/.
+          git add docs/_data/api_versions.json
+          git commit -m "[RELEASE] Update doc version from branch \"$GITHUB_REF\" commit \"$GITHUB_REF\""
+          git push
 
+#      - name: something else3
+#        run: ls ../
 #  publish-package:
 #    runs-on: ubuntu-latest
 #    needs: [publish-doc]

.workflow-scripts/move_scala_docs.sh

@@ -0,0 +1,11 @@
+
+
+# shellcheck disable=SC2154
+for scala_version in $scala_versions
+do
+  mkdir -p "$2/scala-$scala_version"
+  rm -rf "$2/scala-$scala_version/latest"
+  cp -r "$1/scala-$scala_version/$api_version" "$2/scala-$scala_version/latest"
+  mv "$1/scala-$scala_version/$api_version" "$2/scala-$scala_version/"
+  python "$3/update_json_api_versions.py" "$4" "$api_version" --scala-versions "$scala_versions"
+done

.workflow-scripts/put_scala_docs_aside.sh

@@ -0,0 +1,15 @@
+
+
+# shellcheck disable=SC2010
+scala_versions=$(ls "$1" | grep -Eo "[0-9]\.[0-9][0-9]")
+#api_version=$(sbt version | sed -r 's/[^ \t\r\n\v\f0-9\.i?n?f?o?]+ (.+)/APP_VERSION\1/' | sed -n '6p' | grep -Po '(?<=PP_VERSION)(.+)')
+api_version=$(sbt version | ansi2txt | tail -n1 | sed -r 's/^\[info\] (.+)$/\1/')
+
+export scala_versions
+export api_version
+
+for scala_version in $scala_versions
+do
+  mkdir -p "$2/scala-$scala_version/$api_version"
+  mv "$1/scala-$scala_version/api/" "$2/scala-$scala_version/$api_version/"
+done

.workflow-scripts/update_json_api_versions.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+
+import argparse
+import json
+import os
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser()
+    parser.add_argument('path_json')
+    parser.add_argument('api_version')
+    parser.add_argument('--scala-versions', dest='scala_versions', nargs='+')
+    args = parser.parse_args()
+
+    if os.path.isfile(args.path_json):
+        with open(args.path_json, 'r') as f:
+            data = json.load(f)
+    else:
+        data = {}
+    for scala_version in args.scala_versions:
+        scala_version_indices = [i for i, data_version in enumerate(data) if data_version['scala-version'] == scala_version]
+        if scala_version_indices:
+            scala_version_index = scala_version_indices[0]
+            data[scala_version_index]['json-logic-versions'] = [args.api_version] + data[scala_version_index]['json-logic-versions']
+        else:
+            data.append({'scala-version': scala_version, 'json-logic-versions': [args.api_version]})
+    with open(args.path_json, 'w') as f:
+        json.dump(data, f)