A class that emulates :py:class:`requests.Response`, optimized for serialization

Session class that extends :py:class:`requests.Session` with caching features. See individual :py:mod:`backend classes <requests_cache.backends>`

Class used internally to store settings that affect caching behavior. This allows settings to be used across multiple modules, but exposed to the

A pipeline of stages chained together to serialize and deserialize response objects. Note: Typically, the first stage should be a :py:class:`.Cat

A single stage in a serializer pipeline. This wraps serialization steps with consistent ``dumps()`` and ``loads()`` methods Args: obj

Base serializer class that does pre/post-processing with ``cattrs``. This can be used either on its own, or as a stage within a :py:class:`.Seria

A serializable dataclass that emulates :py:class:`requests.PreparedResponse`

A wrapper class that emulates :py:class:`~urllib3.response.HTTPResponse`. This enables consistent behavior for streaming requests and generator u

A dictionary-like interface for a MongoDB collection Args: db_name: Database name collection_name: Collection name connec

A basic dict wrapper class for non-persistent, in-memory storage .. note:: This is mostly a placeholder for when no other backends are av

A dictionary-like interface for DynamoDB table Args: table_name: DynamoDB table name create_table: Whether or not to automaticall

A dictionary-like interface for SQLite

GridFS cache backend. Args: db_name: Database name connection: :py:class:`~pymongo.mongo_client.MongoClient` object to reuse inst

A SQLite db used to track LRU metadata for cached items: * ``key``: The cache key * ``access_time``: The last access time, as a UNIX timestam

Base class for cache backends. Can be used as a non-persistent, in-memory cache. This manages higher-level cache operations, including: * Sa

Translates cache settings and headers into specific actions to take for a given cache item. The resulting actions are then handled in :py:meth:`C

Track requests per second plus cache size in a single live view

A dictionary-like interface for a GridFS database Args: db_name: Database name collection_name: Ignored; GridFS internally uses c

Wrapper class for non-cached responses returned by :py:class:`.CachedSession`

Display a bar chart of requests per second

Redis cache backend. Args: namespace: Redis namespace connection: Redis connection instance to use instead of creating a new one

A dictionary-like interface for Redis operations. **Notes:** * All keys will be encoded as bytes, and all values will be serialized

A dictionary-like interface for operations on a single Redis hash **Notes:** * All keys will be encoded as bytes * Items will be

SQLite cache backend. Args: db_path: Database file path use_cache_dir: Store database in a user cache directory (e.g., `~/.cache/

Base class for testing cache backend classes

Wrapper class for responses returned by :py:class:`.CachedSession`. This mainly exists to provide type hints for extra cache-related attributes th

Base class for client-agnostic storage implementations. Notes: * This provides a common dictionary-like interface for the underlying storage oper

Base class for testing cache storage dict-like interfaces

Parses Cache-Control directives and other relevant cache settings from either request or response headers

Mixin class that extends :py:class:`requests.Session` with caching features. See :py:class:`.CachedSession` for usage details.

DynamoDB cache backend. By default, responses are only partially serialized into a DynamoDB-compatible document format. Args: table_n

Filesystem cache backend. Args: cache_name: Base directory for cache files use_cache_dir: Store database in a user cache director

A dictionary-like interface to files on the local filesystem. The cache directory will be created if it doesn't already exist.

Class that will raise an error when unpickled

Response that will raise an exception when deserialized

A size-restricted version of FileDict, using LRU eviction. Args: block_bytes: The size of a block of data on the file system.

MongoDB cache backend. By default, responses are partially serialized into a MongoDB-compatible document format. Args: db_name: Datab

Mixin that customizes output when pretty-printed with rich. Compared to default rich behavior for attrs classes, this does the following: * I

Test the LRUFileDict with the same tests as the FileDict.