publish-api-and-stubs.yml

name: publish-api-and-stubs

on:
  schedule:
    - cron: "0 1 * * *" # Run at 1 AM UTC
  
  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:
  
permissions:
  contents: read

env:
  PYTHON_VERSION: "3.11"

jobs:
  build:
    name: Build UPBGE
    runs-on: ubuntu-22.04

    steps:
    - name: Setup APT
      run: |
        sudo curl https://raw.githubusercontent.com/UPBGE/upbge/master/.github/workflows/01lunar.list \
          -o /etc/apt/sources.list.d/01lunar.list && \
        sudo curl https://raw.githubusercontent.com/UPBGE/upbge/master/.github/workflows/01ubuntu \
          -o /etc/apt/apt.conf.d/01ubuntu
    # We downgrade libgbm1 & libglapi-mesa to fix libegl-mesa0 installation
    - name: Install Tools
      run: | 
        sudo apt update && \
        sudo apt dist-upgrade && \
        sudo apt --allow-downgrades install libgbm1=23.0.4-0ubuntu1~23.04.1 && \
        sudo apt --allow-downgrades install libglapi-mesa=23.0.4-0ubuntu1~23.04.1 && \
        sudo apt install -y build-essential cmake libembree-dev libavutil-dev \
          libxi-dev libxxf86vm-dev libboost-dev libboost-locale-dev libgl1-mesa-dev \
          libavformat-dev libswscale-dev libavdevice-dev libblas3 libopenimageio-dev \
          libzstd-dev libopenimageio-dev libfreetype-dev libepoxy-dev libdecor-0-dev

    - name: Install Python
      uses: actions/setup-python@v5
      with: 
        python-version: '${{env.PYTHON_VERSION}}'

    - name: Install Python Dependencies
      run: | 
        curl https://bootstrap.pypa.io/get-pip.py | python && \
        python -m pip install numpy requests cython

    - name: Setup Python Path
      run: |
        sudo sh -c "echo '$pythonLocation/lib' >> /etc/ld.so.conf.d/python.conf" && \
        sudo ldconfig

    - name: Checkout sources
      uses: actions/checkout@v3
      with:
        repository: "UPBGE/upbge"
        ref: "master"
        path: "upbge"

    - name: Checkout addons
      uses: actions/checkout@v3
      with:
        repository: "UPBGE/blender-addons"
        ref: "master"
        path: "blender-addons"

    - name: Checkout addons-contrib
      run: git clone --depth=1 https://projects.blender.org/blender/blender-addons-contrib.git

    - name: Checkout translations
      run: git clone --depth=1 https://projects.blender.org/blender/blender-translations.git

    - name: Checkout dev-tools
      run: git clone --depth=1 https://projects.blender.org/blender/blender-dev-tools.git

    - name: Configure CMake
      run: |
        cmake -S upbge -B build \
                 -C upbge/build_files/cmake/config/blender_release.cmake \
                 -DWITH_GAMEENGINE=ON \
                 -DWITH_PLAYER=OFF \
                 -DCMAKE_BUILD_TYPE=Release \
                 -DWITH_INSTALL_PORTABLE=ON \
                 -DWITH_MOD_OCEANSIM=OFF \
                 -DWITH_CYCLES=OFF \
                 -DWITH_LIBMV=OFF \
                 -DWITH_LIBMV_SCHUR_SPECIALIZATIONS=OFF \
                 -DWITH_HYDRA=OFF \
                 -DWITH_VULKAN_BACKEND=OFF \
                 -DWITH_GHOST_WAYLAND=OFF \
                 -DPYTHON_VERSION=${{env.PYTHON_VERSION}}

    - name: Build UPBGE
      run:  make -C build -j `nproc`

    - name: Copy Release Scripts
      run: make -C build install

    - name: Archive Build
      if: ${{ !env.ACT }}
      run: tar zcvf build.tar.gz build

    - name: Upload Build
      if: ${{ !env.ACT }}
      uses: actions/upload-artifact@v3
      with:
        name: blender
        path: build.tar.gz
        retention-days: 3

  publish_api:
    name: Publish API Documentation
    runs-on: ubuntu-22.04
    needs: [build]

    steps:
    - name: Download Build
      if: ${{ !env.ACT }}
      uses: actions/download-artifact@v3
      with:
        name: blender

    - name: Extract Build
      if: ${{ !env.ACT }}
      run: tar zxvf build.tar.gz

    - name: Setup APT
      run: |
        sudo curl https://raw.githubusercontent.com/UPBGE/upbge/master/.github/workflows/01lunar.list \
          -o /etc/apt/sources.list.d/01lunar.list && \
        sudo curl https://raw.githubusercontent.com/UPBGE/upbge/master/.github/workflows/01ubuntu \
          -o /etc/apt/apt.conf.d/01ubuntu

    - name: Install Tools
      run: | 
        sudo apt update && \
        sudo apt dist-upgrade && \
        sudo apt install -y libxi6 libxxf86vm1 libxfixes3 libgl1 libtbb12 libavutil57 \
          libavformat59 libavdevice59 libboost-locale1.74.0 libopenimageio-dev

    - name: Install Python
      uses: actions/setup-python@v5
      with: 
        python-version: '${{env.PYTHON_VERSION}}'

    - name: Install Python Dependencies
      run: | 
        curl https://bootstrap.pypa.io/get-pip.py | python && \
        python -m pip install sphinx sphinx-rtd-theme yapf tqdm numpy

    - name: Setup Python Path
      run: |
        sudo sh -c "echo '$pythonLocation/lib' >> /etc/ld.so.conf.d/python.conf" && \
        sudo ldconfig

    - name: Checkout sources
      uses: actions/checkout@v3
      with:
        repository: "UPBGE/upbge"
        ref: "master"
        path: "upbge"

    - name: Prepare API Documentation
      working-directory: build
      run: | 
        rm -Rf bin/4.0/python && \
        bin/blender --python-use-system-env --background -noaudio --factory-startup \
                    --python ../upbge/doc/python_api/sphinx_doc_gen.py -- \
                    --output "${{ github.workspace }}/python_api"

    - name: Build API Documentation
      working-directory: python_api
      run: |
        sphinx-build -b html -j auto sphinx-in upbge-api-reference && \
        rm -Rf upbge-api-reference/.doctrees && \
        zip -r upbge-api-reference/upbge-api-reference.zip upbge-api-reference

    - name: Publish to UPBGE
      uses: peaceiris/actions-gh-pages@v3
      with:
        external_repository: UPBGE/UPBGE-API
        publish_branch: master
        publish_dir: python_api/upbge-api-reference
        deploy_key: ${{ secrets.APIDOCS_DEPLOY_KEY }}

    - name: Archive Documents
      if: ${{ !env.ACT }}
      run: tar zcvf apidocs.tar.gz python_api

    - name: Upload Documents
      if: ${{ !env.ACT }}
      uses: actions/upload-artifact@v3
      with:
        name: apidocs
        path: apidocs.tar.gz
        retention-days: 3

  publish_stubs:
    name: Publish API Stubs
    runs-on: ubuntu-22.04
    needs: [publish_api]

    steps:
    - name: Download Build
      if: ${{ !env.ACT }}
      uses: actions/download-artifact@v3
      with:
        name: blender

    - name: Extract Build
      if: ${{ !env.ACT }}
      run: tar zxvf build.tar.gz

    - name: Download Documents
      if: ${{ !env.ACT }}
      uses: actions/download-artifact@v3
      with:
        name: apidocs

    - name: Extract Documents
      if: ${{ !env.ACT }}
      run: tar zxvf apidocs.tar.gz

    - name: Install Python
      uses: actions/setup-python@v5
      with: 
        python-version: '${{env.PYTHON_VERSION}}'

    - name: Install Python Dependencies
      run: | 
        curl https://bootstrap.pypa.io/get-pip.py | python && \
        python -m pip install bpystubgen

    - name: Build API Stubs
      working-directory: python_api
      run: |
        python -m bpystubgen --quiet sphinx-in upbge-stub && \
        curl https://raw.githubusercontent.com/mysticfall/bpystubgen/main/package/setup.py -o upbge-stub/setup.py && \
        curl https://raw.githubusercontent.com/mysticfall/bpystubgen/main/package/README.md -o upbge-stub/README.md

    - name: Build Python Package
      working-directory: python_api/upbge-stub
      run: |
        sed -i "s/#APP_NAME#/upbge/g" setup.py && \
        sed -i "s/#APP_VERSION#/0.3.1/g" setup.py && \
        sed -i "s/#BUILD_NUMBER#/${{ github.run_id }}/g" setup.py && \
        python setup.py sdist

    - name: Publish to PyPI
      uses: pypa/gh-action-pypi-publish@release/v1
      with:
        password: ${{ secrets.PYPI_TOKEN }}
        packages-dir: python_api/upbge-stub/dist
        skip-existing: true