Spawn local without attribute #2956
Workflow file for this run
This file contains hidden or 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: Build | |
| on: | |
| merge_group: | |
| pull_request: | |
| push: | |
| branches: | |
| - master | |
| schedule: | |
| - cron: '0 18 * * TUE' # Run every Tuesday before the meeting | |
| env: | |
| CARGO_TERM_COLOR: always | |
| DEV_VERSION: 2 | |
| STABLE_VERSION: 2 | |
| OLDSTABLE_VERSION: 1 | |
| OLDOLDSTABLE_VERSION: 0.5 | |
| OLDOLDOLDSTABLE_VERSION: 0.4 | |
| QEMU_VERSION: 9.2.2 | |
| QEMU_ESP: qemu_esp | |
| QEMU_ESP_URL: https://github.com/espressif/qemu/releases/download/esp-develop-9.2.2-20250817/qemu-riscv32-softmmu-esp_develop_9.2.2_20250817-x86_64-linux-gnu.tar.xz | |
| jobs: | |
| # Run cargo xtask format-check | |
| formatcheck: | |
| name: cargo fmt | |
| runs-on: ubuntu-24.04 | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Cache Dependencies | |
| uses: Swatinem/rust-cache@v2 | |
| - name: cargo xtask fmt | |
| run: cargo xtask --verbose fmt -c | |
| # Verify all examples, checks | |
| check-clippy: | |
| uses: ./.github/workflows/clippy-check-example.yml | |
| with: | |
| backend: ${{ matrix.input.backend }} | |
| platform: ${{ matrix.input.platform }} | |
| rustup-target: ${{ matrix.input.rustup-target }} | |
| example-args: ${{ matrix.input.example-args }} | |
| strategy: | |
| matrix: | |
| input: | |
| - backend: thumbv7 | |
| platform: lm3s6965 | |
| rustup-target: thumbv7m-none-eabi | |
| - backend: thumbv6 | |
| platform: lm3s6965 | |
| rustup-target: thumbv6m-none-eabi | |
| - backend: thumbv8-base | |
| platform: lm3s6965 | |
| rustup-target: thumbv8m.base-none-eabi | |
| example-args: --exampleexclude pool | |
| - backend: thumbv8-main | |
| platform: lm3s6965 | |
| rustup-target: thumbv8m.main-none-eabi | |
| - backend: riscv32-imc-clint | |
| platform: hifive1 | |
| rustup-target: riscv32imc-unknown-none-elf | |
| - backend: riscv32-imc-mecall | |
| platform: hifive1 | |
| rustup-target: riscv32imc-unknown-none-elf | |
| - backend: riscv-esp32-c3 | |
| platform: esp32-c3 | |
| rustup-target: riscv32imc-unknown-none-elf | |
| - backend: riscv-esp32-c6 | |
| platform: esp32-c6 | |
| rustup-target: riscv32imac-unknown-none-elf | |
| installqemu: | |
| name: Get ESP32 QEMU and cache it | |
| runs-on: ubuntu-24.04 | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Cache QEMU | |
| id: cache-qemu | |
| uses: actions/cache@v4 | |
| with: | |
| path: qemu-${{ env.QEMU_VERSION }}/build | |
| key: ${{ runner.OS }}-qemu-${{ env.QEMU_VERSION }} | |
| restore-keys: | | |
| ${{ runner.OS }}-qemu-${{ env.QEMU_VERSION }} | |
| ${{ runner.OS }}-qemu- | |
| - name: Download ESP32 QEMU | |
| if: steps.installqemu.outputs.cache-hit != 'true' | |
| run: wget "${{ env.QEMU_ESP_URL }}" --output-document=${{ env.QEMU_ESP}}.tar.xz | |
| - name: Extract ESP32 QEMU | |
| if: steps.installqemu.outputs.cache-hit != 'true' | |
| run: | | |
| mkdir -p qemu-${{ env.QEMU_VERSION }}/build/esp32 | |
| tar --strip-components=1 -xvJf ${{ env.QEMU_ESP }}.tar.xz -C qemu-${{ env.QEMU_VERSION }}/build/esp32 qemu | |
| - name: Archive QEMU | |
| run: | | |
| cd qemu-${{ env.QEMU_VERSION }}/build | |
| tar -cf $GITHUB_WORKSPACE/qemu.tar * | |
| - name: Store QEMU | |
| uses: actions/upload-artifact@v5 | |
| with: | |
| name: qemu | |
| path: qemu.tar | |
| # Verify the example output with run-pass tests | |
| testexamples: | |
| name: QEMU run | |
| needs: installqemu | |
| runs-on: ubuntu-24.04 | |
| strategy: | |
| matrix: | |
| input: | |
| - backend: thumbv7 | |
| platform: lm3s6965 | |
| rustup-target: thumbv7m-none-eabi | |
| qemu-system: arm | |
| - backend: thumbv6 | |
| platform: lm3s6965 | |
| rustup-target: thumbv6m-none-eabi | |
| qemu-system: arm | |
| - backend: riscv32-imc-clint | |
| platform: hifive1 | |
| rustup-target: riscv32imc-unknown-none-elf | |
| qemu-system: riscv32 | |
| - backend: riscv32-imc-mecall | |
| platform: hifive1 | |
| rustup-target: riscv32imc-unknown-none-elf | |
| qemu-system: riscv32 | |
| # - backend: riscv-esp32-c3 | |
| # platform: esp32-c3 | |
| # rustup-target: riscv32imc-unknown-none-elf | |
| # qemu-system: riscv32 | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Configure Rust target ${{ matrix.input.rustup-target }} | |
| run: rustup target add ${{ matrix.input.rustup-target }} | |
| - name: Add Rust component llvm-tools-preview | |
| run: rustup component add llvm-tools-preview | |
| # Use precompiled binutils | |
| - name: Install cargo-binutils | |
| uses: taiki-e/install-action@v2 | |
| with: | |
| tool: cargo-binutils | |
| # Use precompiled if possible | |
| - name: Install espflash | |
| if: contains(matrix.input.platform, 'esp32') | |
| uses: taiki-e/install-action@v2 | |
| with: | |
| tool: espflash | |
| - name: Install esptool | |
| if: contains(matrix.input.platform, 'esp32') | |
| run: pip install esptool | |
| - name: Cache Dependencies | |
| uses: Swatinem/rust-cache@v2 | |
| - name: Install QEMU | |
| run: | | |
| sudo apt update | |
| sudo apt install -y qemu-system-${{ matrix.input.qemu-system }} | |
| - name: Download built QEMU | |
| if: contains(matrix.input.platform, 'esp32') | |
| uses: actions/download-artifact@v6 | |
| with: | |
| name: qemu | |
| - name: Extract QEMU into local path | |
| if: contains(matrix.input.platform, 'esp32') | |
| run: tar -xf qemu.tar -C /usr/local/bin | |
| - name: Extract ESP32 QEMU into local path | |
| if: contains(matrix.input.platform, 'esp32') | |
| run: sudo tar --strip-components=1 -xf qemu.tar -C /usr/local/ esp32/ | |
| - name: Check which QEMU is used | |
| run: | | |
| which qemu-system-${{ matrix.input.qemu-system }} | |
| - name: Run-pass tests | |
| run: cargo xtask --deny-warnings --platform ${{ matrix.input.platform }} --backend ${{ matrix.input.backend }} qemu | |
| # Run test suite | |
| tests: | |
| name: tests | |
| runs-on: ubuntu-24.04 | |
| strategy: | |
| fail-fast: false | |
| matrix: | |
| backend: | |
| - thumbv7 | |
| - thumbv6 | |
| - thumbv8-base | |
| - thumbv8-main | |
| package: | |
| - rtic | |
| - rtic-common | |
| - rtic-macros | |
| - rtic-monotonics | |
| - rtic-sync | |
| - rtic-time | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Cache Dependencies | |
| uses: Swatinem/rust-cache@v2 | |
| - name: Configure Rust target (v6, v7, v8.b v8.m) | |
| run: | | |
| rustup target add thumbv7m-none-eabi | |
| rustup target add thumbv6m-none-eabi | |
| rustup target add thumbv8m.base-none-eabi | |
| rustup target add thumbv8m.main-none-eabi | |
| - name: Run cargo test | |
| run: cargo xtask --deny-warnings --backend ${{ matrix.backend }} test ${{ matrix.package }} | |
| loom-tests: | |
| name: rtic-sync loom tests | |
| runs-on: ubuntu-24.04 | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Run cargo test | |
| run: cargo xtask --deny-warnings test --loom rtic-sync | |
| # Build documentation, check links | |
| docs: | |
| name: build docs | |
| runs-on: ubuntu-24.04 | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Install lychee | |
| uses: taiki-e/install-action@v2 | |
| with: | |
| tool: lychee | |
| - name: Build docs | |
| run: cargo xtask doc | |
| - name: Check links | |
| run: | | |
| td=$(mktemp -d) | |
| cp -r target/doc $td/api | |
| echo rtic | |
| lychee --offline --format detailed $td/api/rtic/ | |
| echo rtic_common | |
| lychee --offline --format detailed $td/api/rtic_common/ | |
| echo rtic_macros | |
| lychee --offline --format detailed $td/api/rtic_macros/ | |
| echo rtic_monotonics | |
| lychee --offline --format detailed $td/api/rtic_monotonics/ | |
| echo rtic_sync | |
| lychee --offline --format detailed $td/api/rtic_sync/ | |
| echo rtic_time | |
| lychee --offline --format detailed $td/api/rtic_time/ | |
| - name: Archive the API docs | |
| run: | | |
| cp -r target/doc apidocs | |
| tar -cf apidocs.tar apidocs | |
| - name: Store the API docs | |
| uses: actions/upload-artifact@v5 | |
| with: | |
| name: apidocs | |
| path: apidocs.tar | |
| # Build the books | |
| mdbook: | |
| name: build mdbook | |
| needs: docs | |
| runs-on: ubuntu-24.04 | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Install lychee | |
| uses: taiki-e/install-action@v2 | |
| with: | |
| tool: lychee | |
| - name: Install mdbook | |
| uses: taiki-e/install-action@v2 | |
| with: | |
| tool: mdbook | |
| - name: Install mdbook-mermaid | |
| uses: taiki-e/install-action@v2 | |
| with: | |
| tool: mdbook-mermaid | |
| - name: Build book in English | |
| run: cargo xtask book | |
| - name: Download built API docs | |
| uses: actions/download-artifact@v6 | |
| with: | |
| name: apidocs | |
| - name: Extract the API docs | |
| run: tar -xf apidocs.tar | |
| - name: Check links | |
| run: | | |
| td=$(mktemp -d) | |
| mkdir $td/book | |
| cp -r book/en/book $td/book/en | |
| cp LICENSE-* $td/book/en | |
| cp -r apidocs/ $td/api | |
| lychee --offline --format detailed $td/book/en/ | |
| mv $td bookroot | |
| - name: Archive the book + API docs | |
| run: | | |
| tar -cf book.tar bookroot | |
| - name: Store the Book + API docs | |
| uses: actions/upload-artifact@v5 | |
| with: | |
| name: book | |
| path: book.tar | |
| mdbookold: | |
| name: build docs and mdbook for older releases | |
| needs: pushtostablebranch | |
| runs-on: ubuntu-24.04 | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Install mdbook | |
| uses: taiki-e/install-action@v2 | |
| with: | |
| tool: mdbook | |
| - name: Install mdbook-mermaid | |
| uses: taiki-e/install-action@v2 | |
| with: | |
| tool: mdbook-mermaid | |
| - name: Remove cargo-config | |
| run: rm -f .cargo/config | |
| - name: Prepare output folder | |
| run: mkdir -p mdbookold | |
| - name: Fetch and build books for older versions | |
| run: | | |
| # The latest stable must be the first element in the array | |
| vers=( "${{ env.STABLE_VERSION }}" "${{ env.OLDSTABLE_VERSION }}" ) | |
| langs=( en ) | |
| root=$(pwd) | |
| webroot=$(pwd)/mdbookold | |
| for ver in ${vers[@]}; do | |
| mkdir -p src/$ver | |
| src=$root/src/$ver | |
| curl -L https://github.com/rtic-rs/rtic/archive/release/v${ver}.tar.gz | tar xz --strip-components 1 -C $src | |
| pushd $src | |
| rm -f .cargo/config | |
| # Version 1 and below uses cargo doc directly | |
| if [[ $ver -gt 1 ]] | |
| then | |
| # Version 2 and above | |
| cargo xtask doc | |
| else | |
| cargo doc || cargo doc --features timer-queue | |
| fi | |
| mkdir -p $webroot/$ver/book | |
| cp -r target/doc $webroot/$ver/api | |
| sed 's|URL|rtic/index.html|g' $root/redirect.html > $webroot/$ver/api/index.html | |
| popd | |
| for lang in ${langs[@]}; do | |
| cargo xtask book build $src/book/$lang | |
| cp -r $src/book/$lang/book $webroot/$ver/book/$lang | |
| cp LICENSE-* $webroot/$ver/book/$lang/ | |
| done | |
| # using master branch redirect file | |
| sed 's|URL|book/en|g' $root/redirect.html > $webroot/$ver/index.html | |
| rm -rf $src | |
| done | |
| - name: Archive the old books | |
| run: | | |
| tar -cf mdbookold.tar mdbookold | |
| - name: Store the old API docs | |
| uses: actions/upload-artifact@v5 | |
| with: | |
| name: mdbookold | |
| path: mdbookold.tar | |
| parseversion: | |
| name: Parse the master branch RTIC version | |
| runs-on: ubuntu-24.04 | |
| outputs: | |
| branch: ${{ steps.parseversion.outputs.branch }} | |
| versionmajor: ${{ steps.parseversion.outputs.versionmajor }} | |
| version: ${{ steps.parseversion.outputs.version }} | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Get crate version and print output branch release/vX | |
| id: parseversion | |
| # Parse metadata for version number, extract the Semver Major | |
| run: | | |
| VERSION=$(cargo metadata --format-version 1 --no-deps --offline | jq -r '.packages[] | select(.name =="rtic") | .version') | |
| VERSIONMAJOR=${VERSION%.*.*} | |
| echo "branch=release/v$VERSIONMAJOR" >> "$GITHUB_OUTPUT" | |
| echo "versionmajor=$VERSIONMAJOR" >> "$GITHUB_OUTPUT" | |
| echo "version=$VERSION" >> "$GITHUB_OUTPUT" | |
| # Update stable branch | |
| # | |
| # This is only valid when current stable resides in | |
| # master branch. | |
| # As master moves on to development, the work on the | |
| # stable version will happen in release/v"stable_version". | |
| # Thus, no need to push changes | |
| # | |
| # This needs to run before book is built, as bookbuilding fetches from the branch | |
| pushtostablebranch: | |
| name: Also push branch into release/vX when pushing to master | |
| runs-on: ubuntu-24.04 | |
| needs: | |
| - ci-success | |
| - parseversion | |
| env: | |
| branch: ${{ needs.parseversion.outputs.branch }} | |
| versionmajor: ${{ needs.parseversion.outputs.versionmajor }} | |
| version: ${{ needs.parseversion.outputs.version }} | |
| # Only run this when pushing to master branch | |
| if: github.ref == 'refs/heads/master' | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Push to stable release branch if master contains stable version | |
| if: ${{ env.versionmajor == env.STABLE_VERSION }} | |
| run: | | |
| # Get the full history of the branch leading up to current commit | |
| git fetch --unshallow | |
| # Make git aware of the release branch | |
| git fetch -u origin ${{ env.branch }} | |
| # Push the full history into the release branch | |
| git push -u origin master:${{ env.branch }} | |
| - name: Else case, master did not contain the stable version | |
| if: ${{ env.versionmajor != env.STABLE_VERSION }} | |
| run: echo "Master branch contains a development release, no git push performed" | |
| # Only runs when pushing to master branch | |
| # If all tests pass, then deploy stage is run | |
| deploy: | |
| name: deploy | |
| runs-on: ubuntu-24.04 | |
| needs: | |
| - pushtostablebranch | |
| - docs | |
| - mdbookold | |
| - mdbook | |
| # Only run this when pushing to master branch | |
| if: github.ref == 'refs/heads/master' | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Install lychee | |
| uses: taiki-e/install-action@v2 | |
| with: | |
| tool: lychee | |
| - name: Install mdbook-mermaid | |
| uses: taiki-e/install-action@v2 | |
| with: | |
| tool: mdbook-mermaid | |
| - name: mdBook Action | |
| uses: peaceiris/actions-mdbook@v2 | |
| with: | |
| mdbook-version: 'latest' | |
| - name: Remove cargo-config | |
| run: rm -f .cargo/config | |
| - name: Download built dev-ver book and API docs | |
| uses: actions/download-artifact@v6 | |
| with: | |
| name: book | |
| - name: Extract the dev-version book and API docs | |
| run: | | |
| tar -xf book.tar | |
| - name: Download built old versions of books and API docs | |
| uses: actions/download-artifact@v6 | |
| with: | |
| name: mdbookold | |
| - name: Extract the old version books and API docs | |
| run: | | |
| tar -xf mdbookold.tar | |
| - name: Prepare books | |
| shell: 'script --return --quiet --command "bash {0}"' | |
| run: | | |
| langs=( en ) | |
| devver=( dev ) | |
| # The latest stable must be the first element in the array | |
| vers=( "${{ env.STABLE_VERSION }}" "${{ env.OLDSTABLE_VERSION }}" ) | |
| # All releases start with "v" | |
| # followed by MAJOR.MINOR.PATCH, see semver.org | |
| # Store first in array as stable | |
| stable=${vers} | |
| crateversion=${{ env.versionmajor }} | |
| echo "Latest stable version: $stable" | |
| echo "Current crate version: $crateversion" | |
| # Create directories | |
| td=$(mktemp -d) | |
| mkdir -p $td/$devver/ | |
| cp -r bookroot/* $td/$devver/ | |
| # Redirect rtic.rs/meeting/index.html to hackmd | |
| mkdir $td/meeting | |
| sed "s|URL|https://hackmd.io/c_mFUZL-Q2C6614MlrrxOg|g" redirect.html > $td/meeting/index.html | |
| sed -i "s|Page Redirection|RTIC Meeting|" $td/meeting/index.html | |
| sed -i "s|If you|Redirecting to RTIC HackMD. If you|" $td/meeting/index.html | |
| # Redirect the main site to the stable release | |
| sed "s|URL|$stable|g" redirect.html > $td/index.html | |
| # Create the redirects for dev-version | |
| # If the current stable and the version being built differ, | |
| # then there is a dev-version and the links should point to it. | |
| if [[ "$stable" != "$crateversion" ]]; | |
| then | |
| sed 's|URL|rtic/index.html|g' redirect.html > $td/$devver/api/index.html | |
| sed 's|URL|book/en|g' redirect.html > $td/$devver/index.html | |
| else | |
| # If the current stable and the "dev" version in master branch | |
| # share the same major version, redirect dev/ to stable book | |
| # This makes sense, preferable to have doc/book updates going live directly to rtic.rs | |
| sed 's|URL|rtic.rs/$stable/api/rtic|g' redirect.html > $td/$devver/api/index.html | |
| sed 's|URL|rtic.rs/$stable|g' redirect.html > $td/$devver/index.html | |
| fi | |
| # Package older versions, including stable | |
| # Copy the stable book to the stable alias | |
| cp -r mdbookold/${{ env.STABLE_VERSION }} $td/stable | |
| # Copy the stable book to the webroot | |
| cp -r mdbookold/${{ env.STABLE_VERSION }} $td/ | |
| # Copy the old stable book to the webroot | |
| cp -r mdbookold/${{ env.OLDSTABLE_VERSION }} $td/ | |
| # Forward CNAME file | |
| cp CNAME $td/ | |
| mv $td/ bookstodeploy | |
| - name: Archive the webroot | |
| run: | | |
| tar -cf bookstodeploy.tar bookstodeploy | |
| - name: Store the books | |
| uses: actions/upload-artifact@v5 | |
| with: | |
| name: bookstodeploy | |
| path: bookstodeploy.tar | |
| ghapages: | |
| name: Publish rtic.rs | |
| runs-on: ubuntu-24.04 | |
| needs: | |
| - deploy | |
| steps: | |
| - name: Download books | |
| uses: actions/download-artifact@v6 | |
| with: | |
| name: bookstodeploy | |
| - name: Extract the books | |
| run: | | |
| tar -xf bookstodeploy.tar | |
| - name: Deploy to GH-pages | |
| uses: peaceiris/actions-gh-pages@v4 | |
| with: | |
| github_token: ${{ secrets.GITHUB_TOKEN }} | |
| publish_dir: ./bookstodeploy | |
| force_orphan: true | |
| # ALL THE PREVIOUS JOBS NEEDS TO BE ADDED TO THE `needs` SECTION OF THIS JOB! | |
| ci-success: | |
| name: ci | |
| if: success() | |
| needs: | |
| - formatcheck | |
| - check-clippy | |
| - testexamples | |
| - tests | |
| - loom-tests | |
| - docs | |
| - mdbook | |
| runs-on: ubuntu-24.04 | |
| steps: | |
| - name: Mark the job as a success | |
| run: exit 0 |