ci.yml

name: ci
on:
  pull_request:
  push:
    branches:
    - master
  schedule:
  - cron: '00 01 * * *'

# The section is needed to drop write-all permissions that are granted on
# `schedule` event. By specifying any permission explicitly all others are set
# to none. By using the principle of least privilege the damage a compromised
# workflow can do (because of an injection or compromised third party tool or
# action) is restricted. Currently, the workflow doesn't need any additional
# permission except for pulling the code. Adding labels to issues, commenting
# on pull-requests, etc. may need additional permissions:
#
# Syntax for this section:
# https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#permissions
#
# Reference for how to assign permissions on a job-by-job basis:
# https://docs.github.com/en/actions/using-jobs/assigning-permissions-to-jobs
#
# Reference for available permissions that we can enable if needed:
# https://docs.github.com/en/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token
permissions:
  # to fetch code (actions/checkout)
  contents: read

jobs:
  # This job does our basic build+test for supported platforms.
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        include:
        - build: stable
          os: ubuntu-latest
          rust: stable
        - build: beta
          os: ubuntu-latest
          rust: beta
        - build: nightly
          os: ubuntu-latest
          rust: nightly
        - build: macos
          os: macos-latest
          rust: stable
        - build: win-msvc
          os: windows-latest
          rust: stable
        - build: win-gnu
          os: windows-latest
          rust: stable-x86_64-gnu
    steps:
    - name: Checkout repository
      uses: actions/checkout@v5
    - name: Install Rust
      uses: dtolnay/rust-toolchain@master
      with:
        toolchain: ${{ matrix.rust }}
    - name: Show CPU info for debugging
      if: matrix.os == 'ubuntu-latest'
      run: lscpu
    - name: Basic build
      run: cargo build --verbose
    - name: Build docs
      run: cargo doc --verbose
    - name: Run subset of tests
      run: cargo test --verbose --test integration
    - name: Build regex-syntax docs
      run: cargo doc --verbose -p regex-syntax
    - name: Run subset of regex-syntax tests
      run: cargo test --verbose -p regex-syntax
    - name: Build regex-automata docs
      run: cargo doc --verbose -p regex-automata
    - name: Run subset of regex-automata tests
      if: matrix.build != 'win-gnu'  # Just horrifically slow.
      run: cargo test --verbose -p regex-automata
    - name: Run regex-lite tests
      run: cargo test --verbose -p regex-lite
    - name: Run regex-cli tests
      run: cargo test --verbose -p regex-cli

  # This job runs tests on cross compiled targets.
  #
  # We used to just have one test and do the same thing on normal targets and
  # cross targets, but cross tests can take an obscenely long time. Especially
  # the doc tests, where each one is compiled individually. (We haven't moved
  # to Rust 2024 yet.)
  cross:
    env:
      # Bump this as appropriate. We pin to a version to make sure CI
      # continues to work as cross releases in the past have broken things
      # in subtle ways.
      CROSS_VERSION: v0.2.5
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        target:
        - i686-unknown-linux-gnu
        - aarch64-unknown-linux-gnu
        - powerpc-unknown-linux-gnu
        - powerpc64-unknown-linux-gnu
        - s390x-unknown-linux-gnu
    steps:
    - name: Checkout repository
      uses: actions/checkout@v5
    - name: Install and configure Cross
      run: |
        # In the past, new releases of 'cross' have broken CI. So for now, we
        # pin it. We also use their pre-compiled binary releases because cross
        # has over 100 dependencies and takes a bit to compile.
        dir="$RUNNER_TEMP/cross-download"
        mkdir "$dir"
        echo "$dir" >> $GITHUB_PATH
        cd "$dir"
        curl -LO "https://github.com/cross-rs/cross/releases/download/$CROSS_VERSION/cross-x86_64-unknown-linux-musl.tar.gz"
        tar xf cross-x86_64-unknown-linux-musl.tar.gz
    - name: Basic build
      run: cross build --all --verbose --target ${{ matrix.target }}
    - name: Run subset of tests
      run: cross test --verbose --test integration --target ${{ matrix.target }}
    - name: Run subset of regex-syntax tests
      run: cross test --verbose -p regex-syntax --lib --target ${{ matrix.target }}
    - name: Run subset of regex-automata tests
      run: cross test --verbose -p regex-automata --lib --target ${{ matrix.target }}
    - name: Run regex-lite tests
      run: cross test --verbose -p regex-lite --lib --target ${{ matrix.target }}

  # This job runs a stripped down version of CI to test the MSRV. The specific
  # reason for doing this is that the regex crate's dev-dependencies tend to
  # evolve more quickly. There isn't as tight of a control on them because,
  # well, they're only used in tests and their MSRV doesn't matter as much.
  #
  # It is a bit unfortunate that our MSRV test is basically just "build it"
  # and pass if that works. But usually MSRV is broken by compilation problems
  # and not runtime behavior. So this is in practice good enough.
  msrv:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout repository
      uses: actions/checkout@v5
    - name: Install Rust
      uses: dtolnay/rust-toolchain@master
      with:
        toolchain: 1.65.0
    - name: Basic build
      run: cargo build --verbose
    - name: Build docs
      run: cargo doc --verbose

  # This job checks the docsrs configuration.
  #
  # This is important because we enable `doc_cfg`, which is an unstable
  # feature that can (and has) broken.
  docsrs:
    runs-on: ubuntu-latest
    env:
      RUSTDOCFLAGS: "-D rustdoc::broken_intra_doc_links --cfg docsrs_regex"
    steps:
    - name: Checkout repository
      uses: actions/checkout@v5
    - name: Install Rust
      uses: dtolnay/rust-toolchain@master
      with:
        toolchain: nightly
    - name: Build docs
      run: cargo doc --verbose --workspace --all-features

  # This job runs many more tests for the regex crate proper. Basically,
  # it repeats the same test suite for a bunch of different crate feature
  # combinations. There are so many features that exhaustive testing isn't
  # really possible, but we cover as much as is feasible.
  #
  # If there is a feature combo that should be tested but isn't, you'll want to
  # add it to the appropriate 'test' script in this repo.
  testfull-regex:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout repository
      uses: actions/checkout@v5
    - name: Install Rust
      uses: dtolnay/rust-toolchain@master
      with:
        toolchain: stable
    - name: Run full test suite
      run: ./test

  # Same as above, but for regex-automata, which has even more crate features!
  testfull-regex-automata:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout repository
      uses: actions/checkout@v5
    - name: Install Rust
      uses: dtolnay/rust-toolchain@master
      with:
        toolchain: stable
    - name: Run full test suite
      run: ./regex-automata/test

  # Same as above, but for regex-syntax.
  testfull-regex-syntax:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout repository
      uses: actions/checkout@v5
    - name: Install Rust
      uses: dtolnay/rust-toolchain@master
      with:
        toolchain: stable
    - name: Run full test suite
      run: ./regex-syntax/test

  # Same as above, but for regex-capi.
  testfull-regex-capi:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout repository
      uses: actions/checkout@v5
    - name: Install Rust
      uses: dtolnay/rust-toolchain@master
      with:
        toolchain: stable
    - name: Run full test suite
      run: ./regex-capi/test

  # Runs miri on regex-automata's test suite. This doesn't quite cover
  # everything. Many tests are disabled when building with miri because of
  # how slow miri runs. But it still gives us decent coverage.
  miri-regex-automata:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout repository
      uses: actions/checkout@v5
    - name: Install Rust
      uses: dtolnay/rust-toolchain@master
      with:
        # We use nightly here so that we can use miri I guess?
        # It caught me by surprise that miri seems to only be
        # available on nightly.
        toolchain: nightly
        components: miri
    - name: Run full test suite
      run: cargo miri test -p regex-automata

  # Tests that everything is formatted correctly.
  rustfmt:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout repository
      uses: actions/checkout@v5
    - name: Install Rust
      uses: dtolnay/rust-toolchain@master
      with:
        toolchain: stable
        components: rustfmt
    - name: Check formatting
      run: |
        cargo fmt --all -- --check