Skip to content

Update Python API Docs #35

Update Python API Docs

Update Python API Docs #35

name: Update Python API Docs
# Run when the Python API changes or every month so that the artifact does not expire
on:
push:
branches:
- main
paths:
- onnxruntime/python/**
- docs/python/**
schedule:
- cron: '0 0 1,15 * *'
workflow_dispatch:
concurrency:
group: "apidocs-python"
cancel-in-progress: true
permissions:
contents: write
jobs:
build:
name: Generate Python API docs
runs-on: ["self-hosted", "1ES.Pool=onnxruntime-github-Ubuntu2204-AMD-CPU"]
steps:
- uses: actions/checkout@v4
- name: Install tools
run: |
sudo apt-get update
sudo apt-get install python3-pip
sudo apt-get install graphviz
- name: Install dependencies
run: |
python3 -m pip install --user --upgrade pip
cd docs/python
python3 -m pip install --user -r requirements.txt
python3 -m pip install --user --pre onnxruntime-training -f https://download.onnxruntime.ai/onnxruntime_nightly_cpu.html
python3 -m pip list
- name: Generate Python docs with Sphinx
run: |
cd tools/doc
./builddoc.sh /usr/bin ../.. ../../build
- name: Log source commit
run: git rev-parse --short HEAD > build/docs/html/source-version.txt
- name: Move Python docs into site
run: |
rm -rf _site/docs/api/python
mkdir -p _site/docs/api/
mv build/docs/html _site/docs/api/python
- name: Upload docs artifact
uses: actions/upload-artifact@v4
with:
name: onnxruntime-python-apidocs
path: _site
retention-days: 30