Add GitHub Actions workflow for VicUtils documentation

Author: Vic-Nas

.github/workflows/generate-vicutils-docs.yml

@@ -0,0 +1,40 @@
+name: Generate VicUtils Docs
+
+on:
+  push:
+    paths:
+      - 'vicutils/**/*.py'
+    branches:
+      - main
+
+jobs:
+  generate-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      
+      - name: Install pdoc
+        run: pip install pdoc3
+      
+      - name: Generate documentation
+        run: |
+          cd vicutils
+          for file in *.py; do
+            if [ "$file" != "__init__.py" ]; then
+              pdoc --html --force --output-dir . "${file%.py}"
+              # Move generated HTML to parent directory name
+              mv "${file%.py}"/index.html "${file%.py}.html" 2>/dev/null || true
+              rm -rf "${file%.py}"
+            fi
+          done
+      
+      - name: Commit and push if changes
+        run: |
+          git config user.name "Vic-Nas"
+          git config user.email "github-actions@github.com"
+          git add vicutils/*.html
+          git diff --quiet && git diff --staged --quiet || (git commit -m "Auto-generate VicUtils documentation" && git push)