docs.yml

name: github pages

on:
  push:
    branches:
      - main

jobs:
  api-docs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Cache choosenim
        id: cache-choosenim
        uses: actions/cache@v4
        with:
          path: ~/.choosenim
          key: ${{ runner.os }}-choosenim-stable

      - name: Cache nimble
        id: cache-nimble
        uses: actions/cache@v4
        with:
          path: ~/.nimble
          key: ${{ runner.os }}-nimble-${{ hashFiles('nimword.nimble') }}
          restore-keys: |
            ${{ runner.os }}-nimble-

      - name: Setup nim
        uses: jiro4989/setup-nim-action@v2
        with:
          nim-version: devel

      - name: Install Packages
        run: nimble install -y

      - name: Build API docs
        run: nimble --verbose apis

      - name: Archive API docs
        uses: actions/upload-artifact@v4
        with:
          name: api-docs
          path: |
            docs/apidocs

  deploy-docs:
    needs:
      - api-docs
    runs-on: ubuntu-latest
    steps:
      - name: Download all docs
        uses: actions/download-artifact@v4

      - name: Check files
        run: |
          find .

      - name: Setup docs
        run: |
          mv api-docs docs/

      - name: Deploy
        if: success()
        uses: crazy-max/ghaction-github-pages@v4.1.0
        with:
          target_branch: gh-pages
          build_dir: ./docs
        env:
          GITHUB_TOKEN: ${{ secrets.TOKEN }}