WedgedForkRecycledWarning

Documentation for eth_defi.testing.anvil_fork_pool.WedgedForkRecycledWarning exception.

exception WedgedForkRecycledWarning

Bases: UserWarning

Warn that an unresponsive pooled Anvil fork was disposed and relaunched.

A long-lived shared fork can stop answering under sustained load (see the AnvilSnapshotState docstring in eth_defi.provider.anvil, and the “Wedged-fork recycling” section of this module’s docstring). Without recycling, every remaining test sharing that fork fails at setup with a 60 s read_timeout against localhost.

This is a UserWarning on purpose: recycling repairs the symptom so the suite can continue, but it does not fix the underlying degradation. Surfacing it in the pytest warnings summary keeps a fork that wedges repeatedly visible — treat a burst of these as a signal to cap tests-per-fork or recycle proactively, not as normal background noise.

Introduced in PR #1372.

__init__(*args, **kwargs)

__new__(**kwargs)

add_note(note, /)

Add a note to the exception

with_traceback(tb, /)

Set self.__traceback__ to tb and return self.