Get a response with randomized content

Contextmanager that provides a RequestsMock object mocked URLs and responses based on cache data

Temporarily silence deprecation warnings

Make a converter to structure and unstructure nested objects within a :py:class:`.CachedResponse` Args: factory: An optional factory

Install project and test dependencies into a test-specific virtualenv using uv

Check if a given dependency is installed

Determine if this cached response is older than the given time

Load settings from a YAML config file

Context manager that mocks and logs all non-cached requests

Example usage; replace with any other requests you want to test

Normalize and filter a URL. This includes request parameters, IDN domains, scheme, host, port, etc.

Run once to save data to reuse for tests, for demo purposes. In practice, you could just run your application or tests with requests-cache install

Create a stage that uses ``itsdangerous`` to add a signature to responses on write, and validate that signature with a secret key on read. Can be

Split ``kwargs`` into two dicts: those that are valid arguments for ``func``, and those that are not

Simplified generator over cached content that emulates :py:meth:`urllib3.response.HTTPResponse.stream()`

Test all relevant combinations of response formats X serializers

Test that the custom cache keys are working as expected

Test that URL patterns are working, and that non-GitHub requests are not cached

Timeout decorator that uses threading instead of multiprocessing, for compatibility with pytest-xdist on python 3.14+.

Export cached responses to a VCR-compatible YAML file (cassette) Args: cache: Cache instance containing response data to export p

Convert a single response to a VCR-compatible response ("episode") dict

Convert a value to an int, if possible, otherwise ``None``

Apply validation headers (if any) before sending a request

Add caching to an existing :py:class:`~requests.Session` object, while retaining all original session settings. Args: ori

Modify a response object in-place and add extra cache-related attributes

Delete a file and remove it from the LRU index

Start live view on ctx enter

Show stats on ctx exit

Get a value and update its access time in the LRU index

An additional step is needed here for response data. The original response object is still in memory, and hasn't gone through a serialize/dese

Override pickling behavior from ``requests.Response.__getstate__``

First initialize via HTTPResponse.__init__, then via __attrs_init__