throttle-kit 1.1.0

Rate limiting for Rust — GCRA algorithm with in-memory and Redis backends, Tower layer integration
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

name: CI
on:
  push:
    branches: [main, master]
  pull_request:

jobs:
  quality:
    uses: WyattAu/engineering-standards/.github/workflows/rust-kit.yml@main
    with:
      tier: a
      all-features: true
      loom: false
      wasm: false
      miri: false
      # criterion wall-clock benches: human-readable trend, non-gating.
      # The pass/fail gate is the `perf-gate` job below (iai-callgrind,
      # deterministic instruction counts).
      bench-regression: true

  # Deterministic perf gate: iai-callgrind instruction counts on the
  # RateLimiter::check hot path (benches/iai_hot_path.rs).
  #
  # Baseline workflow: every push to main re-saves the `main` baseline and
  # caches it; PRs compare against it with --fail-fast (first regression
  # fails the job). Baseline updates are INTENTIONAL — after merging a
  # deliberate perf change, the next main push refreshes the reference.
  perf-gate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - name: Install iai-callgrind runner
        # valgrind is preinstalled on ubuntu-latest runners; iai-callgrind
        # shells out to it (callgrind tool).
        run: cargo install iai-callgrind-runner --locked
      - name: Restore main baseline
        if: github.event_name == 'pull_request'
        uses: actions/cache/restore@v4
        with:
          path: target/iai
          key: iai-baseline-main-notused-${{ github.run_id }}
          restore-keys: iai-baseline-main-
      - name: Save baseline (push to main)
        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
        run: cargo bench --bench iai_hot_path -- --save-baseline=main
      - name: Regression gate (PRs)
        if: github.event_name == 'pull_request'
        run: cargo bench --bench iai_hot_path -- --baseline=main --fail-fast
      - name: Save baseline cache (push to main)
        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
        uses: actions/cache/save@v4
        with:
          path: target/iai
          key: iai-baseline-main-${{ github.run_id }}