Workflow for ffi docs

Author: tqchen

.github/workflows/publish_tvm_ffi_docs.yml

@@ -0,0 +1,60 @@
+name: Publish tvm-ffi docs
+
+on:
+  workflow_dispatch:
+
+jobs:
+  build_wheels:
+    name: Build docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: astral-sh/setup-uv@v4
+
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          path: tvm-site
+
+      - name: Checkout tvm
+        uses: actions/checkout@v4
+        with:
+          repository: apache/tvm
+          submodules: recursive
+          path: tvm
+
+      - name: Install wheel and requirements
+        working-directory: tvm/ffi
+        run: |
+          pip install .
+          pip install -r docs/requirements.txt
+          pip install linkify-it-py
+
+      - name: Build docs
+        working-directory: tvm/ffi/docs
+        run: |
+          make html
+          python ../../../tvm-site/scripts/download_3rdparty_embeds.py -v --path=_build/html
+
+      - name: Deploy docs
+        working-directory: tvm-site
+        run: |
+          git fetch
+          git checkout -B asf-site origin/asf-site
+          git ls-tree HEAD ffi/ --name-only | grep -vP '^ffi/v\\d' | xargs rm -rf
+          cp -r ../tvm/ffi/docs/_build/html ffi
+          git config user.name tvm-bot
+          git config user.email [email protected]
+          git add ffi
+          git commit -m"deploying ffi docs" ffi
+          git status
+          for i in {1..3}; do
+            if git push origin asf-site; then
+              echo "Push successful"
+              break
+            else
+              echo "Push failed, retrying ($i)..."
+              sleep 2
+              git pull --rebase origin asf-site
+            fi
+          done
+

.github/workflows/update_asf_site.yml

@@ -0,0 +1,28 @@
+name: Build Jekyll Site
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.4
+          bundler-cache: true
+
+      - name: Install dependencies
+        run: |
+          bundle install
+
+      - name: Build website
+        run: |
+          ./scripts/task_deploy_asf_site.sh

scripts/download_3rdparty_embeds.py

@@ -310,5 +310,9 @@ def download_and_replace_urls(files: Optional[List[str]] = None, verbose: bool =
 if __name__ == "__main__":
     args = argparse.ArgumentParser()
     args.add_argument("-v", "--verbose", action="store_true")
+    args.add_argument("-p", "--path", type=str, default=None)
     args = args.parse_args()
+
+    if args.path is not None:
+        HTML_DIR = args.path
     download_and_replace_urls(verbose=args.verbose)

scripts/task_deploy_asf_site.sh

@@ -18,7 +18,13 @@ git ls-files | grep -v -e ^docs -e ^ffi | xargs  rm -rf
 cp .gitignore.bak .gitignore
 cp .asf.yaml.bak .asf.yaml
 
+if [ "$GITHUB_ACTIONS" = "true" ]; then
+  git config user.name tvm-bot
+  git config user.email [email protected]
+fi
+
 cp -rf _site/* .
+rm -rf _site
 DATE=`date`
 git add --all && git commit -am "Build at ${DATE}"
 git push origin asf-site