Skip to content
Build Docs

Build Docs #23

Sign in to view logs

Build Docs

Build Docs #23

Workflow file for this run

.github/workflows/build-docs.yml at a6430e8
# This workflow will upload a Python Package using Twine when a release is created
# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
# This workflow uses actions that are not certified by GitHub.
# They are provided by a third-party and are governed by
# separate terms of service, privacy policy, and support
# documentation.
name: Build Docs
on:
workflow_dispatch:
inputs:
package_dir:
required: true
type: string
package_name:
required: true
type: string
workflow_call:
inputs:
package_dir:
required: true
type: string
package_name:
required: true
type: string
secrets:
PYPI_API_TOKEN:
required: true
DOCS_DEPLOY_AWS_ACCESS_KEY:
required: true
DOCS_DEPLOY_AWS_API_SECRET:
required: true
permissions:
contents: read
jobs:
docs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
with:
submodules: recursive
- name: Install pdoc
run: python -m pip install --upgrade pdoc
- name: Install cibuildwheel
run: python -m pip install cibuildwheel
- name: Build Wheel
run: python -m cibuildwheel --output-dir dist --platform linux ./${{ inputs.package_dir }}
- name: List Dist
run: ls dist
- name: Install Wheel
run: python -m pip install dist/*.whl
- name: Build Docs
run: python -m pdoc ${{ inputs.package_name }} --docformat=google --output-dir docs
- name: S3 Upload
run: aws s3 cp docs/ s3://livekit-docs/${{ inputs.package_dir }} --recursive
env:
AWS_ACCESS_KEY_ID: ${{ secrets.DOCS_DEPLOY_AWS_ACCESS_KEY }}
AWS_SECRET_ACCESS_KEY: ${{ secrets.DOCS_DEPLOY_AWS_API_SECRET }}
AWS_DEFAULT_REGION: "us-east-1"