refactor(cache): rename scoped_mode to mode_context

- Updated context manager name from `scoped_mode` to `mode_context` for clarity
- Updated related documentation in README and CHANGELOG
- Renamed function calls and references to use new `mode_context` name

Author: tanbro

CHANGELOG.md

@@ -7,8 +7,8 @@
 - ✨ **New Features:**
   - Added arguments excluding support for the `RedisFuncCache` class, which makes it possible to cache functions with arguments that cannot be serialized.
   - Added support for controlling cache TTL update behavior with `update_ttl` parameter.
-  - Enhanced cache mode control with bit-flag based `Mode` enum and new context managers:
-    - `mask_mode()` for applying mode masks using bitwise AND operations
+  - Enhanced cache mode control with context managers:
+    - `mode_context()` for applying mode contextually
     - `disable_rw()` as an alias for completely disabling cache read and write operations
     - `read_only()` for read-only cache mode
     - `write_only()` for write-only cache mode

README.md

@@ -179,7 +179,7 @@ The library guarantees thread safety and concurrency security through the follow
 
 1. Contextual State Isolation
 
-   The [ContextVar](https://docs.python.org/3/library/contextvars.html#contextvars.ContextVar) based `scoped_mode()` context manager and other cache control context managers ensure thread and coroutine isolation. Each thread or async task maintains its own independent state, preventing cross-context interference.
+   The [ContextVar](https://docs.python.org/3/library/contextvars.html#contextvars.ContextVar) based `mode_context()` context manager and other cache control context managers ensure thread and coroutine isolation. Each thread or async task maintains its own independent state, preventing cross-context interference.
 
 Atomicity is a key feature of this library. All cache operations (both read and write) are implemented using Redis Lua scripts, which are executed atomically by the Redis server. This means that each script runs in its entirety without being interrupted by other operations, ensuring data consistency even under high concurrent load.
 
@@ -592,13 +592,13 @@ The `update_ttl` parameter controls the behavior of the cache data structures (s
 
 ### Cache Mode Control
 
-The library provides fine-grained control over cache behavior through the `scoped_mode()` context manager and convenience methods. You can control whether the cache reads from or writes to Redis using the following flags:
+The library provides fine-grained control over cache behavior through the `mode_context()` context manager and convenience methods. You can control whether the cache reads from or writes to Redis using the following flags:
 
 - `read` (`bool`): allow read from cache
 - `write` (`bool`): allow write to cache
 - `exec` (`bool`): allow execute function
 
-You can use the `scoped_mode()` context manager to explicitly set any mode:
+You can use the `mode_context()` context manager to explicitly set any mode:
 
 ```python
 from redis_func_cache import RedisFuncCache
@@ -614,20 +614,20 @@ data = get_user_data(123)
 # Bypass cache reading, but still write to cache
 mode = cache.get_mode()
 mode.read = False
-with cache.scoped_mode(mode):
+with cache.mode_context(mode):
     data = get_user_data(123)  # Function executed, result stored in cache
 
 # Only read from cache, don't execute function or write to cache
 mode = cache.get_mode()
 mode.write = False
-with cache.scoped_mode(mode):
+with cache.mode_context(mode):
     data = get_user_data(123)  # Only attempts to read from cache
 
 # Disable cache read and write
 mode = cache.get_mode()
 mode.read = False
 mode.write = False
-with cache.scoped_mode(mode):
+with cache.mode_context(mode):
     data = get_user_data(123)  # Function executed, no cache interaction
 ```
 

src/redis_func_cache/cache.py

@@ -870,7 +870,7 @@ def reset_mode(self, token: Token[RedisFuncCache.Mode]):
         self._mode.reset(token)
 
     @contextmanager
-    def scoped_mode(self, mode: RedisFuncCache.Mode) -> Generator[None, None, None]:
+    def mode_context(self, mode: RedisFuncCache.Mode) -> Generator[None, None, None]:
         """A context manager to control cache behavior.
 
         This context manager allows you to temporarily change cache mode flags.
@@ -881,7 +881,6 @@ def scoped_mode(self, mode: RedisFuncCache.Mode) -> Generator[None, None, None]:
         Args:
             mode: The cache mode to use within the context. Can be a combination of Mode bitwise flags.
 
-
         Example:
 
             ::
@@ -924,7 +923,7 @@ def func(): ...
         .. versionadded:: 0.5
         """
         mode = replace(self._mode.get(), read=False, write=False)
-        with self.scoped_mode(mode):
+        with self.mode_context(mode):
             yield
 
     @contextmanager
@@ -949,7 +948,7 @@ def func(): ...
         .. versionadded:: 0.5
         """
         mode = replace(self._mode.get(), read=True, write=False)
-        with self.scoped_mode(mode):
+        with self.mode_context(mode):
             yield
 
     @contextmanager
@@ -970,5 +969,5 @@ def func(): ...
         .. versionadded:: 0.5
         """
         mode = replace(self._mode.get(), read=False, write=True)
-        with self.scoped_mode(mode):
+        with self.mode_context(mode):
             yield