Update Python API Docs #128
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 |