some renaming

Author: shaypal5

.gitignore

@@ -106,3 +106,5 @@ Pipfile.lock
 .DS_Store
 
 tags
+
+.cursor

README.rst

@@ -51,7 +51,7 @@ Features
 * Local caching using pickle files.
 * Cross-machine caching using MongoDB.
 * Thread-safety.
-* **Per-call freshness threshold:** Specify a maximum age for cached values per call.
+* **Per-call max age:** Specify a maximum age for cached values per call.
 
 Cachier is **NOT**:
 
@@ -234,7 +234,7 @@ Per-function call arguments
 
 Cachier also accepts several keyword arguments in the calls of the function it wraps rather than in the decorator call, allowing you to modify its behaviour for a specific function call.
 
-**Freshness Threshold (max_age)**
+**Max Age (max_age)**
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 You can specify a maximum allowed age for a cached value on a per-call basis using the `max_age` keyword argument. If the cached value is older than this threshold, a recalculation is triggered. This is in addition to the `stale_after` parameter set at the decorator level; the strictest (smallest) threshold is enforced.
 
@@ -247,11 +247,11 @@ You can specify a maximum allowed age for a cached value on a per-call basis usi
   def add(a, b):
       return a + b
 
-  # Use a per-call freshness threshold:
+  # Use a per-call max age:
   result = add(1, 2, max_age=timedelta(seconds=10))  # Only use cache if value is <10s old
 
 **How it works:**
-- The effective freshness threshold is the minimum of `stale_after` (from the decorator) and `max_age` (from the call).
+- The effective max age threshold is the minimum of `stale_after` (from the decorator) and `max_age` (from the call).
 - If the cached value is older than this threshold, a new calculation is triggered and the cache is updated.
 - If not, the cached value is returned as usual.
 

pyproject.toml

@@ -172,6 +172,7 @@ markers = [
   "memory: test the memory core",
   "pickle: test the pickle core",
   "sql: test the SQL core",
+  "maxage: test the max_age functionality",
 ]
 
 # --- coverage ---

src/cachier/core.py

@@ -237,7 +237,7 @@ def _cachier_decorator(func):
         #
         # The effective staleness threshold is the minimum of 'stale_after'
         # and 'max_age' (if provided).
-        # This ensures that the strictest freshness requirement is enforced.
+        # This ensures that the strictest max age requirement is enforced.
         #
         # The main function wrapper is a standard function that passes
         # *args and **kwargs to _call. By default, max_age is None,
@@ -247,7 +247,7 @@ def _cachier_decorator(func):
         #   - Per-call: myfunc(..., max_age=timedelta(...))
         #
         # This design allows both one-off (per-call) and default
-        # (per-decorator) freshness constraints.
+        # (per-decorator) max age constraints.
         # ---
 
         def _call(*args, max_age: Optional[timedelta] = None, **kwds):

…ts/test_call_with_freshness_threshold.py tests/test_call_with_max_age.pytests/test_call_with_freshness_threshold.py renamed to tests/test_call_with_max_age.py tests/test_call_with_freshness_threshold.py renamed to tests/test_call_with_max_age.py

@@ -1,10 +1,12 @@
 import time
 from datetime import timedelta
 
+import pytest
 import cachier
 
 
-def test_call_with_freshness_threshold():
+@pytest.mark.maxage
+def test_call_with_max_age():
     @cachier.cachier()
     def test_func(a, b):
         return a + b
@@ -22,6 +24,7 @@ def test_func(a, b):
     assert val3 == 3
 
 
+@pytest.mark.maxage
 def test_max_age_stricter_than_stale_after():
     import time
 
@@ -40,6 +43,7 @@ def f(x):
     assert v3 != v1  # max_age stricter, triggers recalc
 
 
+@pytest.mark.maxage
 def test_max_age_looser_than_stale_after():
     import time
 
@@ -58,6 +62,7 @@ def f(x):
     assert v3 != v1  # max_age looser, but stale_after still applies (stricter)
 
 
+@pytest.mark.maxage
 def test_max_age_none_defaults_to_stale_after():
     import time
 
@@ -74,6 +79,7 @@ def f(x):
     assert v2 != v1  # Should trigger recalc (stale_after applies)
 
 
+@pytest.mark.maxage
 def test_negative_max_age_triggers_recalc():
     import time
 
@@ -89,6 +95,7 @@ def f(x):
     assert v2 != v1  # Negative max_age always triggers recalc
 
 
+@pytest.mark.maxage
 def test_max_age_zero():
     import time
 
@@ -106,6 +113,7 @@ def f(x):
     assert v2 != v1  # Zero max_age always triggers recalc
 
 
+@pytest.mark.maxage
 def test_max_age_with_next_time():
     import time
 
@@ -121,4 +129,4 @@ def f(x):
     v2 = f(1, max_age=timedelta(seconds=0.5))
     # With next_time=True, should return stale value (v1) while
     # triggering a recalculation in the background
-    assert v2 == v1
+    assert v2 == v1