sharedkernel 2.6.4__tar.gz → 2.7.0__tar.gz

{sharedkernel-2.6.4 → sharedkernel-2.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sharedkernel
-Version: 2.6.4
+Version: 2.7.0
 Summary: sharekernel is a shared package between all python projects
 Author: Smilinno
 Description-Content-Type: text/markdown
@@ -20,7 +20,7 @@ Requires-Dist: markdown
 Requires-Dist: beautifulsoup4
 Requires-Dist: deepdiff
 Requires-Dist: kombu
-Requires-Dist: redis
+Requires-Dist: redis==8.0.0
 Dynamic: author
 Dynamic: description
 Dynamic: description-content-type
@@ -31,6 +31,8 @@ Dynamic: summary
 this is a shared kernel package
 
 # Change Log
+### Version 2.7.0
+- Add Redis and cache repository
 ### Version 2.6.4
 - Add Verbose to log
 ### Version 2.6.3

{sharedkernel-2.6.4 → sharedkernel-2.7.0}/README.md

@@ -2,6 +2,8 @@
 this is a shared kernel package
 
 # Change Log
+### Version 2.7.0
+- Add Redis and cache repository
 ### Version 2.6.4
 - Add Verbose to log
 ### Version 2.6.3

{sharedkernel-2.6.4 → sharedkernel-2.7.0}/setup.py

@@ -13,6 +13,7 @@ setup(
     packages=[
         "sharedkernel",
         "sharedkernel.database",
+        "sharedkernel.database.cache",
         "sharedkernel.enum",
         "sharedkernel.exception",
         "sharedkernel.objects",
@@ -37,10 +38,10 @@ setup(
         "beautifulsoup4",
         "deepdiff",
         "kombu",
-        "redis",
+        "redis==8.0.0",
     ],
     # *strongly* suggested for sharing
-    version="2.6.4",
+    version="2.7.0",
     description="sharekernel is a shared package between all python projects",
     long_description=long_description,
     long_description_content_type="text/markdown",

sharedkernel-2.7.0/sharedkernel/database/cache/cache_repository.py

@@ -0,0 +1,37 @@
+
+from abc import ABC, abstractmethod
+from typing import Generic, Optional, TypeVar
+from pydantic import BaseModel
+
+T = TypeVar("T", bound=BaseModel)
+
+
+class CacheRepository(ABC, Generic[T]):
+    @abstractmethod
+    async def set(
+        self,
+        key: str,
+        value: T,
+        ttl_seconds: int | None = None,
+    ) -> None:
+        pass
+
+    @abstractmethod
+    async def get(self, key: str) -> Optional[T]:
+        pass
+
+    @abstractmethod
+    async def exists(self, key: str) -> bool:
+        pass
+
+    @abstractmethod
+    async def delete(self, key: str) -> int:
+        pass
+
+    @abstractmethod
+    async def delete_group(self, key_prefix: str) -> int:
+        pass
+
+    @abstractmethod
+    async def clear(self) -> int:
+        pass

sharedkernel-2.7.0/sharedkernel/database/cache/redis_generic_cache.py

@@ -0,0 +1,88 @@
+from typing import Generic, Optional, Type, TypeVar
+from pydantic import BaseModel
+from redis.asyncio import Redis
+
+from cache.cache_repository import CacheRepository
+
+T = TypeVar("T", bound=BaseModel)
+
+
+class RedisGenericCache(CacheRepository[T], Generic[T]):
+    def __init__(
+        self,
+        client: Redis,
+        namespace: str,
+        model: Type[T],
+        default_ttl_seconds: int | None = None,
+    ):
+        self.client = client
+        self.namespace = namespace
+        self.model = model
+        self.default_ttl_seconds = default_ttl_seconds
+
+    def _pref(self, key: str) -> str:
+        return f"{self.namespace}:{key}"
+
+    def _unpref(self, key: str) -> str:
+        prefix = f"{self.namespace}:"
+        return key.removeprefix(prefix)
+
+    def _serialize(self, value: T) -> str:
+        return value.model_dump_json()
+
+    def _deserialize(self, raw: str | bytes) -> T:
+        return self.model.model_validate_json(raw.decode())
+
+    async def set(
+        self,
+        key: str,
+        value: T,
+        ttl_seconds: int | None = None,
+    ) -> None:
+        if value is None:
+            return
+
+        redis_key = self._pref(key)
+        ttl = ttl_seconds if ttl_seconds else self.default_ttl_seconds
+
+        if ttl:
+            await self.client.set(redis_key, self._serialize(value), ex=ttl)
+        else:
+            await self.client.set(redis_key, self._serialize(value))
+
+    async def get(self, key: str) -> Optional[T]:
+        raw = await self.client.get(self._pref(key))
+        if raw is None:
+            return None
+        return self._deserialize(raw)
+
+    async def exists(self, key: str) -> bool:
+        return bool(await self.client.exists(self._pref(key)))
+
+    async def delete(self, key: str) -> int:
+        return await self.client.delete(self._pref(key))
+
+    async def delete_group(self, key_prefix: str) -> int:
+        pattern = self._pref(f"{key_prefix}*")
+        deleted = 0
+
+        async for key in self.client.scan_iter(match=pattern):
+            deleted += await self.client.delete(key)
+
+        return deleted
+
+    async def clear(self) -> int:
+        deleted = 0
+
+        async for key in self.client.scan_iter(match=f"{self.namespace}:*"):
+            deleted += await self.client.delete(key)
+
+        return deleted
+
+    async def get_all_ids(self) -> list[str]:
+        result: list[str] = []
+
+        async for raw in self.client.scan_iter(match=f"{self.namespace}:*"):
+            result.append(self._unpref(raw.decode()))
+
+        return result

{sharedkernel-2.6.4 → sharedkernel-2.7.0}/sharedkernel.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sharedkernel
-Version: 2.6.4
+Version: 2.7.0
 Summary: sharekernel is a shared package between all python projects
 Author: Smilinno
 Description-Content-Type: text/markdown
@@ -20,7 +20,7 @@ Requires-Dist: markdown
 Requires-Dist: beautifulsoup4
 Requires-Dist: deepdiff
 Requires-Dist: kombu
-Requires-Dist: redis
+Requires-Dist: redis==8.0.0
 Dynamic: author
 Dynamic: description
 Dynamic: description-content-type
@@ -31,6 +31,8 @@ Dynamic: summary
 this is a shared kernel package
 
 # Change Log
+### Version 2.7.0
+- Add Redis and cache repository
 ### Version 2.6.4
 - Add Verbose to log
 ### Version 2.6.3

{sharedkernel-2.6.4 → sharedkernel-2.7.0}/sharedkernel.egg-info/SOURCES.txt

@@ -24,6 +24,9 @@ sharedkernel/database/mongo_generic_audit_repository.py
 sharedkernel/database/mongo_generic_repository.py
 sharedkernel/database/mongo_health_checker.py
 sharedkernel/database/pagination_response_dto.py
+sharedkernel/database/cache/__init__.py
+sharedkernel/database/cache/cache_repository.py
+sharedkernel/database/cache/redis_generic_cache.py
 sharedkernel/enum/__init__.py
 sharedkernel/enum/error_code.py
 sharedkernel/enum/redis_mode_enum.py

{sharedkernel-2.6.4 → sharedkernel-2.7.0}/sharedkernel.egg-info/requires.txt

@@ -14,4 +14,4 @@ markdown
 beautifulsoup4
 deepdiff
 kombu
-redis
+redis==8.0.0