Create Stub Files: Scripts & CI

.github/update_stub.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+#
+# Copyright 2021-2023 The AMReX Community
+#
+# This script updates the .pyi stub files for documentation and interactive use.
+# To run this script, pyAMReX needs to be installed (all dimensions) and importable.
+#
+# Authors: Axel Huebl
+# License: BSD-3-Clause-LBNL
+#
+
+# we are in the source directory, .github/
+this_dir=$(cd $(dirname $0) && pwd)
+
+pybind11-stubgen --ignore-all-errors -o ${this_dir}/../src/amrex/ amrex.space1d
+pybind11-stubgen --ignore-all-errors -o ${this_dir}/../src/amrex/ amrex.space2d
+pybind11-stubgen --ignore-all-errors -o ${this_dir}/../src/amrex/ amrex.space3d

.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: 👑 CI
+
+# This workflow updates the .pyi stub files for documentation and interactive use.
+
+on: [push, pull_request]
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.head_ref }}-ci
+  cancel-in-progress: true
+
+jobs:
+  stubs:
+    name: 🔄 Update Stub Files
+    uses: ./.github/workflows/stubs.yml
+  ubuntu:
+    name: 🐧 Ubuntu
+    needs: stubs
+    uses: ./.github/workflows/ubuntu.yml
+  intel:
+    name: 🐧 Intel
+    needs: stubs
+    uses: ./.github/workflows/intel.yml
+  hip:
+    name: 🐧 HIP
+    needs: stubs
+    uses: ./.github/workflows/hip.yml
+  macos:
+    name: 🍏 macOS
+    needs: stubs
+    uses: ./.github/workflows/macos.yml
+  windows:
+    name: 🪟 Windows
+    needs: stubs
+    uses: ./.github/workflows/windows.yml

.github/workflows/hip.yml

@@ -1,6 +1,6 @@
 name: 🐧 HIP
 
-on: [push, pull_request]
+on: [workflow_call]
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-hip

.github/workflows/intel.yml

@@ -1,6 +1,6 @@
 name: 🐧 Intel
 
-on: [push, pull_request]
+on: [workflow_call]
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-intel

.github/workflows/macos.yml

@@ -1,6 +1,6 @@
 name: 🍏 macOS
 
-on: [push, pull_request]
+on: [workflow_call]
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-macos

.github/workflows/stubs.yml

@@ -0,0 +1,56 @@
+name: 🔄 Update Stub Files
+
+# This workflow updates the .pyi stub files for documentation and interactive use.
+
+on: [workflow_call]
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.head_ref }}-stubs
+  cancel-in-progress: true
+
+jobs:
+  # Build and install libamrex as AMReX CMake project
+  stubs:
+    name: Stubs
+    runs-on: ubuntu-22.04
+    env:
+      CC: gcc
+      CXX: g++
+      CXXFLAGS: "-O1"
+      OMP_NUM_THREAD: 2
+    if: github.event.pull_request.draft == false
+    steps:
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      name: Install Python
+      with:
+        python-version: '3.9'
+    - name: Dependencies
+      run: .github/workflows/dependencies/dependencies_gcc10.sh
+    - name: Build & Install
+      run: |
+        python3 -m pip install -U pip setuptools wheel
+        python3 -m pip install -U pip mpi4py pytest pybind11-stubgen pre-commit
+        cmake -S . -B build -DAMReX_SPACEDIM="1;2;3"
+        cmake --build build -j 2 --target pip_install
+
+    - name: Update Stubs
+      run: |
+        .github/update_stub.sh
+
+    - name: Run pre-commit cleanup
+      run: |
+        pre-commit run -a
+
+    - name: Update Install
+      run: |
+        cmake --build build -j 2 --target pip_install
+
+    - name: Unit tests
+      run: |
+        mpiexec -np 1 python3 -m pytest tests/
+
+    - uses: stefanzweifel/git-auto-commit-action@v4
+      name: Commit Updated Stub Files
+      with:
+        commit_message: Update Stub Files

.github/workflows/ubuntu.yml

@@ -1,6 +1,6 @@
 name: 🐧 Ubuntu
 
-on: [push, pull_request]
+on: [workflow_call]
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-linux

.github/workflows/windows.yml

@@ -1,6 +1,6 @@
 name: 🪟 Windows
 
-on: [push, pull_request]
+on: [workflow_call]
 
 concurrency:
   group: ${{ github.ref }}-${{ github.head_ref }}-windows