[fcostaoliveira]

Adds RLTest.add_test_hook(hook). hook(env, test) returns a context manager that RLTest enters before, and exits after, every function test that takes an env. test is the test function, so a hook can read markers set on it, such as an opt-out. Failed assertions and exceptions in the hook fail that test, as the test's own would. Hooks run in the order added.

RLTest re-imports a test file before each of its tests. So a top-level function added again with the same module and name replaces the earlier copy, and runs once per test. Any other callable, such as a lambda, closure or bound method, is the same hook only if it is the same object.

This lets a suite check every test in one place without patching RLTest's loader. memtier_benchmark uses it to fail any test that leaves an -NOAUTH reply on a password-protected server (redis/memtier_benchmark#863).

• RLTest/test_hooks.py: the registry and run_with_hooks(), called from _runTest.
• tests/unit/test_test_hooks.py: order, dedup across a re-import (the newer copy wins), distinct same-named hooks all running, exit on a failing test, a failing hook, and the test function being passed.
• tests/flow/test_hooks_flow.py: through the runner, a hook added at a test file's top level runs exactly once per test.
• README: a short example.

🤖 Generated with Claude Code

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{Reviewed by Cursor Bugbot for commit 3f3e542. Configure here.}

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 95.65217% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 51.64%. Comparing base (02cfbb9) to head (d9eda2a).
⚠️ Report is 37 commits behind head on master.

Files with missing lines	Patch %	Lines
RLTest/__main__.py	50.00%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           master     #262       +/-   ##
===========================================
+ Coverage   32.46%   51.64%   +19.18%     
===========================================
  Files          17       19        +2     
  Lines        2597     2864      +267     
===========================================
+ Hits          843     1479      +636     
+ Misses       1754     1385      -369     

Flag	Coverage Δ
unittests	51.64% <95.65%> (+19.18%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.