harp_apps.http_cache.storages

class AsyncStorage

Bases: AsyncBaseStorage

HARP’s AsyncBaseStorage implementation using blob storage backend.

This implementation adapts hishel 1.0’s Entry-based API to work with HARP’s blob storage system. We store a single entry per cache key, maintaining backward compatibility with existing cached data.

__init__(storage, ttl=None, check_ttl_every=60)

Parameters:

• storage (IBlobStorage)

• ttl (int | float | None)

• check_ttl_every (int | float)

async close()

Close the storage (required by AsyncBaseStorage interface).

Return type:

None

async create_entry(request, response, key, id_=None)

Create and store a new cache entry.

Args:

request: The HTTP request response: The HTTP response key: The cache key id_: Optional UUID for the entry (generated if not provided)

Returns:

The created Entry

Parameters:

• request (Request)

• response (Response)

• key (str)

• id_ (UUID | None)

Return type:

Entry

async get_entries(key)

Retrieve all entries for a given cache key.

Note: Our implementation stores only one entry per key, so this returns a list with at most one element.

Args:

key: The cache key

Returns:

List of Entry objects (empty if not found, single element if found)

Parameters:

key (str)

Return type:

List[Entry]

async remove_entry(id)

Remove an entry by its ID.

Args:

id: The entry UUID

Parameters:

id (UUID)

Return type:

None

async update_entry(id, new_entry)

Update an existing entry by its ID.

Args:

id: The entry UUID new_entry: Either a new Entry object or a callable that transforms the existing entry

Returns:

The updated Entry, or None if not found

Parameters:

• id (UUID)

• new_entry (Entry | Callable[[Entry], Entry])

Return type:

Entry | None