orion-cache 0.1.0__tar.gz

orion_cache-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ali Rashidi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

orion_cache-0.1.0/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: orion-cache
+Version: 0.1.0
+Summary: Shared Redis cache decorator for internal Python services — write once, import everywhere.
+Author-email: Ali Rashidi <aliinreallifee@gmail.com>
+License: MIT
+Project-URL: Repository, https://github.com/aliinreallife/orion-cache
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: redis>=5.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Dynamic: license-file
+
+# orion-cache
+orion-cache Shared Redis cache decorator for internal Python services — write once, import everywhere.

orion_cache-0.1.0/README.md

@@ -0,0 +1,2 @@
+# orion-cache
+orion-cache Shared Redis cache decorator for internal Python services — write once, import everywhere.

orion_cache-0.1.0/orion_cache/__init__.py

@@ -0,0 +1,3 @@
+from .cache import redis_cache, clear_all_caches, get_client
+
+__all__ = ["redis_cache", "clear_all_caches", "get_client"]

orion_cache-0.1.0/orion_cache/cache.py

@@ -0,0 +1,80 @@
+import json
+import logging
+import functools
+from typing import Callable, Any
+
+import redis
+
+from .config import REDIS_URL, DEFAULT_TTL
+
+logger = logging.getLogger(__name__)
+
+_client: redis.Redis | None = None
+
+
+def get_client() -> redis.Redis:
+    """Returns a singleton Redis client."""
+    global _client
+    if _client is None:
+        _client = redis.from_url(REDIS_URL, decode_responses=True, socket_timeout=2)
+    return _client
+
+
+def redis_cache(ttl: int = DEFAULT_TTL) -> Callable:
+    """
+    Decorator that caches a function's return value in Redis.
+
+    Usage:
+        @redis_cache(ttl=120)
+        def get_orders(customer):
+            return db.query(...)
+    """
+    def decorator(func: Callable) -> Callable:
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs) -> Any:
+            key = f"{func.__name__}:{args}:{kwargs}"
+            client = get_client()
+
+            try:
+                cached = client.get(key)
+                if cached is not None:
+                    logger.debug("Cache HIT: %s", key)
+                    return json.loads(cached)
+            except redis.RedisError as e:
+                logger.warning("Cache read failed, falling through to function. Error: %s", e)
+
+            logger.debug("Cache MISS: %s", key)
+            result = func(*args, **kwargs)
+
+            try:
+                client.setex(key, ttl, json.dumps(result, default=str))
+            except redis.RedisError as e:
+                logger.warning("Cache write failed. Error: %s", e)
+
+            return result
+        return wrapper
+    return decorator
+
+
+def clear_all_caches(pattern: str = "*") -> int:
+    """
+    Deletes all keys matching the given pattern.
+    Defaults to clearing everything. Use a pattern like 'get_orders:*' to be selective.
+    Returns number of deleted keys.
+    """
+    client = get_client()
+    try:
+        cursor = 0
+        deleted = 0
+        while True:
+            cursor, keys = client.scan(cursor, match=pattern, count=100)
+            if keys:
+                client.delete(*keys)
+                deleted += len(keys)
+            if cursor == 0:
+                break
+        logger.info("Cleared %d cache keys (pattern: %s)", deleted, pattern)
+        return deleted
+    except redis.RedisError as e:
+        logger.error("Cache clear failed. Error: %s", e)
+        return 0

orion_cache-0.1.0/orion_cache/config.py

@@ -0,0 +1,17 @@
+import os
+from dotenv import load_dotenv
+
+load_dotenv()  # loads .env file if present, ignored in prod where real env vars are set
+
+REDIS_HOST = os.getenv("REDIS_HOST", "localhost")
+REDIS_PORT = int(os.getenv("REDIS_PORT", 6379))
+REDIS_PASSWORD = os.getenv("REDIS_PASSWORD", None)
+REDIS_DB = int(os.getenv("REDIS_DB", 0))
+DEFAULT_TTL = int(os.getenv("CACHE_DEFAULT_TTL", 300))
+
+REDIS_URL = os.getenv(
+    "REDIS_URL",
+    f"redis://:{REDIS_PASSWORD}@{REDIS_HOST}:{REDIS_PORT}/{REDIS_DB}"
+    if REDIS_PASSWORD
+    else f"redis://{REDIS_HOST}:{REDIS_PORT}/{REDIS_DB}",
+)

orion_cache-0.1.0/orion_cache.egg-info/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: orion-cache
+Version: 0.1.0
+Summary: Shared Redis cache decorator for internal Python services — write once, import everywhere.
+Author-email: Ali Rashidi <aliinreallifee@gmail.com>
+License: MIT
+Project-URL: Repository, https://github.com/aliinreallife/orion-cache
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: redis>=5.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Dynamic: license-file
+
+# orion-cache
+orion-cache Shared Redis cache decorator for internal Python services — write once, import everywhere.

orion_cache-0.1.0/orion_cache.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+orion_cache/__init__.py
+orion_cache/cache.py
+orion_cache/config.py
+orion_cache.egg-info/PKG-INFO
+orion_cache.egg-info/SOURCES.txt
+orion_cache.egg-info/dependency_links.txt
+orion_cache.egg-info/requires.txt
+orion_cache.egg-info/top_level.txt
+tests/test_cache.py

orion_cache-0.1.0/orion_cache.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

orion_cache-0.1.0/orion_cache.egg-info/requires.txt

@@ -0,0 +1,2 @@
+redis>=5.0.0
+python-dotenv>=1.0.0

orion_cache-0.1.0/orion_cache.egg-info/top_level.txt

@@ -0,0 +1 @@
+orion_cache

orion_cache-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "orion-cache"
+version = "0.1.0"
+description = "Shared Redis cache decorator for internal Python services — write once, import everywhere."
+authors = [{ name = "Ali Rashidi", email = "aliinreallifee@gmail.com" }]
+license = { text = "MIT" }
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = ["redis>=5.0.0", "python-dotenv>=1.0.0"]
+
+[project.urls]
+Repository = "https://github.com/aliinreallife/orion-cache"

orion_cache-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

orion_cache-0.1.0/tests/test_cache.py

@@ -0,0 +1,30 @@
+from unittest.mock import patch, MagicMock
+from orion_cache import redis_cache
+
+
+def test_cache_miss_then_hit():
+    mock_client = MagicMock()
+    mock_client.get.return_value = None  # first call is a miss
+
+    with patch("orion_cache.cache.get_client", return_value=mock_client):
+        @redis_cache(ttl=60)
+        def get_data(name):
+            return {"name": name}
+
+        result = get_data("ali")
+        assert result == {"name": "ali"}
+        mock_client.setex.assert_called_once()
+
+
+def test_cache_hit_returns_cached():
+    import json
+    mock_client = MagicMock()
+    mock_client.get.return_value = json.dumps({"name": "ali"})
+
+    with patch("orion_cache.cache.get_client", return_value=mock_client):
+        @redis_cache(ttl=60)
+        def get_data(name):
+            raise Exception("should not be called")
+
+        result = get_data("ali")
+        assert result == {"name": "ali"}