simple-dep-cache 0.1.1__tar.gz

simple_dep_cache-0.1.1/.github/workflows/publish-pypi.yaml

@@ -0,0 +1,26 @@
+name: Publish Package to PyPI
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  pypi-publish:
+    name: Upload to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: "Install uv"
+        uses: astral-sh/setup-uv@v6
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPi
+        run: uv publish -v dist/*

simple_dep_cache-0.1.1/.github/workflows/static-check.yml

@@ -0,0 +1,25 @@
+name: Static Check
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  static-check:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
+      with:
+        version: "latest"
+
+    - name: Install dependencies
+      run: uv sync --all-extras
+
+    - name: Run static checks
+      run: uv run pre-commit run --all-files
+

simple_dep_cache-0.1.1/.github/workflows/test.yml

@@ -0,0 +1,26 @@
+name: Test
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
+      with:
+        version: "latest"
+
+    - name: Install dependencies
+      run: uv sync --all-extras
+
+    - name: Run tests
+      run: uv run pytest
+

simple_dep_cache-0.1.1/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

simple_dep_cache-0.1.1/.pre-commit-config.yaml

@@ -0,0 +1,8 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.13.0
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+

simple_dep_cache-0.1.1/.python-version

@@ -0,0 +1 @@
+3.11

simple_dep_cache-0.1.1/.ruff.toml

@@ -0,0 +1,63 @@
+# Exclude a variety of commonly ignored directories.
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".ipynb_checkpoints",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pyenv",
+    ".pytest_cache",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    ".vscode",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "site-packages",
+    "venv",
+    "*/migrations/*",
+]
+
+line-length = 100
+indent-width = 4
+
+[lint]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = [
+]
+
+# Per-file ignores for common patterns
+[lint.per-file-ignores]
+"**/tests/**" = [
+    "F841",  # Local variable is assigned to but never used
+]
+
+[format]
+# Like Black, use double quotes for strings.
+quote-style = "double"
+
+# Like Black, indent with spaces, rather than tabs.
+indent-style = "space"
+
+# Like Black, respect magic trailing commas.
+skip-magic-trailing-comma = false
+

simple_dep_cache-0.1.1/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: simple-dep-cache
+Version: 0.1.1
+Summary: Redis-based caching library with intelligent dependency tracking for Python applications
+License: MIT
+Keywords: cache,cache invalidation,dependency,redis
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: redis
+Provides-Extra: fast-json
+Requires-Dist: orjson; extra == 'fast-json'
+Description-Content-Type: text/markdown
+
+# simple-dep-cache
+
+A Redis-based caching library with dependency tracking for Python applications.
+
+## Overview
+
+Cache function results and automatically invalidate related caches when dependencies change. Uses Redis for distributed caching and supports both sync/async functions.
+
+## Installation
+
+```bash
+pip install simple-dep-cache
+```
+
+## Quick Start
+
+### Basic Usage
+
+```python
+from simple_dep_cache import cache_with_deps, add_dependency, CacheManager
+
+# Initialize cache manager (optional - will be created automatically if not provided)
+cache = CacheManager()
+
+@cache_with_deps(cache_manager=cache, ttl=300)
+def get_user_profile(user_id):
+    # This function's result depends on user data
+    add_dependency(f"user:{user_id}")
+
+    # Expensive operation (e.g., database query, API call)
+    return fetch_user_from_database(user_id)
+
+@cache_with_deps(ttl=600)  # No cache_manager - will create one automatically
+def get_user_posts(user_id):
+    # This depends on both user and posts data
+    add_dependency(f"user:{user_id}")
+    add_dependency(f"posts:user:{user_id}")
+
+    return fetch_user_posts_from_database(user_id)
+
+# Use the cached functions
+profile = get_user_profile("123")  # Cache miss - fetches from DB
+profile = get_user_profile("123")  # Cache hit - returns cached result
+
+posts = get_user_posts("123")     # Cache miss - fetches from DB
+posts = get_user_posts("123")     # Cache hit - returns cached result
+
+# When user data changes, invalidate the dependency
+cache.invalidate_dependency("user:123")
+# Now both get_user_profile("123") and get_user_posts("123") are invalidated!
+
+profile = get_user_profile("123")  # Cache miss - will fetch fresh data
+```
+
+### Async Support
+
+```python
+from simple_dep_cache import async_cache_with_deps, add_dependency, AsyncCacheManager
+
+cache = AsyncCacheManager()
+
+@async_cache_with_deps(cache_manager=cache, ttl=300)
+async def get_user_profile_async(user_id):
+    add_dependency(f"user:{user_id}")
+    return await fetch_user_from_database_async(user_id)
+
+# Usage
+profile = await get_user_profile_async("123")  # Cache miss
+profile = await get_user_profile_async("123")  # Cache hit
+
+# Invalidate dependency
+await cache.invalidate_dependency("user:123")
+```
+
+### Monitoring
+
+```python
+from simple_dep_cache import StatsCollector, create_logger_callback
+
+cache = CacheManager()
+stats = StatsCollector()
+cache.events.on_all(stats)
+cache.events.on_all(create_logger_callback("my_cache"))
+
+# Check statistics
+print(stats.get_stats())  # hit_ratio, ops_per_second, etc.
+```
+
+## Configuration
+
+```bash
+REDIS_URL=redis://localhost:6379/0    # Full Redis URL (preferred)
+REDIS_HOST=localhost                  # Or individual settings
+REDIS_PORT=6379
+REDIS_PASSWORD=secret
+DEP_CACHE_ENABLED=true                # Disable caching entirely
+```
+
+## Manual Cache Operations
+
+```python
+cache = CacheManager()
+
+# Direct operations
+cache.set("key", value, ttl=300, dependencies={"dep1"})
+value = cache.get("key")
+cache.delete("key")
+cache.invalidate_dependency("dep1")  # Invalidates all dependent caches
+```
+
+## API Reference
+
+**Decorators:**
+
+- `@cache_with_deps(cache_manager, ttl, key_prefix, dependencies)`
+- `@async_cache_with_deps(cache_manager, ttl, key_prefix, dependencies)`
+
+If `cache_manager` is not provided, one will be created automatically using configured environment variables or defaults.
+
+**Context:**
+
+- `add_dependency(dependency)` - Track dependency in current function
+- `current_cache_key()` - Get current cache key
+
+**Managers:**
+
+- `CacheManager(redis_client, prefix)` - Sync Redis cache manager
+- `AsyncCacheManager(redis_client, prefix)` - Async Redis cache manager
+
+**Monitoring:**
+
+- `StatsCollector()` - Cache statistics
+
+## Requirements
+
+- Python 3.10+
+- Redis server
+- `redis` package
+
+## License
+
+MIT

simple_dep_cache-0.1.1/README.md

@@ -0,0 +1,142 @@
+# simple-dep-cache
+
+A Redis-based caching library with dependency tracking for Python applications.
+
+## Overview
+
+Cache function results and automatically invalidate related caches when dependencies change. Uses Redis for distributed caching and supports both sync/async functions.
+
+## Installation
+
+```bash
+pip install simple-dep-cache
+```
+
+## Quick Start
+
+### Basic Usage
+
+```python
+from simple_dep_cache import cache_with_deps, add_dependency, CacheManager
+
+# Initialize cache manager (optional - will be created automatically if not provided)
+cache = CacheManager()
+
+@cache_with_deps(cache_manager=cache, ttl=300)
+def get_user_profile(user_id):
+    # This function's result depends on user data
+    add_dependency(f"user:{user_id}")
+
+    # Expensive operation (e.g., database query, API call)
+    return fetch_user_from_database(user_id)
+
+@cache_with_deps(ttl=600)  # No cache_manager - will create one automatically
+def get_user_posts(user_id):
+    # This depends on both user and posts data
+    add_dependency(f"user:{user_id}")
+    add_dependency(f"posts:user:{user_id}")
+
+    return fetch_user_posts_from_database(user_id)
+
+# Use the cached functions
+profile = get_user_profile("123")  # Cache miss - fetches from DB
+profile = get_user_profile("123")  # Cache hit - returns cached result
+
+posts = get_user_posts("123")     # Cache miss - fetches from DB
+posts = get_user_posts("123")     # Cache hit - returns cached result
+
+# When user data changes, invalidate the dependency
+cache.invalidate_dependency("user:123")
+# Now both get_user_profile("123") and get_user_posts("123") are invalidated!
+
+profile = get_user_profile("123")  # Cache miss - will fetch fresh data
+```
+
+### Async Support
+
+```python
+from simple_dep_cache import async_cache_with_deps, add_dependency, AsyncCacheManager
+
+cache = AsyncCacheManager()
+
+@async_cache_with_deps(cache_manager=cache, ttl=300)
+async def get_user_profile_async(user_id):
+    add_dependency(f"user:{user_id}")
+    return await fetch_user_from_database_async(user_id)
+
+# Usage
+profile = await get_user_profile_async("123")  # Cache miss
+profile = await get_user_profile_async("123")  # Cache hit
+
+# Invalidate dependency
+await cache.invalidate_dependency("user:123")
+```
+
+### Monitoring
+
+```python
+from simple_dep_cache import StatsCollector, create_logger_callback
+
+cache = CacheManager()
+stats = StatsCollector()
+cache.events.on_all(stats)
+cache.events.on_all(create_logger_callback("my_cache"))
+
+# Check statistics
+print(stats.get_stats())  # hit_ratio, ops_per_second, etc.
+```
+
+## Configuration
+
+```bash
+REDIS_URL=redis://localhost:6379/0    # Full Redis URL (preferred)
+REDIS_HOST=localhost                  # Or individual settings
+REDIS_PORT=6379
+REDIS_PASSWORD=secret
+DEP_CACHE_ENABLED=true                # Disable caching entirely
+```
+
+## Manual Cache Operations
+
+```python
+cache = CacheManager()
+
+# Direct operations
+cache.set("key", value, ttl=300, dependencies={"dep1"})
+value = cache.get("key")
+cache.delete("key")
+cache.invalidate_dependency("dep1")  # Invalidates all dependent caches
+```
+
+## API Reference
+
+**Decorators:**
+
+- `@cache_with_deps(cache_manager, ttl, key_prefix, dependencies)`
+- `@async_cache_with_deps(cache_manager, ttl, key_prefix, dependencies)`
+
+If `cache_manager` is not provided, one will be created automatically using configured environment variables or defaults.
+
+**Context:**
+
+- `add_dependency(dependency)` - Track dependency in current function
+- `current_cache_key()` - Get current cache key
+
+**Managers:**
+
+- `CacheManager(redis_client, prefix)` - Sync Redis cache manager
+- `AsyncCacheManager(redis_client, prefix)` - Async Redis cache manager
+
+**Monitoring:**
+
+- `StatsCollector()` - Cache statistics
+
+## Requirements
+
+- Python 3.10+
+- Redis server
+- `redis` package
+
+## License
+
+MIT

simple_dep_cache-0.1.1/pyproject.toml

@@ -0,0 +1,53 @@
+[project]
+name = "simple-dep-cache"
+# version = "0.1.0"
+dynamic = ["version"]
+description = "Redis-based caching library with intelligent dependency tracking for Python applications"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+keywords = ["cache", "redis", "dependency", "cache invalidation"]
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "redis",
+]
+
+[build-system]
+requires = ["hatchling", "uv-dynamic-versioning"]
+build-backend = "hatchling.build"
+
+[project.optional-dependencies]
+fast-json = [
+   "orjson",
+]
+
+[dependency-groups]
+dev = [
+    "ipython",
+    "pytest",
+    "pytest-asyncio",
+    "fakeredis",
+    "ruff",
+    "pre-commit>=4.3.0",
+]
+
+[tool.hatch.version]
+source = "uv-dynamic-versioning"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = [
+    "tests",
+]
+python_files = [
+    "test_*.py",
+]
+

simple_dep_cache-0.1.1/src/simple_dep_cache/__init__.py

@@ -0,0 +1,19 @@
+from .context import add_dependency, current_cache_key
+from .decorators import async_cache_with_deps, cache_with_deps
+from .events import CacheEvent, CacheEventType, StatsCollector, create_logger_callback
+from .manager import AsyncCacheManager, CacheManager
+from .types import CacheValue
+
+__all__ = [
+    "CacheManager",
+    "AsyncCacheManager",
+    "cache_with_deps",
+    "async_cache_with_deps",
+    "add_dependency",
+    "current_cache_key",
+    "CacheValue",
+    "CacheEvent",
+    "CacheEventType",
+    "StatsCollector",
+    "create_logger_callback",
+]