docs.yml

name: docs
on:
  push:
    branches: [main]
jobs:
  build-and-deploy:
    concurrency: ci-${{ github.ref }}
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
      - name: Set up Python
        uses: actions/setup-python@v4.7.0
        with:
          python-version: "3.x"
      - name: Install Poetry
        uses: snok/install-poetry@v1.3
        with:
          virtualenvs-create: true
          virtualenvs-in-project: true
      - name: Set up cache
        id: cached-poetry-dependencies
        uses: actions/cache@v3.3.1
        with:
          path: .venv
          key: venv-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}
      - name: Install dependencies
        run: poetry install --extras "all"
        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
      - name: Autogenerate reference documentation
        run: |
          source .venv/bin/activate
          python docs/.vitepress/pydocgen.py
      - name: Install vitepress
        uses: bahmutov/npm-install@v1.8.34
      - name: Build
        run: |
          /home/runner/work/machinable/machinable/node_modules/vitepress/bin/vitepress.js build docs
          cp -r docs/.vitepress/public/* docs/.vitepress/dist/
          cp -r docs/logo docs/.vitepress/dist/
      - name: Deploy
        uses: JamesIves/github-pages-deploy-action@v4.4.3
        with:
          branch: gh-pages
          folder: docs/.vitepress/dist