docs

Finish migration of `vars_funs` module for Python package #31

	on:
	workflow_dispatch:
	pull_request:
	branches: [main, master]
	push:
	branches: [main, master]

	name: docs

	env:
	PYTHONUNBUFFERED: "1"

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

	- name: Setup pandoc
	uses: r-lib/actions/setup-pandoc@v2

	- name: Setup R
	uses: r-lib/actions/setup-r@v2
	with:
	use-public-rspm: true

	- name: Setup R dependencies
	uses: r-lib/actions/setup-r-dependencies@v2
	with:
	extra-packages: any::pkgdown, local::.
	needs: website

	- name: Install uv
	uses: astral-sh/setup-uv@v4

	- name: Setup Python
	shell: bash
	working-directory: python
	run: uv venv

	- name: Install Python dependencies
	working-directory: python
	shell: bash
	run: uv pip install .[docs]

	- name: Build R docs
	run: pkgdown::build_site_github_pages(new_process = FALSE, install = FALSE)
	shell: Rscript {0}

	- name: Build Python docs
	run: uv run sphinx-build python/docs/source docs/python
	shell: bash

	- name: Configure pages
	uses: actions/configure-pages@v5

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

	deploy:
	if: contains(fromJSON('["main", "master"]'), github.ref_name) && github.event_name != 'pull_request'
	needs: build
	runs-on: ubuntu-latest
	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}
	permissions:
	pages: write
	id-token: write
	steps:
	- name: Deploy to GitHub Pages
	id: deployment
	uses: actions/deploy-pages@v4

Provide feedback