cache ¤

Caches return values until some event in the inferior happens, e.g. execution stops because of a SIGINT or breakpoint, or a new library/objfile are loaded, etc.

Classes:

• DebugCacheDict –
• CachedFunction –
• CacheUntilEvent –

  Not necessarily 1:1 with pwndbg.dbg_mod.EventTypes , but

Functions:

• events_to_event_set –
• connect_clear_caching_events –

  Connect given debugger event hooks to corresponding _CacheUntilEvent instances

• cache_until –

  All possible values of the function arguments must be hashable

• clear_caches –
• clear_cache –

Attributes:

• T –
• P –
• debug –
• debug_name –
• Cache –
• EventSet –
• IS_CACHING –
• IS_CACHING_DISABLED_FOR (EventSet) –

T = TypeVar('T', covariant=True)

P = ParamSpec('P')

debug = NO_DEBUG

debug_name = 'regs'

Cache = Union[Dict[Tuple[Any, ...], Any], DebugCacheDict]

EventSet = int

IS_CACHING = True

IS_CACHING_DISABLED_FOR: EventSet = 0

DebugCacheDict(func: Callable[P, T], *args: Any, **kwargs: Any)

hits = 0

misses = 0

func = func

name = f'{split('.')[-1]}.{__name__}'

__getitem__(key: tuple[Any, ...]) -> Any

__setitem__(key: tuple[Any, ...], value: Any) -> None

clear() -> None

cache: Cache

__call__(*args: Any, **kwargs: Any) -> T

STOP = 1

EXIT = 2

OBJFILE = 4

START = 8

CONT = 16

THREAD = 32

FOREVER = 64

events_to_event_set(event_list: list[CacheUntilEvent]) -> EventSet

connect_clear_caching_events(
    event_dicts: dict[CacheUntilEvent, tuple[Any, ...]],
) -> None

cache_until(
    *event_names: str,
) -> Callable[[Callable[P, T]], CachedFunction[T]]

clear_caches() -> None

clear_cache(cache_event: CacheUntilEvent) -> None