docs: tweak doc wording and formatting (#4) #11
This file contains 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: Test | |
| # This is the main CI workflow that runs the test suite on all pushes to main and all pull requests. | |
| # It runs the following jobs: | |
| # - required: runs the test suite on ubuntu with stable and beta rust toolchains | |
| # - minimal: runs the test suite with the minimal versions of the dependencies that satisfy the | |
| # requirements of this crate, and its dependencies | |
| # - os-check: runs the test suite on mac and windows | |
| # - coverage: runs the test suite and collects coverage information | |
| # See check.yml for information about how the concurrency cancellation and workflow triggering works | |
| on: | |
| push: | |
| branches: | |
| - main | |
| pull_request: | |
| # ensure that the workflow is only triggered once per PR, subsequent pushes to the PR will cancel | |
| # and restart the workflow. See https://docs.github.com/en/actions/using-jobs/using-concurrency | |
| concurrency: | |
| group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }} | |
| cancel-in-progress: true | |
| jobs: | |
| required: | |
| runs-on: ubuntu-latest | |
| name: ubuntu (${{ matrix.toolchain }}) | |
| strategy: | |
| matrix: | |
| # run on stable and beta to ensure that tests won't break on the next version of the rust | |
| # toolchain | |
| toolchain: [stable, beta] | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Install Rust ${{ matrix.toolchain }} | |
| uses: dtolnay/rust-toolchain@master | |
| with: | |
| toolchain: ${{ matrix.toolchain }} | |
| # enable this ci template to run regardless of whether the lockfile is checked in or not | |
| - name: cargo generate-lockfile | |
| if: hashFiles('Cargo.lock') == '' | |
| run: cargo generate-lockfile | |
| - name: cargo test --locked | |
| run: cargo test --locked --all-features --all-targets | |
| - name: cargo test --doc | |
| run: cargo test --locked --all-features --doc | |
| minimal-versions: | |
| # This action chooses the oldest version of the dependencies permitted by Cargo.toml to ensure | |
| # that this crate is compatible with the minimal version that this crate and its dependencies | |
| # require. This will pickup issues where this create relies on functionality that was introduced | |
| # later than the actual version specified (e.g., when we choose just a major version, but a | |
| # method was added after this version). | |
| # | |
| # This particular check can be difficult to get to succeed as often transitive dependencies may | |
| # be incorrectly specified (e.g., a dependency specifies 1.0 but really requires 1.1.5). There | |
| # is an alternative flag available -Zdirect-minimal-versions that uses the minimal versions for | |
| # direct dependencies of this crate, while selecting the maximal versions for the transitive | |
| # dependencies. Alternatively, you can add a line in your Cargo.toml to artificially increase | |
| # the minimal dependency, which you do with e.g.: | |
| # ```toml | |
| # # for minimal-versions | |
| # [target.'cfg(any())'.dependencies] | |
| # openssl = { version = "0.10.55", optional = true } # needed to allow foo to build with -Zminimal-versions | |
| # ``` | |
| # The optional = true is necessary in case that dependency isn't otherwise transitively required | |
| # by your library, and the target bit is so that this dependency edge never actually affects | |
| # Cargo build order. See also | |
| # https://github.com/jonhoo/fantoccini/blob/fde336472b712bc7ebf5b4e772023a7ba71b2262/Cargo.toml#L47-L49. | |
| # This action is run on ubuntu with the stable toolchain, as it is not expected to fail | |
| runs-on: ubuntu-latest | |
| name: minimal-versions | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Install Rust stable | |
| uses: dtolnay/rust-toolchain@stable | |
| - name: Install Rust nightly for -Zdirect-minimal-versions | |
| uses: dtolnay/rust-toolchain@nightly | |
| - name: rustup default stable | |
| run: rustup default stable | |
| - name: cargo update -Zdirect-minimal-versions | |
| run: cargo +nightly update -Zdirect-minimal-versions | |
| - name: cargo test | |
| run: cargo test --locked --all-features --all-targets | |
| - name: Cache Cargo dependencies | |
| uses: Swatinem/rust-cache@v2 | |
| os-check: | |
| # run cargo test on mac and windows | |
| runs-on: ${{ matrix.os }} | |
| name: ${{ matrix.os }} (stable) | |
| strategy: | |
| fail-fast: false | |
| matrix: | |
| os: [macos-latest, windows-latest] | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Install Rust stable | |
| uses: dtolnay/rust-toolchain@stable | |
| - name: cargo generate-lockfile | |
| if: hashFiles('Cargo.lock') == '' | |
| run: cargo generate-lockfile | |
| - name: cargo test | |
| run: cargo test --locked --all-features --all-targets | |
| - name: Cache Cargo dependencies | |
| uses: Swatinem/rust-cache@v2 | |
| coverage: | |
| # use llvm-cov to build and collect coverage and outputs in a format that | |
| # is compatible with codecov.io | |
| # | |
| # note that codecov as of v4 requires that CODECOV_TOKEN from | |
| # | |
| # https://app.codecov.io/gh/<user or org>/<project>/settings | |
| # | |
| # is set in two places on your repo: | |
| # | |
| # - https://github.com/jonhoo/guardian/settings/secrets/actions | |
| # - https://github.com/jonhoo/guardian/settings/secrets/dependabot | |
| # | |
| # (the former is needed for codecov uploads to work with Dependabot PRs) | |
| # | |
| # PRs coming from forks of your repo will not have access to the token, but | |
| # for those, codecov allows uploading coverage reports without a token. | |
| # it's all a little weird and inconvenient. see | |
| # | |
| # https://github.com/codecov/feedback/issues/112 | |
| # | |
| # for lots of more discussion | |
| runs-on: ubuntu-latest | |
| name: coverage (stable) | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Install Rust stable | |
| uses: dtolnay/rust-toolchain@stable | |
| with: | |
| components: llvm-tools-preview | |
| - name: cargo install cargo-llvm-cov | |
| uses: taiki-e/install-action@cargo-llvm-cov | |
| - name: cargo generate-lockfile | |
| if: hashFiles('Cargo.lock') == '' | |
| run: cargo generate-lockfile | |
| - name: cargo llvm-cov | |
| run: cargo llvm-cov --locked --all-features --lcov --output-path lcov.info | |
| - name: Record Rust version | |
| run: echo "RUST=$(rustc --version)" >> "$GITHUB_ENV" | |
| - name: Cache Cargo dependencies | |
| uses: Swatinem/rust-cache@v2 | |
| - name: Upload to codecov.io | |
| uses: codecov/codecov-action@v4 | |
| with: | |
| fail_ci_if_error: true | |
| token: ${{ secrets.CODECOV_TOKEN }} | |
| env_vars: OS,RUST |