Cassette expiry¶

Cassettes rot. The API adds a field, renames another, and your tests keep passing against a response from six months ago.

Set max_age to catch that:

with use_cassette("cassette.yaml", max_age="30d", on_expiry="rerecord"):
    ...

max_age accepts durations like "24h", "7d", "4w". When the cassette is older than that, on_expiry decides what happens:

With pytest¶

Configure it for a module through vcr_config:

@pytest.fixture(scope="module")
def vcr_config():
    return {"max_age": "30d", "on_expiry": "warn"}

Or per test, through the marker:

@pytest.mark.vcr(max_age="7d", on_expiry="fail")
async def test_fresh_data():
    ...