Skip to content

feat: Implement AbstractAsyncFeatureCache for async SDK clients #80

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
vazarkevych wants to merge 8 commits into
base: main
Choose a base branch
from
+245 −139
Open

feat: Implement AbstractAsyncFeatureCache for async SDK clients #80

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
8172b5e
feat: create cache_interfaces.py and add it to __init__.py
vazarkevych Dec 1, 2025
02ac096
feat: add cache and async_cache properties to Options class
vazarkevych Dec 1, 2025
031a67f
feat: implement InMemoryAsyncFeatureCache, add set_async_cache in Fea…
vazarkevych Dec 1, 2025
ba5fb98
feat: integrate async cache setting in GrowthBookClient init block
vazarkevych Dec 1, 2025
ed2e051
Merge branch 'main' into feature/async-cache
vazarkevych Dec 4, 2025
084c29c
refactor import
vazarkevych Dec 4, 2025
cb5e9b7
Merge branch 'main' into feature/async-cache
vazarkevych Dec 8, 2025
47283ff
Merge branch 'main' into feature/async-cache
vazarkevych Dec 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions growthbook/__init__.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,11 @@
BackoffStrategy
)

from .cache_interfaces import (
AbstractFeatureCache,
AbstractAsyncFeatureCache
)

# Plugin support
from .plugins import (
GrowthBookTrackingPlugin,
Expand Down
46 changes: 46 additions & 0 deletions growthbook/cache_interfaces.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
from abc import abstractmethod, ABC
from typing import Optional, Dict

class AbstractFeatureCache(ABC):
@abstractmethod
def get(self, key: str) -> Optional[Dict]:
pass

@abstractmethod
def set(self, key: str, value: Dict, ttl: int) -> None:
pass

def clear(self) -> None:
pass

class AbstractAsyncFeatureCache(ABC):
"""Abstract base class for async feature caching implementations"""

@abstractmethod
async def get(self, key: str) -> Optional[Dict]:
"""
Retrieve cached features by key.

Args:
key: Cache key

Returns:
Cached dictionary or None if not found/expired
"""
pass

@abstractmethod
async def set(self, key: str, value: Dict, ttl: int) -> None:
"""
Store features in cache with TTL.

Args:
key: Cache key
value: Features dictionary to cache
ttl: Time to live in seconds
"""
pass

async def clear(self) -> None:
"""Clear all cached entries (optional to override)"""
pass
5 changes: 4 additions & 1 deletion growthbook/common_types.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@
from typing import Any, Callable, Dict, List, Optional, Union, Set, Tuple
from enum import Enum
from abc import ABC, abstractmethod
from .cache_interfaces import AbstractFeatureCache, AbstractAsyncFeatureCache

class VariationMeta(TypedDict):
key: str
Expand Down Expand Up @@ -396,7 +397,7 @@ def get_all_assignments(self, attributes: Dict[str, str]) -> Dict[str, Dict]:
return docs

@dataclass
class StackContext:
class StackContext:
id: Optional[str] = None
evaluated_features: Set[str] = field(default_factory=set)

Expand Down Expand Up @@ -431,6 +432,8 @@ class Options:
on_experiment_viewed: Optional[Callable[[Experiment, Result, Optional[UserContext]], None]] = None
on_feature_usage: Optional[Callable[[str, 'FeatureResult', UserContext], None]] = None
tracking_plugins: Optional[List[Any]] = None
cache: Optional[AbstractFeatureCache] = None
async_cache: Optional[AbstractAsyncFeatureCache] = None


@dataclass
Expand Down
Loading