update: publish docs workflow

.github/workflows/pipeline-release-tag.yml

@@ -250,6 +250,9 @@ jobs:
       - setup
       - release
 
+    outputs:
+      isLatest: ${{ steps.merge-check.outputs.isLatest }}
+
     steps:
       - uses: actions/checkout@v4
         with:
@@ -267,10 +270,13 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
 
       - name: Check API and merge to master
+        id: merge-check
         run: |
           response=`curl -s -X GET "https://api.supertokens.io/0/driver/latest/check?password=${{ secrets.SUPERTOKENS_API_KEY }}&version=${{ needs.setup.outputs.setupVersion }}&name=python" -H 'api-version: 0'`
           isLatest=$(echo $response | jq .isLatest)
 
+          echo "isLatest=$isLatest" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+
           if [[ $isLatest == "true" ]]
           then
             git checkout master
@@ -288,17 +294,42 @@ jobs:
     needs:
       - setup
       - release
+      - merge
 
     steps:
       - uses: actions/checkout@v4
         with:
           ref: ${{ needs.setup.outputs.releaseTag }}
           fetch-tags: true
+          path: supertokens-python
+
+      - uses: actions/checkout@v4
+        with:
+          repository: supertokens/supertokens-backend-website
+          token: ${{ secrets.ALL_REPO_PAT }}
+          path: supertokens-backend-website
+
+      - run: |
+          shopt -s extglob # Enable extended globbing
+
+          if [[ "${{ needs.merge.outputs.isLatest }}" == "true" ]]
+          then
+            # Delete everything except the version folders
+            rm -rf supertokens-backend-website/app/docs/sdk/docs/python/!(*.*.X)
+            # Copy files to the root dir
+            cp -r supertokens-python/html/supertokens_python/* supertokens-backend-website/app/docs/sdk/docs/python/
+          fi
+
+          # Delete the current version folder if it exists
+          rm -rf supertokens-backend-website/app/docs/sdk/docs/python/${{ needs.setup.outputs.versionFolder }}
+          # Copy the current docs
+          mkdir -p supertokens-backend-website/app/docs/sdk/docs/python/${{ needs.setup.outputs.versionFolder }}
+          cp -r supertokens-python/html/supertokens_python/* supertokens-backend-website/app/docs/sdk/docs/python/${{ needs.setup.outputs.versionFolder }}
 
       - uses: actions/upload-artifact@v4
         with:
           name: ${{ needs.setup.outputs.artifactName }}
-          path: html/supertokens_python
+          path: supertokens-backend-website/app/docs/sdk/docs/python
 
       - name: Trigger the backend website CI
         uses: actions/github-script@v7
@@ -314,7 +345,7 @@ jobs:
                 inputs: {
                   "version": `${{ needs.setup.outputs.setupVersion }}`,
                   "artifact-name": `${{ needs.setup.outputs.artifactName }}`,
-                  "version-folder": `${{ needs.setup.outputs.versionFolder }}`,
+                  "version-folder": `app/docs/sdk/docs/python`,
                   "run-id": `${{ github.run_id }}`,
                   "stage":  "production",
                 }

.github/workflows/update-docs-test.yml

@@ -0,0 +1,120 @@
+name: "Update Docs - Test"
+
+on:
+  pull_request:
+    types:
+      - synchronize
+
+permissions:
+  contents: write
+
+jobs:
+  setup:
+    runs-on: ubuntu-latest
+
+    outputs:
+      constantsVersion: ${{ steps.versions.outputs.constantsVersion }}
+      constantsVersionXy: ${{ steps.versions.outputs.constantsVersionXy }}
+      setupVersion: ${{ steps.versions.outputs.setupVersion }}
+      setupVersionXy: ${{ steps.versions.outputs.setupVersionXy }}
+      newestVersion: ${{ steps.versions.outputs.newestVersion }}
+      targetBranch: ${{ steps.versions.outputs.targetBranch }}
+      devTag: ${{ steps.versions.outputs.devTag }}
+      releaseTag: ${{ steps.versions.outputs.releaseTag }}
+      versionFolder: ${{ steps.versions.outputs.versionFolder }}
+      artifactName: ${{ steps.versions.outputs.artifactName }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.branch }}
+          fetch-tags: true
+          token: ${{ secrets.ALL_REPO_PAT }}
+
+      - name: Populate variables
+        id: versions
+        run: |
+          . ./hooks/populate-hook-constants.sh
+
+          echo "constantsVersion=$constantsVersion" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+          echo "constantsVersionXy=$constantsVersionXy" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+          echo "setupVersion=$setupVersion" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+          echo "setupVersionXy=$setupVersionXy" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+          echo "newestVersion=$newestVersion" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+          echo "targetBranch=$targetBranch" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+
+          echo "devTag=dev-v$setupVersion" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+          echo "releaseTag=v$setupVersion" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+
+          echo "versionFolder=$setupVersionXy.X" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+          echo "artifactName=python-docs-$setupVersion" | tee -a "$GITHUB_OUTPUT" "$GITHUB_ENV"
+
+  publish-docs:
+    runs-on: ubuntu-latest
+    needs: setup
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        ref: ${{ needs.setup.outputs.releaseTag }}
+        fetch-tags: true
+        path: supertokens-python
+
+    - uses: actions/checkout@v4
+      with:
+        repository: supertokens/supertokens-backend-website
+        token: ${{ secrets.ALL_REPO_PAT }}
+        path: supertokens-backend-website
+
+    - run: |
+        shopt -s extglob # Enable extended globbing
+
+        pythonDocDir=supertokens-backend-website/app/docs/sdk/docs/python/
+
+        # Delete the current version folder if it exists
+        rm -rf $pythonDocDir/${{ needs.setup.outputs.versionFolder }}
+        # Copy the current docs
+        mkdir -p $pythonDocDir/${{ needs.setup.outputs.versionFolder }}
+        cp -r supertokens-python/html/* $pythonDocDir/${{ needs.setup.outputs.versionFolder }}
+
+        if [[ "true" == "true" ]]
+        then
+            # Delete everything except the version folders
+            rm -rf $pythonDocDir/!(*.*.X)
+
+            # Copy files to the root dir
+            # cp -r supertokens-python/html/* $pythonDocDir/
+
+            ln -s $pythonDocDir/${{ needs.setup.outputs.versionFolder }}/index.html $pythonDocDir/index.html
+        fi
+
+    - uses: actions/upload-artifact@v4
+      with:
+        name: ${{ needs.setup.outputs.artifactName }}
+        path: supertokens-backend-website/app/docs/sdk/docs/python
+
+    # - uses: actions/upload-artifact@v4
+    #   with:
+    #     name: ${{ needs.setup.outputs.artifactName }}
+    #     path: html/supertokens_python
+
+    - name: Trigger the backend website CI
+      uses: actions/github-script@v7
+      with:
+        # NOTE: We should use a better scoped PAT here.
+        github-token: ${{ secrets.ALL_REPO_PAT }}
+        script: |
+            github.rest.actions.createWorkflowDispatch({
+                owner: 'supertokens',
+                repo: 'supertokens-backend-website',
+                workflow_id: 'release-python-documentation-changes.yml',
+                ref: 'feat/python-node-docs',
+                inputs: {
+                  "version": `${{ needs.setup.outputs.setupVersion }}`,
+                  "artifact-name": `${{ needs.setup.outputs.artifactName }}`,
+                  "version-folder": `app/docs/sdk/docs/python`,
+                  "is-latest": `${{ inputs.is-latest }}`,
+                  "run-id": `${{ github.run_id }}`,
+                  "stage":  "preview",
+                }
+            })