Beta Shell v2.0

File Manager

~ /usr/local/python-3.12/lib/python3.12/site-packages/pip/_vendor/cachecontrol

Name	Size	Perms	Modified	Actions
[ .. / .. ]
__init__.py	677 B	-rw-r--r--	2025-10-22 11:03:53	Edit Del
__pycache__	-	drwxr-xr-x	2025-10-22 11:03:54	Del
_cmd.py	1.7 KB	-rw-r--r--	2025-10-22 11:03:53	Edit Del
adapter.py	6.44 KB	-rw-r--r--	2025-10-22 11:03:53	Edit Del
cache.py	1.91 KB	-rw-r--r--	2025-10-22 11:03:53	Edit Del
caches	-	drwxr-xr-x	2025-10-22 11:03:54	Del
controller.py	18.65 KB	-rw-r--r--	2025-10-22 11:03:53	Edit Del
filewrapper.py	4.19 KB	-rw-r--r--	2025-10-22 11:03:53	Edit Del
heuristics.py	4.77 KB	-rw-r--r--	2025-10-22 11:03:53	Edit Del
py.typed	0 B	-rw-r--r--	2025-10-22 11:03:53	Edit Del
serialize.py	5.04 KB	-rw-r--r--	2025-10-22 11:03:53	Edit Del
wrapper.py	1.38 KB	-rw-r--r--	2025-10-22 11:03:53	Edit Del

Editing: cache.py (1.91 KB)

# SPDX-FileCopyrightText: 2015 Eric Larson
#
# SPDX-License-Identifier: Apache-2.0

"""
The cache object API for implementing caches. The default is a thread
safe in-memory dictionary.
"""

from __future__ import annotations

from threading import Lock
from typing import IO, TYPE_CHECKING, MutableMapping

if TYPE_CHECKING:
    from datetime import datetime


class BaseCache:
    def get(self, key: str) -> bytes | None:
        raise NotImplementedError()

    def set(
        self, key: str, value: bytes, expires: int | datetime | None = None
    ) -> None:
        raise NotImplementedError()

    def delete(self, key: str) -> None:
        raise NotImplementedError()

    def close(self) -> None:
        pass


class DictCache(BaseCache):
    def __init__(self, init_dict: MutableMapping[str, bytes] | None = None) -> None:
        self.lock = Lock()
        self.data = init_dict or {}

    def get(self, key: str) -> bytes | None:
        return self.data.get(key, None)

    def set(
        self, key: str, value: bytes, expires: int | datetime | None = None
    ) -> None:
        with self.lock:
            self.data.update({key: value})

    def delete(self, key: str) -> None:
        with self.lock:
            if key in self.data:
                self.data.pop(key)


class SeparateBodyBaseCache(BaseCache):
    """
    In this variant, the body is not stored mixed in with the metadata, but is
    passed in (as a bytes-like object) in a separate call to ``set_body()``.

    That is, the expected interaction pattern is::

        cache.set(key, serialized_metadata)
        cache.set_body(key)

    Similarly, the body should be loaded separately via ``get_body()``.
    """

    def set_body(self, key: str, body: bytes) -> None:
        raise NotImplementedError()

    def get_body(self, key: str) -> IO[bytes] | None:
        """
        Return the body as file-like object.
        """
        raise NotImplementedError()