Initial public release

Author: jaybosamiya

.figures/trex-phases.svg

@@ -0,0 +1,65 @@
+#!/bin/bash
+
+# A script that runs `cargo` commands in a way that makes GitHub actions runners
+# slightly nicer wherever possible. Aim is to also make it easier to run this
+# locally.
+#
+# Author: Jay Bosamiya
+# Version: 0.0.2
+#
+# Usage:
+#   ./github_actions_run_cargo build
+#   ...
+
+set -eo pipefail
+
+function to_gha {
+    jq --raw-output '
+       .message |
+       select(.spans != null) |
+       select(.level == "error" or .level == "warning") |
+       select(.spans[].is_primary == true) |
+       {l:.level,s:.spans[0],m:.message,r:.rendered} |
+       "::\(.l) file=\(.s.file_name),line=\(.s.line_start),endLine=\(.s.line_end),col=\(.s.column_start),endColumn=\(.s.column_end),title=\(.m)::\(.r)" |
+       gsub("\n";"%0A") | gsub("\r";"%0D")
+   '
+}
+
+if [ $# -lt 1 ]; then
+    echo "Usage: $0 {build|check|clippy|fmt} [extra args...]"
+    exit 1
+fi
+
+COMMAND=$1
+shift
+
+case "$COMMAND" in
+build | check | clippy)
+    if ! cargo "$COMMAND" --message-format json --verbose "$@" | to_gha; then
+        echo '::error title='"$COMMAND"' issue::"cargo '"$COMMAND"'" failed'
+        exit 1
+    fi
+    ;;
+fmt)
+    if ! cargo fmt --check --verbose "$@"; then
+        echo '::error title=Formatting issue::"cargo fmt" failed'
+        exit 1
+    fi
+    ;;
+test)
+    if ! cargo test --verbose "$@"; then
+        echo '::error title=Tests failed::"cargo test" failed'
+        exit 1
+    fi
+    ;;
+nextest)
+    if ! cargo nextest run --profile ci --config-file "$(git rev-parse --show-toplevel)/.github/tools/nextest.toml" "$@"; then
+        echo '::error title=Tests failed::"cargo nextest run" failed'
+        exit 1
+    fi
+    ;;
+*)
+    echo "Unsupported command: $COMMAND"
+    exit 1
+    ;;
+esac

.github/tools/github_actions_run_cargo

@@ -0,0 +1,8 @@
+[profile.ci]
+# Do not cancel the test run on the first failure.
+fail-fast = false
+# Show all tests _including_ skipped tests in output.
+status-level = "all"
+# Output failures as soon as they happen _and_ at the end of the test run;
+# combination of "immediate" and "final".
+failure-output = "immediate-final"

.github/tools/nextest.toml

@@ -0,0 +1,37 @@
+name: CI
+
+on: [push, pull_request, workflow_dispatch]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  build_and_test:
+    name: Build and Test
+    runs-on: ubuntu-latest
+    env:
+      RUSTFLAGS: -Dwarnings
+    steps:
+      - name: Check out repo
+        uses: actions/checkout@v4
+      - name: Set up Rust
+        run: |
+          rustup toolchain install stable --profile minimal --no-self-update --component rustfmt
+      - name: Set up Nextest
+        run: |
+          curl -LsSf https://get.nexte.st/latest/linux | tar zxf - -C ${CARGO_HOME:-~/.cargo}/bin
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: trex
+      - run: ../.github/tools/github_actions_run_cargo fmt
+        working-directory: ./trex
+      - run: ../.github/tools/github_actions_run_cargo build
+        working-directory: ./trex
+      - run: ../.github/tools/github_actions_run_cargo nextest
+        working-directory: ./trex
+      - run: |
+          ../.github/tools/github_actions_run_cargo test --doc
+          # We need to run `cargo test --doc` separately because doc tests
+          # aren't included in nextest at the moment. See relevant discussion at
+          # https://github.com/nextest-rs/nextest/issues/16
+        working-directory: ./trex