Ruff workflow (taylorwilsdon/google_workspace_mcp)
The Ruff workflow from taylorwilsdon/google_workspace_mcp, explained and optimized by Latchkey.
CI health: F - at risk
Point runs-on at Latchkey and get caching, run de-duplication, job timeouts, SHA-pinned actions, self-healing for flaky steps, and up to 58% lower cost, applied automatically.
What it does
This is the Ruff workflow from the taylorwilsdon/google_workspace_mcp repository, a real project running GitHub Actions. It is shown here with attribution under its MIT license.
Below, Latchkey shows a faster, safer version produced by its optimization engine.
The workflow
name: Ruff
on:
pull_request:
branches: [ main ]
push:
branches: [ main ]
permissions:
contents: read
jobs:
autofix:
if: github.event.pull_request.head.repo.full_name == github.repository
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@v6
with:
ref: ${{ github.event.pull_request.head.ref }}
token: ${{ secrets.GITHUB_TOKEN }}
- uses: actions/setup-python@v6
with:
python-version: '3.11'
- name: Install uv
uses: astral-sh/setup-uv@v7
- name: Auto-fix ruff lint and format
# Same-repo only (guarded by job `if`), so we still avoid `uv sync`
# to keep behaviour consistent and minimise blast radius.
run: |
uvx ruff check --fix
uvx ruff format
- name: Commit and push fixes
run: |
git diff --quiet && exit 0
git config user.name "github-actions[bot]"
git config user.email "github-actions[bot]@users.noreply.github.com"
git add -A
git commit -m "style: auto-fix ruff lint and format"
git push
ruff:
if: always() && (github.event_name == 'pull_request' || github.event_name == 'push')
needs: [autofix]
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/setup-python@v6
with:
python-version: '3.11'
- name: Install uv
uses: astral-sh/setup-uv@v7
- name: Validate
# Use `uvx` so we run ruff in an isolated environment without invoking
# the project's build backend or executing pyproject.toml hooks. This
# keeps the validation step safe to run on untrusted fork PR code.
# For same-repo PRs, this runs after autofix commits any formatting fixes.
run: |
uvx ruff check
uvx ruff format --check
The same workflow, on Latchkey
Estimated ~20% faster on cache hits, plus fewer wasted runs and a safer supply chain. Added and changed lines are highlighted.
name: Ruff on: pull_request: branches: [ main ] push: branches: [ main ] permissions: contents: read concurrency: group: ${{ github.workflow }}-${{ github.ref }} cancel-in-progress: true jobs: autofix: timeout-minutes: 30 if: github.event.pull_request.head.repo.full_name == github.repository runs-on: latchkey-small permissions: contents: write steps: - uses: actions/checkout@v6 with: ref: ${{ github.event.pull_request.head.ref }} token: ${{ secrets.GITHUB_TOKEN }} - uses: actions/setup-python@v6 with: cache: 'pip' python-version: '3.11' - name: Install uv uses: astral-sh/setup-uv@v7 - name: Auto-fix ruff lint and format # Same-repo only (guarded by job `if`), so we still avoid `uv sync` # to keep behaviour consistent and minimise blast radius. run: | uvx ruff check --fix uvx ruff format - name: Commit and push fixes run: | git diff --quiet && exit 0 git config user.name "github-actions[bot]" git config user.email "github-actions[bot]@users.noreply.github.com" git add -A git commit -m "style: auto-fix ruff lint and format" git push ruff: timeout-minutes: 30 if: always() && (github.event_name == 'pull_request' || github.event_name == 'push') needs: [autofix] runs-on: latchkey-small steps: - uses: actions/checkout@v6 - uses: actions/setup-python@v6 with: cache: 'pip' python-version: '3.11' - name: Install uv uses: astral-sh/setup-uv@v7 - name: Validate # Use `uvx` so we run ruff in an isolated environment without invoking # the project's build backend or executing pyproject.toml hooks. This # keeps the validation step safe to run on untrusted fork PR code. # For same-repo PRs, this runs after autofix commits any formatting fixes. run: | uvx ruff check uvx ruff format --check
What changed
- Run on Latchkey managed runners with one line (
runs-on), which apply the fixes below automatically and self-heal transient failures. This example useslatchkey-small; pick the runner size that fits the job. - Cancel superseded runs when a branch or PR gets a newer push.
- Cache dependency installs on the setup step so they are served from cache.
- Add a job timeout so a hung step cannot burn hours of runner time.
1 third-party action is referenced by a movable tag. Pin it to the commit SHA (Latchkey resolves and applies this automatically) so a repointed tag cannot change what runs.
This workflow runs 2 jobs per trigger. On Latchkey the same minutes cost up to 58% less than GitHub-hosted, with zero queue time.