Skip to content

Started deployment after xames3's actions #13

Started deployment after xames3's actions

Started deployment after xames3's actions #13

Workflow file for this run

# TOPSTSCHOOL Sphinx (Documentation) Deployment Workflow
# ======================================================
#
# Author: Akshay Mestry <[email protected]>
# Created on: Sunday, October 27 2024
# Last updated on: Saturday, November 02 2024
name: deployment
run-name: Started ${{ github.workflow }} after ${{ github.actor }}'s actions
on:
workflow_dispatch:
pull_request:
paths:
- 'docs/**'
- 'requirements*'
permissions:
contents: write
env:
ARTIFACTNAME: topstschool-pages
BUILDDIR: docs/build/
SOURCEDIR: docs/source
PYTHONVERSION: 3.12.1
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
jobs:
lint:
name: lint
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871
with:
fetch-depth: 1
- name: Setup
uses: actions/setup-python@v5
with:
python-version: ${{ env.PYTHONVERSION }}
- name: Analyze
id: linting
run: |
python -m pip install -Uq pip -rrequirements-dev.txt
echo "Checking code for issues..."
flake8 ${{ env.SOURCEDIR }}
build:
name: build
needs: lint
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871
with:
fetch-depth: 1
- name: Setup
uses: actions/setup-python@v5
with:
python-version: ${{ env.PYTHONVERSION }}
- name: Build pages with Sphinx
id: build
run: |
python -m pip install -Uq pip -rrequirements.txt
echo "Building documentation pages..."
cd docs && make html
- name: Upload artifact
uses: actions/upload-pages-artifact@v3
with:
name: ${{ env.ARTIFACTNAME }}
path: ${{ env.BUILDDIR }}
deploy:
name: deploy
needs: [lint, build]
permissions:
contents: read
pages: write
id-token: write
environment:
name: canary
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
with:
artifact_name: ${{ env.ARTIFACTNAME }}