ci-check-app.yml

name: App - Check

on:
  workflow_call:
    inputs:
      test-args:
        description: 'The arguments to pass to the test command'
        type: string
        default: '--all-features --lib --bins'
      test-suites:
        description: 'Extra test suites to run'
        type: string
        default: ''
      rust-toolchain:
        description: 'The Rust version to use'
        type: string
        default: 'stable'
      rust-toolchain-formatting:
        description: 'The Rust version to use to check formatting'
        type: string
        default: 'stable'
      rust-toolchain-udeps:
        description: 'The Rust version to use to run udeps'
        type: string
        default: 'nightly'
      check-udeps:
        description: Enable checking for unusued dependencies
        type: boolean
        default: true
      rust-backtrace:
        description: 'The Rust backtrace settings'
        type: string
        default: 'full'
      install-protoc:
        description: 'Install protoc before running tests'
        type: boolean
        default: true
      use-sccache:
        description: 'Run sccache-cache before running tests'
        type: boolean
        default: true
      use-postgresql:
        description: 'Run postgresql before running tests'
        type: boolean
        default: false
      test-env-vars:
        description: 'The environment variables to set for the tests'
        type: string
        default: ''
      run-label:
        description: 'The run label to use for the actions'
        type: string
        default: 'ubuntu-latest'
      rust-cache-prefix:
        description: 'Prefix for Rust cache key (bump to invalidate all caches)'
        type: string
        default: 'v0-rust'
      rust-cache-save:
        description: 'Whether to save the Rust cache (set to false for PRs to only restore from main)'
        type: boolean
        default: true

env:
  RUST_BACKTRACE: ${{ inputs.rust-backtrace }}

permissions:
  contents: read

jobs:
  clippy:
    name: Clippy
    runs-on: ${{ inputs.run-label }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
        with:
          token: ${{ secrets.PRIVATE_SUBMODULE_ACCESS_TOKEN || github.token }}
          submodules: recursive

      - name: Install Rust ${{ inputs.rust-toolchain }}
        uses: dtolnay/rust-toolchain@master
        with:
          toolchain: ${{ inputs.rust-toolchain }}
          components: clippy

      - name: Restore Cargo cache
        id: cache-restore
        uses: actions/cache/restore@v4
        with:
          path: |
            ~/.cargo/bin/
            ~/.cargo/registry/
            ~/.cargo/git/
            target/
          key: ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-clippy-${{ hashFiles('**/Cargo.lock') }}
          restore-keys: |
            ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-clippy-

      - name: Clean target if Cargo.lock changed
        if: steps.cache-restore.outputs.cache-hit != 'true'
        run: rm -rf target/

      - name: Install Protoc
        if: ${{ inputs.install-protoc == true }}
        uses: arduino/setup-protoc@v3
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}

      - name: Run sccache-cache
        if: ${{ inputs.use-sccache == true }}
        uses: mozilla-actions/sccache-action@v0.0.4

      - name: Clippy
        run: cargo clippy --workspace --all-features --all-targets -- -D warnings

      - name: Save Cargo cache
        if: ${{ inputs.rust-cache-save }}
        uses: actions/cache/save@v4
        with:
          path: |
            ~/.cargo/bin/
            ~/.cargo/registry/
            ~/.cargo/git/
            target/
          key: ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-clippy-${{ hashFiles('**/Cargo.lock') }}

  formatting:
    name: Formatting
    runs-on: ${{ inputs.run-label }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
        with:
          token: ${{ secrets.PRIVATE_SUBMODULE_ACCESS_TOKEN || github.token }}
          submodules: recursive
      - name: Install Rust ${{ inputs.rust-toolchain-formatting }}
        uses: dtolnay/rust-toolchain@master
        with:
          toolchain: ${{ inputs.rust-toolchain-formatting }}
          components: rustfmt

      - name: Restore Cargo cache
        id: cache-restore
        uses: actions/cache/restore@v4
        with:
          path: |
            ~/.cargo/bin/
            ~/.cargo/registry/
            ~/.cargo/git/
            target/
          key: ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-formatting-${{ hashFiles('**/Cargo.lock') }}
          restore-keys: |
            ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-formatting-

      - name: Clean target if Cargo.lock changed
        if: steps.cache-restore.outputs.cache-hit != 'true'
        run: rm -rf target/

      - name: Run sccache-cache
        if: ${{ inputs.use-sccache == true }}
        uses: mozilla-actions/sccache-action@v0.0.4

      - name: Check Formatting
        run: cargo fmt -- --check

      - name: Save Cargo cache
        if: ${{ inputs.rust-cache-save }}
        uses: actions/cache/save@v4
        with:
          path: |
            ~/.cargo/bin/
            ~/.cargo/registry/
            ~/.cargo/git/
            target/
          key: ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-formatting-${{ hashFiles('**/Cargo.lock') }}

  tests:
    name: Unit Tests
    runs-on: ${{ inputs.run-label }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
        with:
          token: ${{ secrets.PRIVATE_SUBMODULE_ACCESS_TOKEN || github.token }}
          submodules: recursive

      - name: Install Rust ${{ inputs.rust-toolchain }}
        uses: dtolnay/rust-toolchain@master
        with:
          toolchain: ${{ inputs.rust-toolchain }}

      - name: Restore Cargo cache
        id: cache-restore
        uses: actions/cache/restore@v4
        with:
          path: |
            ~/.cargo/bin/
            ~/.cargo/registry/
            ~/.cargo/git/
            target/
          key: ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-tests-${{ hashFiles('**/Cargo.lock') }}
          restore-keys: |
            ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-tests-

      - name: Clean target if Cargo.lock changed
        if: steps.cache-restore.outputs.cache-hit != 'true'
        run: rm -rf target/

      - name: Install Protoc
        if: ${{ inputs.install-protoc == true }}
        uses: arduino/setup-protoc@v3
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}

      - name: Run sccache-cache
        if: ${{ inputs.use-sccache == true }}
        uses: mozilla-actions/sccache-action@v0.0.4

      - name: Unit Tests
        run: cargo test ${{ inputs.test-args }}

      - name: Save Cargo cache
        if: ${{ inputs.rust-cache-save }}
        uses: actions/cache/save@v4
        with:
          path: |
            ~/.cargo/bin/
            ~/.cargo/registry/
            ~/.cargo/git/
            target/
          key: ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-tests-${{ hashFiles('**/Cargo.lock') }}

  tests-suites:
    name: Tests Suite "${{ matrix.element }}"
    if: (inputs.test-suites != '') && (inputs.test-suites != '[]')
    strategy:
      fail-fast: false
      matrix:
        element: ${{ fromJson(inputs.test-suites) }}
    runs-on: ${{ inputs.run-label }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
        with:
          token: ${{ secrets.PRIVATE_SUBMODULE_ACCESS_TOKEN || github.token }}
          submodules: recursive

      - name: Parse and export environment variables
        run: |
          echo '${{ inputs.test-env-vars }}' | jq -r "to_entries|map(\"\(.key)=\(.value|tostring)\")|.[]" >> $GITHUB_ENV

      - name: Run Postgresql
        if: ${{ inputs.use-postgresql == true }}
        uses: ikalnytskyi/action-setup-postgres@v5

      - name: Install Rust ${{ inputs.rust-toolchain }}
        uses: dtolnay/rust-toolchain@master
        with:
          toolchain: ${{ inputs.rust-toolchain }}

      - name: Restore Cargo cache
        id: cache-restore
        uses: actions/cache/restore@v4
        with:
          path: |
            ~/.cargo/bin/
            ~/.cargo/registry/
            ~/.cargo/git/
            target/
          key: ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-tests-suites-${{ hashFiles('**/Cargo.lock') }}
          restore-keys: |
            ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-tests-suites-

      - name: Clean target if Cargo.lock changed
        if: steps.cache-restore.outputs.cache-hit != 'true'
        run: rm -rf target/

      - name: Install Protoc
        if: ${{ inputs.install-protoc == true }}
        uses: arduino/setup-protoc@v3
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}

      - name: Run sccache-cache
        if: ${{ inputs.use-sccache == true }}
        uses: mozilla-actions/sccache-action@v0.0.4

      - name: Test Suite
        run: cargo test --test ${{ matrix.element }}

      - name: Save Cargo cache
        if: ${{ inputs.rust-cache-save }}
        uses: actions/cache/save@v4
        with:
          path: |
            ~/.cargo/bin/
            ~/.cargo/registry/
            ~/.cargo/git/
            target/
          key: ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-tests-suites-${{ hashFiles('**/Cargo.lock') }}

  unused-dependencies:
    name: Unused Dependencies
    runs-on: ${{ inputs.run-label }}
    if: ${{ inputs.check-udeps }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
        with:
          token: ${{ secrets.PRIVATE_SUBMODULE_ACCESS_TOKEN || github.token }}
          submodules: recursive

      - name: Install Rust ${{ inputs.rust-toolchain-udeps }}
        uses: dtolnay/rust-toolchain@master
        with:
          toolchain: ${{ inputs.rust-toolchain-udeps }}

      - name: Restore Cargo cache
        id: cache-restore
        uses: actions/cache/restore@v4
        with:
          path: |
            ~/.cargo/bin/
            ~/.cargo/registry/
            ~/.cargo/git/
            target/
          key: ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-unused-deps-${{ hashFiles('**/Cargo.lock') }}
          restore-keys: |
            ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-unused-deps-

      - name: Clean target if Cargo.lock changed
        if: steps.cache-restore.outputs.cache-hit != 'true'
        run: rm -rf target/

      - name: Run sccache-cache
        if: ${{ inputs.use-sccache == true }}
        uses: mozilla-actions/sccache-action@v0.0.4

      - name: Install cargo-udeps
        run: cargo install cargo-udeps@0.1.43 --locked

      - name: Check Dependencies
        run: cargo udeps --all-targets

      - name: Save Cargo cache
        if: ${{ inputs.rust-cache-save }}
        uses: actions/cache/save@v4
        with:
          path: |
            ~/.cargo/bin/
            ~/.cargo/registry/
            ~/.cargo/git/
            target/
          key: ${{ inputs.rust-cache-prefix }}-${{ runner.os }}-cargo-unused-deps-${{ hashFiles('**/Cargo.lock') }}

  license:
    name: Licenses
    runs-on: ${{ inputs.run-label }}
    steps:
      - uses: actions/checkout@v6
        with:
          token: ${{ secrets.PRIVATE_SUBMODULE_ACCESS_TOKEN || github.token }}
          submodules: recursive
      - uses: EmbarkStudios/cargo-deny-action@v2
        with:
          rust-version: ${{ inputs.rust-toolchain }}
          command: check license