langgraph-redis/.github/workflows/docs.yml at main · redis-developer/langgraph-redis · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
name: Deploy Documentation

on:
  push:
    branches: [main]
  release:
    types: [published]
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: false

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Fetch all tags
        run: git fetch --tags

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: Install Poetry
        uses: snok/install-poetry@v1
        with:
          version: latest
          virtualenvs-create: true
          virtualenvs-in-project: true

      - name: Install project dependencies
        run: poetry install --all-extras

      - name: Install docs dependencies
        run: poetry run pip install -r docs/requirements.txt

      - name: Build versioned documentation
        run: |
          set -e
          OUTPUT_DIR="docs/_build/html"
          mkdir -p "$OUTPUT_DIR"

          # Tag regex: match v0.4.1+ and v1.0.0+ (v0.4.0 and earlier lack docs/)
          TAG_REGEX='^v0\.4\.([1-9][0-9]*)$|^v0\.([5-9]|[0-9]{2,})\.[0-9]+$|^v[1-9][0-9]*\.[0-9]+\.[0-9]+$'

          # Collect matching tags (newest first)
          TAGS=$(git tag --sort=-v:refname | grep -E "$TAG_REGEX" || true)

          # Track versions for versions.json
          VERSIONS_JSON='[]'
          LATEST_TAG=""

          # Build docs for each matching tag
          for tag in $TAGS; do
            echo "=== Building docs for tag: $tag ==="
            # Check if this tag has a docs/ directory
            if ! git ls-tree --name-only "$tag" -- docs/ > /dev/null 2>&1; then
              echo "    Skipping $tag (no docs/ directory)"
              continue
            fi

            git checkout "$tag" -- docs/ examples/ || git checkout "$tag" -- docs/
            poetry run python docs/copy_notebooks.py || true
            poetry run sphinx-build -b html docs "$OUTPUT_DIR/$tag"
            git checkout HEAD -- docs/ examples/ 2>/dev/null || git checkout HEAD -- docs/

            if [ -z "$LATEST_TAG" ]; then
              LATEST_TAG="$tag"
            fi
            VERSIONS_JSON=$(echo "$VERSIONS_JSON" | python3 -c "
          import json, sys
          v = json.load(sys.stdin)
          v.append({'name': '$tag', 'tag': True})
          print(json.dumps(v))")
          done

          # Build docs for main (current HEAD)
          echo "=== Building docs for main ==="
          git checkout HEAD -- docs/ examples/ 2>/dev/null || true
          poetry run python docs/copy_notebooks.py
          poetry run sphinx-build -b html docs "$OUTPUT_DIR/main"

          VERSIONS_JSON=$(echo "$VERSIONS_JSON" | python3 -c "
          import json, sys
          v = json.load(sys.stdin)
          v.append({'name': 'main', 'tag': False})
          print(json.dumps(v))")

          # Determine redirect target
          TARGET="${LATEST_TAG:-main}"

          # Write versions.json
          python3 -c "
          import json
          versions = json.loads('$VERSIONS_JSON')
          data = {'versions': versions, 'latest': '${LATEST_TAG}', 'current': ''}
          with open('$OUTPUT_DIR/versions.json', 'w') as f:
              json.dump(data, f, indent=2)
          "

          # Inject current version into each build's versions.json copy
          for dir in "$OUTPUT_DIR"/*/; do
            name=$(basename "$dir")
            cp "$OUTPUT_DIR/versions.json" "$dir/versions.json"
            python3 -c "
          import json
          with open('$dir/versions.json') as f:
              data = json.load(f)
          data['current'] = '$name'
          with open('$dir/versions.json', 'w') as f:
              json.dump(data, f, indent=2)
          "
          done

          # Create root redirect
          cat > "$OUTPUT_DIR/index.html" << REDIRECT_EOF
          <!DOCTYPE html>
          <html>
          <head>
            <meta charset="utf-8">
            <title>Redirecting...</title>
            <meta http-equiv="refresh" content="0; url=${TARGET}/index.html">
          </head>
          <body>
            <p>Redirecting to <a href="${TARGET}/index.html">latest documentation</a>...</p>
          </body>
          </html>
          REDIRECT_EOF

          echo "=== Build complete ==="
          echo "Versions built:"
          ls -d "$OUTPUT_DIR"/*/
          echo "Root redirects to: $TARGET"

      - name: Upload artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: docs/_build/html

  deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    needs: build
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4